TMViewTrackerSDK 使用教程

1. 项目的目录结构及介绍

TMViewTrackerSDK 是一个用于自动收集曝光和点击事件的 SDK。以下是该项目的目录结构及其介绍：

TMViewTrackerSDK/
├── Docs/
│   └── viewtrack_performance.md
├── TMViewTrackerSDK.xcodeproj
├── TMViewTrackerSDK/
│   ├── TMViewTrackerManager.h
│   ├── TMViewTrackerManager.m
│   └── ...
├── ViewTrackerSDKDemo/
│   ├── ViewController.h
│   ├── ViewController.m
│   └── ...
├── .gitignore
├── LICENSE
├── Podfile
├── README.md
├── README_CN.md
└── TMViewTrackerSDK.podspec

目录结构介绍

• Docs/: 包含文档文件，如性能相关的文档。
• TMViewTrackerSDK.xcodeproj: Xcode 项目文件。
• TMViewTrackerSDK/: SDK 的核心代码文件夹，包含管理器和其他相关文件。
• ViewTrackerSDKDemo/: 示例项目，展示如何使用 SDK。
• .gitignore: Git 忽略文件。
• LICENSE: 许可证文件，采用 Apache-2.0 许可证。
• Podfile: CocoaPods 配置文件。
• README.md: 英文项目介绍文档。
• README_CN.md: 中文项目介绍文档。
• TMViewTrackerSDK.podspec: CocoaPods 规范文件。

2. 项目的启动文件介绍

TMViewTrackerSDK 的启动文件主要是 TMViewTrackerManager，它负责管理曝光和点击事件的收集。以下是启动文件的介绍：

TMViewTrackerManager.h

#import <Foundation/Foundation.h>

@interface TMViewTrackerManager : NSObject

+ (void)setCurrentPageName:(NSString *)pageName;
+ (void)trackView:(UIView *)view withControlName:(NSString *)controlName args:(NSDictionary *)args;

@end

TMViewTrackerManager.m

#import "TMViewTrackerManager.h"

@implementation TMViewTrackerManager

+ (void)setCurrentPageName:(NSString *)pageName {
    // 设置当前页面名称
}

+ (void)trackView:(UIView *)view withControlName:(NSString *)controlName args:(NSDictionary *)args {
    // 跟踪视图的曝光和点击事件
}

@end

3. 项目的配置文件介绍

TMViewTrackerSDK 的配置文件主要包括 Podfile 和 TMViewTrackerSDK.podspec。

Podfile

Podfile 是 CocoaPods 的配置文件，用于管理项目的依赖库。示例如下：

platform :ios, '9.0'

target 'ViewTrackerSDKDemo' do
  pod 'TMViewTrackerSDK', :path => '../'
end

TMViewTrackerSDK.podspec

TMViewTrackerSDK.podspec 是 CocoaPods 的规范文件，用于定义 SDK 的版本、依赖等信息。示例如下：

Pod::Spec.new do |spec|
  spec.name         = 'TMViewTrackerSDK'
  spec.version      = '1.0.0'
  spec.summary      = 'A SDK for tracking view exposure and click events.'
  spec.homepage     = 'https://github.com/alibaba/TMViewTrackerSDK'
  spec.license      = { :type => 'Apache-2.0', :file => 'LICENSE' }
  spec.author       = { 'Alibaba' => '[e-mail]' }
  spec.source       = { :git => 'https://github.com/alibaba/TMViewTrackerSDK.git', :tag => spec.version.to_s }
  spec.ios.deployment_target = '9.0'
  spec.source_files = 'TMViewTrackerSDK/**/*.{h,m}'
  spec.public_header_files = 'TMViewTrackerSDK/**/*.h'
end

以上是 TMViewTrackerSDK 的基本使用教程，涵盖了项目的目录结构、启动文件和配置文件的介绍。希望对您有所帮助。