快速开始_接入 Android_移动分析_移动开发平台mPaaS-阿里云

根据 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();
    }
}

组件化接入

如果使用组件化接入方式，则您需要完成以下工程配置：

为了访问网络和保存日志，在 AndroidManifest 中申明以下权限。

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

在 AndroidManifest 中添加加密公钥和相关 Service 和 Receiver。

 <!--日志的加密公钥-->
 <meta-data
     android:name="setting.logging.encryption.pubkey"
     android:value="MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQCpffOiYcozIfgIiaOPWsmfktv7Sl/9Af3mIgYz7vkTXoGq4iMN+t5BLV6KjddVEI/9oLtAYV8qx7FhFrUoi3smcYfX35ETPUiHi1gLizeXKVSRYhIm2kiDF5lGfDgcS7uJZvmKjbdYy/RphnH+WQvQyeEH+4rjYSkdhIRE2W52BwIDAQAB" />
 <!--上传日志-->
 <service
     android:name="com.alipay.mobile.common.logging.process.LogServiceInToolsProcess"
     android:enabled="true"
     android:exported="false"
     android:process=":tools" />
 <!--上报 native 闪退-->
 <receiver
     android:name="com.alipay.mobile.common.logging.process.LogReceiverInToolsProcess"
     android:enabled="true"
     android:exported="false"
     android:process=":tools">
     <intent-filter>
         <action android:name="${applicationId}.monitor.command"/>
     </intent-filter>
 </receiver>
 <!--监控和诊断-->
 <service
     android:name="com.alipay.mobile.logmonitor.ClientMonitorService"
     android:enabled="true"
     android:exported="false"
     android:process=":push" />
 <receiver
     android:name="com.alipay.mobile.logmonitor.ClientMonitorWakeupReceiver"
     android:enabled="true"
     android:exported="false"
     android:process=":push">
     <intent-filter>
         <action android:name="android.intent.action.BOOT_COMPLETED" />
         <action android:name="${applicationId}.push.action.CHECK" />
         <action android:name="${applicationId}.monitor.command" />
     </intent-filter>
 </receiver>

（可选）设置渠道号，在 Portal 工程的 assets 文件夹内创建 channel.config 文件。
```
 # 标识当前的发布渠道
 channel_id=alipay
```

添加日志

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

查看本地日志

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

上报日志

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