ios_sdk疑难问题解决：从安装到跟踪的常见错误与解决方案

ios_sdk疑难问题解决：从安装到跟踪的常见错误与解决方案

【免费下载链接】ios_sdkThis is the iOS SDK of项目地址: https://gitcode.com/gh_mirrors/io/ios_sdk

iOS SDK在移动应用开发中扮演着关键角色，但开发者在使用过程中常遇到各种问题。本文将围绕ios_sdk的安装配置、事件跟踪、归因分析等核心环节，提供实用的错误解决方案，帮助开发者快速定位并解决问题。

一、安装配置阶段的常见错误与解决方案

1.1 "Missing signature library"初始化失败

错误表现：在控制台中出现[self.logger error:@"Missing signature library, SDK can't be initialised"]错误提示。

解决方案：

• 检查项目中是否正确集成了签名库文件。签名库通常位于AdjustSignature/AdjustSigSdk.xcframework目录下。
• 确保在Xcode项目设置中，签名库被正确添加到"Frameworks, Libraries, and Embedded Content"中，并设置为"Embed & Sign"。

1.2 "Adjust already initialized"重复初始化错误

错误表现：应用启动时出现[self.logger error:@"Adjust already initialized"]错误。

解决方案：

• 检查应用委托类（如AppDelegate.m）中是否多次调用了[Adjust initSdk:config]方法。
• 确保初始化代码只在应用启动时执行一次，建议将初始化逻辑放在application:didFinishLaunchingWithOptions:方法中。

图1：iOS SDK初始化流程示意图

二、事件跟踪中的常见问题

2.1 "Missing Event Token"事件跟踪失败

错误表现：调用事件跟踪API时出现[self.logger error:@"Missing Event Token"]错误。

解决方案：

• 检查ADJEvent对象创建时是否正确设置了事件令牌（Event Token）。
• 确保事件令牌与Adjust后台配置的令牌一致。示例代码：

  ADJEvent *event = [ADJEvent eventWithEventToken:@"YOUR_EVENT_TOKEN"];

2.2 revenue和currency参数错误

错误表现：出现[self.logger error:@"Currency must be set with revenue"]或[self.logger error:@"Revenue must be set with currency"]错误。

解决方案：

• 确保在设置事件收入（revenue）时，同时设置了货币代码（currency）。
• 货币代码应遵循ISO 4217标准，例如"USD"、"EUR"等。示例代码：

  [event setRevenue:19.99 currency:@"USD"];

三、归因分析相关问题

3.1 SKAdNetwork调用失败

错误表现：控制台出现[self.logger error:@"Call to SKAdNetwork's registerAppForAdNetworkAttribution method failed. Error: %@", error.localizedDescription]错误。

解决方案：

• 确保项目中正确配置了SKAdNetwork标识符。在Info.plist文件中添加SKAdNetworkItems键。
• 检查Xcode项目设置中是否启用了"Ad Network Attribution"功能。
• 确保使用的iOS版本支持SKAdNetwork（iOS 14及以上）。

3.2 归因数据获取失败

错误表现：调用归因数据获取API时出现[self.logger error:@"Completion block for getting attribution can't be null"]错误。

解决方案：

• 确保在调用归因数据获取方法时提供了有效的回调 block。示例代码：

  [Adjust getAttributionWithCompletionHandler:^(ADJAttribution *attribution) { // 处理归因数据 } timeout:5.0];

图2：iOS SDK归因流程示意图

四、配置文件相关问题

4.1 "Missing App Token"或"Malformed App Token"

错误表现：初始化时出现[self.logger error:@"Missing App Token"]或[self.logger error:@"Malformed App Token '%@'", appToken]错误。

解决方案：

• 检查ADJConfig对象是否正确设置了应用令牌（App Token）。
• 确保应用令牌与Adjust后台提供的令牌一致，格式正确。示例代码：

  ADJConfig *config = [ADJConfig configWithAppToken:@"YOUR_APP_TOKEN" environment:ADJEnvironmentSandbox];

4.2 "Missing environment"环境配置错误

错误表现：出现[self.logger error:@"Missing environment"]或[self.logger error:@"Unknown environment '%@'", environment]错误。

解决方案：

• 确保在创建ADJConfig对象时正确设置了环境参数。
• 环境参数只能是ADJEnvironmentSandbox（测试环境）或ADJEnvironmentProduction（生产环境）。

五、高级问题解决

5.1 深层链接（Deeplink）处理问题

错误表现：出现[ADJAdjustFactory.logger error:@"Unable to open deep link (%@)", deepLinkUrl]错误。

解决方案：

• 检查ADJConfig对象是否设置了deeplinkDelegate。
• 确保应用正确处理了application:openURL:options:方法，并调用了[Adjust appWillOpenUrl:url]。
• 检查深层链接的格式是否正确，是否包含必要的参数。

5.2 第三方分享设置错误

错误表现：出现[ADJAdjustFactory.logger error:@"Cannot add granular option with any nil value"]错误。

解决方案：

• 在使用ADJThirdPartySharing类时，确保所有参数都不为nil。
• 正确设置第三方分享选项，示例代码：

  ADJThirdPartySharing *thirdPartySharing = [ADJThirdPartySharing thirdPartySharing]; [thirdPartySharing addGranularOption:@"PartnerA" key:@"key" value:@"value"]; [Adjust setThirdPartySharing:thirdPartySharing];

六、调试与日志

6.1 启用详细日志

为了更好地排查问题，建议在开发阶段启用详细日志：

config.logLevel = ADJLogLevelVerbose;

6.2 查看SDK版本

如果遇到兼容性问题，可以通过以下方法获取当前SDK版本：

[Adjust getSdkVersionWithCompletionHandler:^(NSString *sdkVersion) { NSLog(@"Adjust SDK version: %@", sdkVersion); }];

图3：iOS SDK调试界面示例

通过以上解决方案，大部分ios_sdk的常见问题都能得到有效解决。如果遇到更复杂的问题，建议查阅官方文档或联系技术支持。记住，仔细检查错误日志和配置参数是解决问题的关键。

【免费下载链接】ios_sdkThis is the iOS SDK of项目地址: https://gitcode.com/gh_mirrors/io/ios_sdk