全部产品

添加 SDK

更新时间:2020-09-10 11:22:56

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

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

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

前置条件

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

添加 SDK

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

使用 mPaaS Xcode Extension 插件

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

  1. 点击 Xcode 菜单项 Editor > mPaaS > 编辑工程,打开编辑工程页面。
  2. 选择 移动分析,保存后点击 开始编辑,即可完成添加。
    mas
  3. 在当前工程的 Build Settings > Header Search Paths 中添加系统库的查找路径:/usr/include/libxml2
  4. 完成 SDK 添加后,您会在当前工程的 MpaaS/Frameworks 目录下看到相应的 Framework。关于 Framework 及对应的解释如下:
库名 Framework 解释
埋点 MPRemoteLogging 程序运行到某处触发的事件,会记录日志。
自动化埋点 MPAutoTracker 通过 hook UI 组件,自动监控用户的手势操作;同时可以自动监控应用的界面切换等事件。
性能埋点 MPPerformance 对 App 的内存、耗电量、流量等提供监控数据。
Crash 报告 MPCrashReporter 对产生的崩溃日志进行收集并进行反解、归类,提供给开发者分析工具以更好地解决崩溃问题,进而提高应用的稳定性。
接口层 MPAnalysisHelper 对报活、启动速度、电量、闪退上报等日志封装的接口库。不使用 mPaaS iOS 框架的应用需手动调用其中的接口方法,才能在应用分析控制台中看到相关数据。

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

使用 cocoapods-mPaaS 插件

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

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

后续操作

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