跳转至

动态配置与动态更新地址

远程配置

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() 主动上传。

文档评价

文档内容是否对您有帮助?