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/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 中编辑您项目的设计方案，并添加环境变量 EODebug并将其值设置为 1；同时添加环境变量 TLF_DEBUG 并将其值设置为 1。这将使 SDK 开始将调试日志写入您的 XCode 控制台窗口。如果您想报告问题，Tealeaf 支持工程师将要求您提供这些日志。

许可证

许可证文件可以在这里读取。