快速开始 - 移动开发平台 mPaaS

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

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

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

添加 SDK
初始化 mPaaS
添加配置
添加日志
查看本地日志
上报日志

前置条件

若采用原生 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 接入完毕后，添加以下日志：

查看本地日志

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

上报日志

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