基础指南

适用范围

MTA 适用于 iOS 8 以及以上的 iOS 系统。

集成准备 —— 创建应用

登陆官网管理台，按照步骤提示注册应用，可获得AppKey，获取位置如下图所示：

集成接入

接入 SDK

cocoapods

如果您的工程使用 cocoapods 来管理第三方库，我们推荐使用 cocoapods 集成 SDK，请前往 MTA 官方 cocoapods 镜像仓库，按照说明接入 MTA SDK。

手动集成

如果您不打算或者没有使用 cocoapods 来管理第三方库，可以采用以下的方式手动接入 MTA SDK。

1. 前往 SDK 下载页面下载SDK。

2. 解压下载好的 SDK 压缩包。

3. 将 MTA.h 以及 libmtasdk.a 添加到工程

4. 添加其他 MTA 依赖的库或者 framework

   
5. 在工程的 Other Linker Flags 中添加 -ObjC 参数

   

启动 SDK

无论您通过哪种方式接入 MTA，您都需要手动添加代码来启动 MTA。

1. 打开工程目录中的 AppDelegate.m 文件，在文件开头添加以下代码引入 MTA 头文件

    #import "MTA.h"

2. 在启动方法 didFinishLaunchingWithOptions 中添加如下语句

    - (BOOL)application:(UIApplication *)application 
        didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
            // ...
            [MTA startWithAppkey:@"I2E3KXDU1E2W"];
            // I2E3KXDU1E2W 属于独有的 Appkey 用于配置 SDK
            // ...
            return YES;
        }

查看 MTA 工作日志

当 MTA 工作不正常，或者您想查看 MTA 的工作状态时，可以打开 MTA 的工作日志，方法如下

1. 在工程的 AppDelegate.m 文件中引入 MTAConfig 头文件

    #import "MTAConfig.h"

2. 在调用 [[MTA startWithAppkey:] 前，开启 MTA 的工作日志

    - (BOOL)application:(UIApplication *)application
    didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
        // ...
        [[MTAConfig getInstance] setDebugEnable:YES];
        [MTA startWithAppkey:@"I2E3KXDU1E2W"];
        // I2E3KXDU1E2W 属于独有的 Appkey 用于配置 SDK
        // ...
    return YES;
    }

验证数据上报

成功嵌入sdk后，在手机运行您上面已经编译好的应用（确保已执行MTA代码），便会自动上报数据。

在应用的接入配置页开始SDK集成验证，查看是否接入成功（验证只能使用真机），如下图所示：

SDK会实时上报数据请等待验证，验证耗时约1分钟，超时请按以下顺序检查：

（1）手机的wifi是否打开，是否正常联网；

（2）APPKEY设置是否正确；

（3）确保已触发MTA统计代码；

（4） 查看Xcode的输出是否有错误信息。