Acoustic DigitalAnalytics
Acoustic DigitalAnalytics 是一个按照这里的文档记录的数字分析 SDK
使用 Cocoapods 入门
先决条件
您需要在其 Mac OS 上安装最新的 CocoaPods 版本。请参阅 CocoaPods 网站,获取详细信息。
有关 SDK 的先决条件和文档,请参阅 SDK 文档这里
安装
在 Podfile 的开头添加以下行:
将平台设置为 iOS 9
platform :ios, '9.0'
取消注释 use_frameworks
use_frameworks!
在 Podfile 中为您的项目目标添加以下行,如果希望使用 Acoustic DigitalAnalytics SDK 的发布版本:
pod 'DigitalAnalytics'
在 Podfile 中为您的项目目标添加以下行,如果希望使用 Acoustic DigitalAnalytics SDK 的发布版本:
pod 'DigitalAnalyticsDebug'
请记住,您只能使用 pod 'DigitalAnalytics'
和 pod 'DigitalAnalyticsDebug'
中的一项。不要同时使用它们。
选择合适的哈希库
从Tealeaf版本10.6.20开始,SDK支持3种不同的哈希算法。SHA256、SHA512和MD5,默认为SHA256。如果您想使用SHA256,无需额外集成步骤。之前Tealeaf只支持MD5,并默认作为算法。苹果正在弃用MD5 API,因此我们转向SHA2。
使用SHA256
无需额外集成步骤。IBMTealeaf和IBMTealeafDebug默认使用SHA256。
使用SHA512
在您的Podfile中不要使用pod 'IBMTealeaf'
或pod 'IBMTealeafDebug'
,请使用pod 'IBMTealeaf/SHA512'
或pod 'IBMTealeafDebug/SHA512'
。
使用MD5
在您的Podfile中不要使用pod 'IBMTealeaf'
或pod 'IBMTealeafDebug'
,请使用pod 'IBMTealeaf/MD5'
或pod 'IBMTealeafDebug/MD5'
。
重要提示
请务必在使用应用程序目标“其他链接设置”中使用$(inherited)标志。这将确保所有pod都正确链接。
当应用程序启动时,MD5和SHA512哈希库会在控制台日志中打印它们的版本。忘记设置$(inherited)标志可能是其中一个原因。如果MD5或SHA512没有正确链接,Tealeaf将使用内置的SHA256默认算法。
您可以在此处了解更多关于哈希库的信息here
Carthage入门
使用您选择的文本编辑器打开Cartfile,并注意以下行:
在Podfile中为您项目的相应目标添加以下行,如果您想使用Tealeaf SDK的发布版本:
binary "https://raw.githubusercontent.com/acoustic-analytics/IBMTealeaf/master/Tealeaf.json" >= 10.6.36
binary "https://raw.githubusercontent.com/acoustic-analytics/EOCore/master/EOCore.json" >= 2.3.24
在Podfile中为您项目的相应目标添加以下行,如果您想使用Tealeaf SDK的调试版本:
binary "https://raw.githubusercontent.com/acoustic-analytics/IBMTealeaf/master/TealeafDebug.json" >= 10.6.36
binary "https://raw.githubusercontent.com/acoustic-analytics/EOCore/master/EOCoreDebug.json" >= 2.3.24
您会注意到默认情况下,示例应用程序使用库的调试
版本。
请注意,您只能使用发布
或调试
之一。不要同时使用两个。
现在您需要运行以下命令来安装carthage。
carthage update --platform iOS
上面的carthage命令应该无错误完成。
Swift Package入门
请访问:
- 发布库:https://github.com/acoustic-analytics/DigitalAnalytics-SP
- 调试库:https://github.com/acoustic-analytics/DigitalAnalyticsDebug-SP
故障排除
如果您正在使用Acoustic DigitalAnalytics SDK的调试版本。即pod 'DigitalAnalyticsDebug'
,那么您可以在XCode中编辑您项目的情况,并添加环境变量DIGITAL_ANALYTICS_DEBUG
并将其值设置为1;同时添加环境变量EODebug
并将其值设置为1。这将使SDK开始将调试日志写入xcode控制台窗口。如果您报告问题,Acoustic DigitalAnalytics支持工程师会要求您提供这些日志。
如果您在CocoaPods使用中遇到问题:
dyld: 加载库失败:@rpath/EOCore.framework/EOCore 来自:/Users/h26259/Library/Developer/CoreSimulator/Devices/57B11359-B896-495E-B802-A8377313F848/data/Containers/Bundle/Application/9CE5AF4D-CD63-49F8-8288-677EC7BD81DA/myCigna.app/myCigna 原因:找不到图像 dyld:启动,加载依赖库
在Podfile中,将use_frameworks!更改为use_modular_headers!以纠正问题。
许可证
许可证文件可在此处阅读 这里