快速开始

移动分析依赖客户端 SDK 来进行埋点，收集用户行为以及 App 性能等相关数据生成日志并上报到服务端。根据 mPaaS 客户端与服务端协定的埋点数据格式，服务端从客户端上传的埋点日志中提取有效数据，从而实现对客户端各项指标的监控分析。

本文介绍如何快速将 MAS 组件接入到 Android 客户端。目前，MAS 组件支持 原生 AAR 接入、mPaaS Inside 接入 和 组件化接入 三种接入方式。

完整的接入过程分为以下六步：

1. 添加 SDK
2. 初始化 mPaaS
3. 添加配置
4. 添加日志
5. 查看本地日志
6. 上报日志

前置条件

• 若采用原生 AAR 方式接入，需要先 将 mPaaS 添加到您的项目中。
• 若采用 mPaaS Inside 方式接入，需要先完成 mPaaS Inside 接入流程。
• 若采用组件化方式接入，需要先完成 组件化接入流程。

添加 SDK

原生 AAR 方式

参考 AAR 组件管理，通过 组件管理（AAR） 在工程中安装 日志（LOGGING）组件。

mPaaS Inside 方式

在工程中通过 组件管理 安装 日志（LOGGING）组件。

更多信息，请参考 管理组件依赖 > 增删组件依赖。

组件化方式

在 Portal 和 Bundle 工程中通过 组件管理 安装 日志（LOGGING） 组件。

更多信息，请参考 管理组件依赖 > 增删组件依赖。

初始化 mPaaS

原生 AAR 接入/mPaaS Inside 接入

如果您使用原生 AAR 接入或 mPaaS Inside 接入方式，则需要初始化 mPaaS。

在 Application 对象中添加以下代码：

public class MyApplication extends Application {
    @Override
    protected void attachBaseContext(Context base) {
        super.attachBaseContext(base);
        // mPaaS 初始化回调设置
        QuinoxlessFramework.setup(this, new IInitCallback() {
            @Override
            public void onPostInit() {
                // 此回调表示 mPaaS 已经初始化完成，mPaaS 相关调用可在这个回调里进行
            }
        });
    }
    @Override
    public void onCreate() {
        super.onCreate();
        // mPaaS 初始化
        QuinoxlessFramework.init();
    }
}

组件化接入

使用组件化接入方式，mPaaS 框架会自动初始化，您无需操作。

添加配置

上传日志

上传日志需要访问网络，请在 AndroidManifest 中声明以下权限。

<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.INTERNET" />

日志诊断

如果您需要使用 日志诊断 功能，请在 AndroidManifest 中声明以下权限，并在 Android 6.0+ 设备上运行时动态申请该权限。

<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />

诊断日志会保存到设备的 SD 卡上，如果未申请该权限，可能无法获取诊断日志。

设置渠道号

如果您需要在控制台中区分不同渠道的 apk 的数据，您可以为 apk 设置渠道号。

在工程的 assets 目录下创建 channel.config 文件，修改 channel_id 的值即可。

# 标识当前的发布渠道
channel_id=alipay

如果未创建 channel.config 文件，渠道号默认为 mpaas_default。

添加日志

SDK 接入完毕后，添加以下日志：

• 报活日志
• 性能日志
• 闪退日志
• 自定义事件日志
• 自动化日志

查看本地日志

查看本地日志 了解本地日志信息。

上报日志

将客户端本地文件中的日志同步到日志服务器。参见 上报日志 说明文档了解相关操作。