동적 설정 및 동적 업데이트 주소¶
원격 설정¶
SDK 0.5.7부터 지원합니다.
원격 설정을 통해 플랫폼에서 내려주는 환경 변수를 가져와 샘플링, 로그 필터링 및 데이터 업로드 등의 설정을 조정합니다.
사전 조건¶
FTMobileFlutter.sdkConfig()에서 enableRemoteConfiguration: true를 설정하고 유효한 데이터 전송 주소를 설정한 다음, FTRUMManager().setConfig()를 통해 현재 플랫폼의 RUM App ID를 설정합니다. 전체 연동 방법은 SDK 초기화 및 RUM 설정을 참고하세요. 로그, 트레이스 및 Session Replay는 각각 별도로 초기화해야 합니다.
적용 범위¶
필드 이름은 네이티브 SDK를 그대로 따르며, 지원되는 필드, 단위 및 적용 방식은 Flutter 원격 설정 필드를 참고하세요. 샘플링, 로그 필터링 및 업로드 등 공통 설정은 Flutter 데이터에 영향을 줍니다. 네이티브 View, Action, Resource 및 버벅임 등의 스위치는 네이티브 수집만 제어하며 Flutter 자동 라우팅, Dart 네트워크 수집 또는 Dart LongTask 설정을 변경하지 않습니다.
업데이트 방식¶
| 업데이트 방식 | 최소 업데이트 간격 | 결과 확인 |
|---|---|---|
| SDK 자동 업데이트 트리거 | remoteConfigMiniUpdateInterval, 단위: 초, 기본값: 12시간 |
FTMobileFlutter.addRemoteConfigListener() |
FTMobileFlutter.updateRemoteConfig() |
초기화 시 설정한 간격 사용 | 반환된 Future<FTRemoteConfigResult> |
FTMobileFlutter.updateRemoteConfigWithMiniUpdateInterval(interval) |
이번에 전달된 interval 사용, 단위: 초, 값은 음수가 아닌 정수, 0이면 간격 확인 건너뜀 |
반환된 Future<FTRemoteConfigResult> |
최소 업데이트 간격은 요청 빈도를 제한하기 위한 것이며, SDK가 12시간마다 정기적으로 새로 고침한다는 의미는 아닙니다. 직접 업데이트는 비동기 작업이며, 0을 전달하더라도 위의 초기화 조건을 충족해야 합니다.
// 초기화 시 설정한 최소 업데이트 간격 사용
final result = await FTMobileFlutter.updateRemoteConfig();
debugPrint('远程配置更新结果:${result.success}');
// 비즈니스 요구로 즉시 업데이트해야 하는 경우 최소 간격 확인 건너뛰기
final immediateResult =
await FTMobileFlutter.updateRemoteConfigWithMiniUpdateInterval(0);
debugPrint('主动更新结果:${immediateResult.success}');
업데이트 결과 수신¶
FTMobileFlutter.addRemoteConfigListener()를 통해 자동 업데이트 결과를 수신합니다. 직접 호출한 결과는 반환된 Future를 통해 확인하며, 이 리스너로는 알림이 전달되지 않습니다.
// 비즈니스 사용자 정의 콜백, 함수 이름은 임의로 지정 가능
void onRemoteConfigUpdated(FTRemoteConfigResult result) {
debugPrint('自动更新结果:${result.success}');
}
FTMobileFlutter.addRemoteConfigListener(onRemoteConfigUpdated);
더 이상 수신하지 않으려면 FTMobileFlutter.removeRemoteConfigListener(onRemoteConfigUpdated)를 호출합니다.
데이터 전송 주소 동적 업데이트¶
FTMobileFlutter를 사용하여 SDK 런타임에 데이터 전송 주소를 전환할 수 있으며, 설정에 성공하면 이후 데이터는 새 주소로 업로드됩니다.
setDatakitURL과 setDatawayURL 중 하나를 선택합니다. setDatawayURL을 사용할 때는 cliToken도 함께 전달해야 합니다.
await FTMobileFlutter.setDatakitURL(datakitUrl);
// 퍼블릭 DataWay와 위 방식 중 하나를 선택합니다
// await FTMobileFlutter.setDatawayURL(datawayUrl, cliToken);
데이터 전송 주소 지연 설정¶
SDK 0.5.8부터 지원합니다.
초기화 시 FTMobileFlutter.sdkConfig()에 datakitUrl, datawayUrl, cliToken을 전달하지 않아도 됩니다. SDK는 먼저 데이터를 수집하고 캐시하며, 당분간 업로드하지 않습니다. 주소를 가져온 후 위 메서드를 호출하여 주소를 설정하면 동기화 설정에 따라 업로드됩니다.
데이터는 여전히 로컬 캐시 설정의 제한을 받으며, 최대 한도에 도달하면 삭제될 수 있습니다. autoSync: false를 설정한 경우 FTMobileFlutter.flushSyncData()를 호출하여 직접 업로드해야 합니다.