IBMTealeaf
IBM Tealeaf 是一个客户行为分析 SDK,如以下所述
入门
先决条件
你需要在你的 Mac OS 上安装最新的 cocoapods 版本。请参考 cocoapods 网站。
有关 SDK 先决条件和文档,请参阅 SDK 文档此处
安装
请在 Podfile 的开头添加以下行
设置平台为 iOS 9
platform :ios, '9.0'
取消注释 use_frameworks
use_frameworks!
在 Podfile 中的相应项目目标中,如果您想使用 IBM Tealeaf SDK 的发布版本,该版本需要在您的应用程序生产版本中使用,请添加以下行。
pod 'IBMTealeaf'
在 Podfile 中的相应项目目标中,如果您想使用具有版本号的 IBM Tealeaf SDK 的发布版本,请添加以下行。否则,您将获得可能包含新功能或修正但尚未完全测试或批准的测试版。
pod 'IBMTealeafDebug'
请记住,您只能使用 pod 'IBMTealeaf'
和 pod 'IBMTealeafDebug'
中的一个。请不要同时使用两者。
选择合适的哈希库
从 Tealeaf 版本 10.6.20 开始,SDK 支持三种不同的哈希算法:SHA256、SHA512 和 MD5;默认为 SHA256。如果您想使用 SHA256,则不需要额外的集成步骤。之前 Tealeaf 只支持 MD5 并作为默认算法。苹果正在弃用 MD5 API,因此我们将转向 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默认算法。
您可以在此了解有关哈希库的更多信息这里
将应用程序图像上传到Tealeaf服务器
无论您选择哪种哈希算法,我们建议您重新打包应用程序图像并将其上传到Tealeaf服务器。详细信息请参见这里
故障排除
如果您正在使用IBM Tealeaf SDK的调试版本。即 pod 'IBMTealeafDebug'
,那么您可以在XCode中编辑您项目的scheme并添加环境变量EODebug
并将其值设置为1;同时添加环境变量TLF_DEBUG
并将其值设置为1。这将使SDK开始将调试日志写入您的xcode控制台窗口。如果您需要报告问题,Tealeaf支持工程师将要求您提供这些日志。
许可
许可文件可在此处查看这里