TealeafDebug 10.6.288

TealeafDebug 10.6.288

×

由以下人员维护：Omar Hernandez，Chang Jie Yang，Bender Rodriguez-sdk。

TealeafDebug 10.6.288

  • 由
  • Acoustic, L.P.

Tealeaf

Tealeaf 是一个客户行为分析 SDK，具体请参阅以下文档 此处

使用 Cocoapods 入门

先决条件

您需要在您的 Mac OS 上安装最新的 cocoapods 版本，请参阅 cocoapods 网站获取详细信息。

有关 SDK 的先决条件和文档，请参阅 SDK 文档 此处

安装

请在 Podfile 的开始处添加以下行：

将平台设置为 iOS 12：

platform :ios, '12.0'

取消注释 use_frameworks：

use_frameworks!

如果您想在 Podfile 中为您的项目各目标使用 Tealeaf SDK 的正式版本（需要在应用的生产版本中使用），请添加以下行：

pod 'Tealeaf'

如果您想在 Podfile 中为您的项目各目标添加带有版本号的 Tealeaf SDK 的正式版本，否则您将获得可能包含新功能或修复但未经充分测试或批准的测试版：

pod 'TealeafDebug'

请记住，您只能使用其中一个：`pod 'Tealeaf'` 或 `pod 'TealeafDebug'`。请不要同时使用两者。

选择合适的哈希库。

从 Tealeaf 版本 10.6.20 开始，SDK 支持三种不同的哈希算法：SHA256、SHA512 和 MD5，默认为 SHA256。如果您想使用 SHA256，则不需要额外的集成步骤。之前 Tealeaf 仅支持 MD5，并且是默认算法。由于 Apple 正在弃用 MD5 API，因此我们转向 SHA2。

使用 SHA256

不需要额外的集成步骤。Tealeaf 和 TealeafDebug 默认使用 SHA256。

使用 SHA512

在您的 Podfile 中，请不要使用 pod 'Tealeaf' 或 pod 'TealeafDebug'，请使用 pod 'Tealeaf/SHA512' 或 pod 'TealeafDebug/SHA512'

使用 MD5

在您的 Podfile 中，请不要使用 pod 'Tealeaf' 或 pod 'TealeafDebug'，请使用 pod 'Tealeaf/MD5' 或 pod 'TealeafDebug/MD5'

重要注意

请确保在您的应用程序目标的 "其他链接器设置" 中使用 $(inherited) 标志，这将确保所有 pods 都能正确链接。

当您的应用程序启动时，MD5 和 SHA512 哈希库会在控制台日志中打印它们的版本。忘记设置 $(inherited) 标志可能是其中一个原因。如果 MD5 或 SHA512 没有正确链接，Tealeaf 将使用内置的 SHA256 默认算法。

您可以在这里了解更多关于哈希库的信息

使用 Carthage 入门

在您选择的高级文本编辑器中打开 Cartfile 并记住以下几行

在Podfile中，针对您项目的目标添加以下行，如果想要使用Tealeaf SDK的正式版版本

binary "https://raw.githubusercontent.com/acoustic-analytics/DigitalAnalytics/master/DAMod.json" >= 1.1.23

binary "https://raw.githubusercontent.com/acoustic-analytics/EOCore/master/EOCore.json" >= 2.3.24

在Podfile中针对您项目的目标添加以下行，如果想要使用Tealeaf SDK的调试版版本

binary "https://raw.githubusercontent.com/acoustic-analytics/DigitalAnalytics/master/DAModDebug.json" >= 1.1.23

binary "https://raw.githubusercontent.com/acoustic-analytics/EOCore/master/EOCoreDebug.json" >= 2.3.24

您将注意到样例应用默认使用库的调试版本。

请注意，您只能使用一个正式版或调试版。不要同时使用两个。

现在您需要运行以下命令安装carthage。

carthage update --platform iOS

上述carthage命令应该无错误地完成。

Swift Package入门指南

请访问

将应用程序图像上传到Tealeaf服务器（仅适用于非增强式回放）

无论您选择哪种哈希算法，我们都建议您重新包装应用程序图像并将它们上传到Tealeaf服务器。具体步骤请参阅这里

故障排除

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

如果您在使用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/myIos.app/myIos 引用。原因：映像未找到，dyld: 启动，加载依赖库

在podfile中，将use_frameworks!更改为use_modular_headers!以解决问题。

许可协议

许可文件可以在此阅读：此处