SDK 基本信息
SDK名称:热力引擎 MacOS SDK v1.3.0.0
开发者名称:汇量云(北京)科技有限公司
SDK版本号:1.3.0.0
支持Xcode版本:14.0或更高
主要功能:热力引擎是一站式增长分析与发行决策平台,致力于帮助开发者搭建便捷、高效的数据管理中台,洞察业务运营全链路数据,制定更优增长决策。热力引擎支持全球全渠道数据管理,帮助开发者实现归因分析、用户粒度 ROI 分析,能有效衡量渠道价值,为投放和变现策略调优提供全方位数据支持。同时,提供应用内埋点及参数管理,配合多种分析模型与 AB 测试功能,全面还原用户全生命周期旅程,挖掘用户需求及业务增长点,快速验证并推行产品迭代优化,为开发者提升业务运营效率,实现规模化增长赋能。
适用范围:适用于 MacOS 11.0 及以上的操作系统。
隐私政策链接: https://www.solar-engine.com/privacyPolicy.html
合规指南:详见本页面底部合规指南内容。
第一步:获取 Appkey
Appkey 查询路径:资产管理-应用管理-16位 Appkey(即应用 ID)。

第二步:获取 SDK
如果您创建的产品数据存储区域是中国大陆,请下载
https://solar-sdk.oss-cn-beijing.aliyuncs.com/iOS/SolarEngine-iOSSDK-CN-v1.3.0.0.zip
如果您创建的产品数据存储区域是非中国大陆,请下载
https://solar-sdk.oss-cn-beijing.aliyuncs.com/iOS/SolarEngine-iOSSDK-US-v1.3.0.0.zip
第三步:SDK 集成
手动集成:添加 SDK 所需依赖框架
使用 libsqlite3.tbd 用来存储数据
添加方法:
在工程目录中,选择 TARGETS-->Build Phases-->Link Binary With Libraries-->+ -->选择 libsqlite3.tbd 等库文件。
如上动态库请全部配置,避免报错。
添加-ObjC参数
在工程的 TARGETS -> Build Settings -> Linking -> Other Linker Flags 中添加 -ObjC
第四步:预初始化 SDK
在应用安装后首次冷启动时,需要先预初始化 SDK,预初始化时 SDK 不采集任何个人信息也不会向热力引擎上报数据,
请请确保用户同意《隐私政策》并且 SDK 预初始化成功后,再调用初始化函数正式初始化 SDK
- (void)preInitWithAppKey:(nonnull NSString *)appKey;
参数说明:
参数 | 类型 | 是否必填 | 说明 |
appKey | NSString | 是 | 获取的 appKey |
预初始化调用示例:
// 导入头文件
#import
[[SolarEngineSDK sharedInstance] preInitWithAppKey:your_appKey];
第五步:初始化配置(可选)
此方法返回的 config 配置作为初始化方法的一个可选参数,如未设置则为默认值
初始化配置说明:
属性 | 类型 | 是否必填 | 说明 |
logEnabled | BOOL | 否 | 是否开启本地调试日志(不设置时默认不开启) |
isDebugModel | BOOL | 否 | 是否开启 Debug 模式,YES 表示开启 Debug 模式,开启后能在后台实时查看数据校验结果,Debug模式数据不入库,不要把Debug模式发布到线上。(不设置时默认不开启 Debug 模式) |
第六步:初始化 SDK
在正式初始化前,您应确保用户同意《隐私政策》并且 SDK 预初始化成功,再调用正式初始化函数初始化热力引擎 SDK
- (void)startWithAppKey:(nonnull NSString *)appKey config:(SEConfig *)config;
参数说明:
参数 | 类型 | 是否必填 | 说明 |
appKey | NSString | 是 | 获取的 appKey |
config | SEConfig | 否 | 初始化配置,如果为空则为默认值 |
正式初始化调用示例:
SEConfig *config = [[SEConfig alloc] init];
config.logEnabled = YES; //开启本地调试日志
[[SolarEngineSDK sharedInstance] startWithAppKey:your_appKey config:config];
监听初始化回调
code | 说明 |
---|---|
0 | 初始化成功 |
101 | 初始化失败,没调用预初始化 |
102 | 初始化失败,appkey不符合规范 |
[[SolarEngineSDK sharedInstance] setInitCompletedCallback:^(int code) {
if (code == 0) {
// 初始化成功
NSLog(@"InitCompletedCallback success");
} else {
// 初始化失败
NSLog(@"InitCompletedCallback code = %d",code);
}
}];