TealeafReactNative 10.6.288

TealeafReactNative 10.6.288

×

由 Bender RodriguezSdk，Omar Hernandez 维护。

TealeafReactNative 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。否则，您将得到可能包含新功能或修复的 beta 版本，这些功能或修复可能尚未经过全面测试或批准。

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) 标志。这将确保所有 pod 正确链接。

当您的应用程序启动时，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 中编辑您项目的 scheme 并添加环境变量 EODebug并将其值设置为 1；另外，添加环境变量 TLF_DEBUG并将其值设置为 1。这会使 SDK 开始将调试日志写入您的 xcode 控制台窗口。如果您需要报告问题时，Tealeaf 支持工程师会要求您提供这些日志。

如果您遇到使用 Cocoapods 的问题

dyld: Library not loaded: @rpath/EOCore.framework/EOCore Referenced from: /Users/h26259/Library/Developer/CoreSimulator/Devices/57B11359-B896-495E-B802-A8377313F848/data/Containers/Bundle/Application/9CE5AF4D-CD63-49F8-8288-677EC7BD81DA/myIos.app/myIos Reason: image not found dyld: launch, loading dependent libraries

在 podfile 中，从使用 framework! 切换到 use_modular_headers! 以纠正问题。

许可证

许可文件可在此处查阅：https://github.com/acoustic-analytics/Tealeaf/blob/master/Licenses/License