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 支持了 3 种不同的哈希算法：SHA256、SHA512 和 MD5，默认为 SHA256。如果您想使用 SHA256，不需要额外的集成步骤。之前 Tealeaf 只支持 MD5，也是默认算法。由于 Apple 正在弃用 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默认算法。

有关更多关于哈希库的信息，请参阅此处

将应用程序图片上传到Tealeaf服务器

无论您选择哪种哈希算法，我们都建议您重新打包应用程序图片并将它们上传到Tealeaf服务器。详细信息请见此处

故障排除

如果您正在使用IBM Tealeaf SDK的调试版本，即pod 'IBMTealeafDebug'，那么您可以在XCode中编辑您项目的scheme并添加环境变量EODebug并将其值设置为1；还添加环境变量TLF_DEBUG并设置其值为1。这将使SDK开始将调试日志写入您的xcode控制台窗口。如果需要报告问题，Tealeaf支持工程师将要求您提供这些日志。

许可协议

许可文件可在此处阅读