Tealeaf 10.6.288

Tealeaf 10.6.288

×

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

Tealeaf 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 支持了 3 种不同的哈希算法：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

您将注意到，默认情况下，示例应用程序使用 Debug 版本的库。

注意，您只能使用 Release 或 Debug 中的一个。不要同时使用两个。

现在您需要运行以下命令来安装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中，将使用_frameworks!更改为use_modular_headers!以解决问题。

许可

许可文件可以在此处查看 （链接）