TMViewTrackerSDK 教程

1. 项目介绍

TMViewTrackerSDK 是阿里巴巴提供的一款用于自动化收集视图曝光和点击事件的 SDK。开发者通过集成此 SDK，可以轻松追踪用户在 App 中对界面元素的交互情况，无需手动添加大量事件监听代码。该 SDK 支持 iOS 平台，且基于 Apache 2.0 开源协议。

2. 项目快速启动

步骤 1：添加依赖

如果你使用 CocoaPods 管理依赖，将以下内容添加到你的 Podfile：

pod 'TMViewTrackerSDK'

然后运行 pod install 安装 SDK。

步骤 2：导入库

在你需要使用 SDK 的文件中引入头文件：

#import <TMViewTrackerSDK/TMViewTrackerSDK.h>

步骤 3：初始化 SDK

在应用程序的 AppDelegate.m 文件中的 application:didFinishLaunchingWithOptions: 方法中初始化 SDK：

[TMViewTrackerManager setupWithAppKey:@"your_app_key"];

请注意替换 your_app_key 为你自己的应用 key。

步骤 4：设置页面名称

在 ViewController 的 viewDidAppear: 方法中设置当前页面名称：

- (void)viewDidAppear:(BOOL)animated {
    [super viewDidAppear:animated];
    [TMViewTrackerManager setCurrentPageName:@"YourPageName"];
}

步骤 5：标记可追踪视图

给需要追踪的 UIView 添加标签：

UIView *yourView = ...;
[yourView tm_setControlName:@"your_view_name"];
[yourView tm_setArgs:@{@"key":@"value"}]; // 可选，用于附加数据

3. 应用案例和最佳实践

• 自动追踪按钮点击：无需额外代码，已标记的按钮会自动记录点击事件。
• 自定义事件追踪：对于特殊的业务逻辑，可以使用 TMViewTrackerManager 发送自定义事件。

[TMViewTrackerManager trackEvent:@"Custom_Event" args:@{@"key":@"value"}];

• 性能优化：避免在非主线程上设置页面名称或发送事件。

4. 典型生态项目

TMViewTrackerSDK 可以与以下生态系统组件集成：

• 数据分析平台，如 Umeng、Firebase 等，以同步收集的数据。
• 自动化测试工具，结合 UIAutomation 或者 Espresso 进行行为验证。

以上是 TMViewTrackerSDK 的简单介绍和快速集成指南。更多详情及进阶配置，请参考官方仓库的 README 和示例代码。