本文介绍如何将移动分析组件接入到 iOS 客户端。移动分析支持基于 mPaaS 框架接入、基于已有工程且使用 mPaaS 插件接入以及基于已有工程且使用 CocoaPods 接入三种接入方式。您可以参考 接入方式介绍,根据实际业务情况选择合适的接入方式。
前置条件
您已接入工程到 mPaaS。更多信息,请参见以下内容:
添加 SDK
根据您采用的接入方式,请选择相应的添加方式。
使用 mPaaS Xcode Extension 插件
此方式适用于 基于 mPaaS 框架接入 或 基于已有工程且使用 mPaaS 插件接入 的接入方式。
点击 Xcode 菜单项 Editor > mPaaS > 编辑工程,打开编辑工程页面。
选择 移动分析,保存后点击 开始编辑,即可完成添加。
在当前工程的 Build Settings > Header Search Paths 中添加系统库的查找路径:
/usr/include/libxml2
。完成 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 接入 的接入方式。
在 Podfile 文件中,使用
mPaaS_pod "mPaaS_Log"
添加移动分析组件依赖。执行
pod install
即可完成接入。
后续操作
参考对应版本的 SDK 使用文档,使用 SDK。