添加 SDK

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

前置条件

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

添加 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.hMPAnalysisHelper.h

使用 cocoapods-mPaaS 插件

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

  1. 在 Podfile 文件中,使用 mPaaS_pod "mPaaS_Log" 添加移动分析组件依赖。

  2. 执行 pod install 即可完成接入。

后续操作

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