进阶指南

最近更新 2026/09/03

1. 初始化参数

初始化传入的 TDSettings 配置详细解释如下：

1.1 TDSettings

属性名	类型	说明
appId	NSString	在 AE 后台创建的项目的 app id
serverUrl	NSString	在 AE 后台创建的项目的 server url
mode	TDSDKMode	SDK 运行模式的枚举
enableLog	BOOL	是否开启日志打印
rccFetchParams	NSDictionary	（TDRemoteConfig 使用）拉取配置时的自定义请求参数
encryptVersion	NSInteger	（ThinkingSDK 使用）当开启数据加密时，密钥版本号
encryptKey	NSString	（ThinkingSDK 使用）当开启数据加密时，公钥信息
defaultTimeZone	NSTimeZone	（ThinkingSDK 使用）SDK 格式化时间所用到的时区
instanceName	NSString	（ThinkingSDK 使用）给采集 SDK 实例设置别名
enableAutoPush	BOOL	（ThinkingSDK 使用）是否开启推送点击自动回收
enableAutoCalibrated	BOOL	（ThinkingSDK 使用）是否开启自动时间校准

1.2 TDSDKMode

枚举值	说明
TDSDKModeNomal	正常上报数据，并入库。
TDSDKModeDebug	以 Debug 模式上报采集数据。 设备 id 需添加到 AE 控制台的测试设备列表。 在 AE 控制台 -> Debug 模式菜单项可以看到实时采集到的数据。 上报数据会存储到 AE 系统。
TDSDKModeDebugOnly	以 DebugOnly 模式上报采集数据。 设备 id 需添加到 AE 控制台的测试设备列表。 在 AE 控制台 -> Debug 模式菜单项可以看到实时采集到的数据。 上报数据不会存储到 AE 系统。

2. 自定义拉取时机

2.1 自动拉取

在以下场景，SDK 会自动拉取远端配置数据

• App 冷启动
• App 前后台切换，两次间隔超过6小时
• ThinkingSDK 账号系统发生了变更，例如 login、logout

2.2 手动拉取

手动调用 SDK 方法，随时拉取远端配置

[TDRemoteConfig fetch];

该 API 内部有频控限制，避免频繁拉取。

3. 自定义Fetch参数

Fetch 参数为客户端SDK请求AE服务端取值时可用的参数，您可自定义Fetch参数，将参数添加为配置通道的环境参数， 在配置策略时，使用Fetch参数自定义目标环境。

3.1 添加

[TDRemoteConfig setCustomFetchParams:@{}];

3.2 删除

根据指定的 key 进行删除

[TDRemoteConfig removeCustomFetchParam:@"key"];