添加 SDK

重要：自 2020 年 6 月 28 日起，mPaaS 停止维护 10.1.32 基线。请使用 10.1.68 或 10.1.60 系列基线。可以参考 mPaaS 10.1.68 升级指南 或 mPaaS 10.1.60 升级指南 进行基线版本升级。

本文介绍如何将移动分析组件接入到 iOS 客户端。

移动分析支持基于 mPaaS 框架接入、基于已有工程且使用 mPaaS 插件接入以及基于已有工程且使用 CocoaPods 接入三种接入方式。您可以参考 接入方式介绍，根据实际业务情况选择合适的接入方式。

前置条件

您已接入工程到 mPaaS。更多信息，请参见以下内容：

• 基于 mPaaS 框架接入
• 基于已有工程且使用 mPaaS 插件接入
• 基于已有工程且使用 CocoaPods 接入

添加 SDK

根据您采用的接入方式，请选择相应的添加方式。

使用 mPaaS Xcode Extension 插件

此方式适用于 基于 mPaaS 框架接入 或 基于已有工程且使用 mPaaS 插件接入 的接入方式。

1. 点击 Xcode 菜单项 Editor > mPaaS > 编辑工程，打开编辑工程页面。
2. 选择 移动分析，保存后点击 开始编辑，即可完成添加。
   
3. 在当前工程的 Build Settings > Header Search Paths 中添加系统库的查找路径：/usr/include/libxml2。
4. 完成 SDK 添加后，您会在当前工程的 MpaaS/Frameworks 目录下看到相应的 Framework。关于 Framework 及对应的解释如下：

库名	Framework	解释
埋点	MPRemoteLogging	程序运行到某处触发的事件，会记录日志。
自动化埋点	MPAutoTracker	通过 hook UI 组件，自动监控用户的手势操作；同时可以自动监控应用的界面切换等事件。
性能埋点	MPPerformance	对 App 的内存、耗电量、流量等提供监控数据。
Crash 报告	APCrashReporter	对产生的崩溃日志进行收集并进行反解、归类，提供给开发者分析工具以更好地解决崩溃问题，进而提高应用的稳定性。
接口层	MPMasAdapter	对报活、启动速度、电量、闪退上报等日志封装的接口库。不使用 mPaaS iOS 框架的应用需手动调用其中的接口方法，才能在应用分析控制台中看到相关数据。

10.1.32 及以上版本 SDK 提供中间层 MPMasAdapter，统一并简化接口的使用。接口详情请参考 Framework 中的 MPRemoteLoggingInterface.h 和 MPAnalysisHelper.h。

使用 cocoapods-mPaaS 插件

此方式适用于 基于已有工程且使用 CocoaPods 接入 的接入方式。

1. 在 Podfile 文件中，使用 mPaaS_pod "mPaaS_Log" 添加移动分析组件依赖。
   
2. 执行 pod install 即可完成接入。

后续操作

参考对应版本的 SDK 使用文档，使用 SDK。