Flutter 에이전트 FAQ
Q. 디버깅용 로그 메시지를 확인하고 싶어요.
A. NetFUNNEL Flutter 에이전트에서 발생하는 로그 메시지를 확인하는 방법은 다음과 같습니다:
-
초기화 함수의
printLog=true설정 -
Flutter 콘솔에서
[NF4]prefix를 가진 로그 확인
정보
앱 배포 시 printLog=false 사용을 권장합니다.
Q. 환경별 설정을 다르게 하고 싶어요.
A. Netfunnel.instance.initialize()의 profile 파라미터를 사용하여 환경별 설정을 적용할 수 있습니다.
// 프로덕션 환경 (도쿄)
await Netfunnel.instance.initialize(profile: 'prod_tokyo', ...);
// 프로덕션 환경 (미동부)
await Netfunnel.instance.initialize(profile: 'prod_us_east', ...);
Q. HTTP 통신 시 오류가 발생해요.
A. NetFUNNEL Flutter 에이전트는 기본적으로 HTTPS 통신을 권장합니다. HTTP 통신을 사용할 경우, 플랫폼에 따른 설정을 통해 HTTP 통신을 허용할 수 있습니다.
Android
android/app/src/main/res/xml/network_security_config.xml파일 생성
<?xml version="1.0" encoding="utf-8"?>
<network-security-config>
<domain-config cleartextTrafficPermitted="true">
<domain includeSubdomains="true">{{DOMAIN_URL}}</domain>
</domain-config>
</network-security-config>
android/app/src/main/AndroidManifest.xml설정 추가
<application
android:networkSecurityConfig="@xml/network_security_config"
... >
</application>
iOS
ios/Runner/Info.plist설정 추가
<key>NSAppTransportSecurity</key>
<dict>
<key>NSAllowsArbitraryLoads</key>
<true/>
</dict>
Q. 에이전트 버전을 확인하고 싶어요
A. 에이전트의 버전을 확인하기 위해 getVersion() 함수를 사용할 수 있습니다.
| 함수명 | 파라미터 | 반환값 | 설명 |
|---|---|---|---|
| getVersion | N/A | String | NetFUNNEL 에이전트의 버전을 반환(확인)하는 함수 |