콘텐츠로 이동

동적 설정 및 동적 업데이트 주소

원격 설정

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()를 호출하여 직접 업로드해야 합니다.

문서 평가

이 페이지가 도움이 되었나요?