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 支持三种不同的哈希算法。SHA256、SHA512 和 MD5;默认为 SHA256。如果您想使用 SHA256,则不需要任何额外的集成步骤。之前 Tealeaf 只支持 MD5,且 MD5 是默认算法。Apple 正在弃用 MD5 APIs,因此我们转向 SHA2。
使用 SHA256
不需要任何额外的集成步骤。IBMTealeaf 和 IBMTealeafDebug默认使用 SHA256。
使用 SHA512
在您的 Podfile 中,请使用 pod 'IBMTealeaf/SHA512'
或 pod 'IBMTealeafDebug/SHA512'
代替 pod 'IBMTealeaf'
或 pod 'IBMTealeafDebug'
。
使用 MD5
在您的 Podfile 中,请使用 pod 'IBMTealeaf/MD5'
或 pod 'IBMTealeafDebug/MD5'
代替 pod 'IBMTealeaf'
或 pod 'IBMTealeafDebug'
。
重要提示
请在您的应用目标的“其他链接器设置”中使用 $(inherited) 标志,这将确保所有 pods 都能够正确链接。
当您的应用程序启动时,MD5 和 SHA512 哈希库会在控制台日志中打印它们的版本。忘记设置 $(inherited) 标志可能是原因之一。如果 MD5 或 SHA512 没有正确链接,Tealeaf 将使用内置的 SHA256 默认算法。
您可以在此处了解更多有关哈希库的信息。
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
您会注意到,默认情况下,示例应用程序使用 Debug
版本的库。
注意,您只能使用 Release
或 Debug
中的一个。不要同时使用两个。
现在您需要通过运行以下命令来安装 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 中编辑您项目的 scheme,并添加环境变量 DIGITAL_ANALYTICS_DEBUG
并将其值设置为 1;还添加环境变量 EODebug
并将其值设置为 1。这将使 SDK 开始将调试日志写入您的 xcode 控制台窗口。如果您要报告问题,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!以纠正问题。
许可证
许可证文件可以在此处阅读。