本文介紹如何快速將 MAS 組件接入到 Android 客戶端。目前，MAS 組件支持 原生 AAR 接入和 組件化接入 兩種接入方式。

完整的接入過程分為以下六步：

1. 添加 SDK

2. 初始化 mPaaS

3. 添加配置

4. 添加日志

5. 查看本地日志

6. 上報日志

前置條件

• 若采用原生 AAR 方式接入，需要先 將 mPaaS 添加到項目。

• 若采用組件化方式接入，需要先完成 組件化接入流程。

添加 SDK

原生 AAR 方式

參考 管理組件依賴（原生 AAR）AAR 組件管理，通過 組件管理（AAR） 在工程中安裝 日志（LOGGING）組件。

組件化方式

在 Portal 和 Bundle 工程中通過 組件管理 安裝 日志（LOGGING） 組件。更多信息，參考 接入流程添加組件依賴。

初始化 mPaaS

原生 AAR 接入

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

在 Application 對象中添加以下代碼：

public class MyApplication extends Application {
    
    @Override
    public void onCreate() {
        super.onCreate();
        // mPaaS 初始化
        MP.init(this);    
    }
}

詳情請參考：初始化 mPaaS。

組件化接入

使用組件化接入方式，mPaaS 框架會自動初始化，您無需操作。

添加配置

上傳日志

上傳日志需要訪問網(wǎng)絡(luò)，請在 AndroidManifest 中聲明以下權(quán)限。

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

日志診斷

如果您需要使用 日志診斷 功能，請在 AndroidManifest 中聲明以下權(quán)限，并在 Android 6.0+ 設(shè)備上運行時動態(tài)申請該權(quán)限。

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

診斷日志會保存到設(shè)備的 SD 卡上，如果未申請該權(quán)限，可能無法獲取診斷日志。

設(shè)置渠道號

如果您需要在控制臺中區(qū)分不同渠道的 apk 的數(shù)據(jù)，您可以為 apk 設(shè)置渠道號。

在工程的 assets 目錄下創(chuàng)建 channel.config 文件，修改 channel_id 的值即可。

# 標(biāo)識當(dāng)前的發(fā)布渠道
channel_id=alipay

如果未創(chuàng)建 channel.config 文件，渠道號默認為 mpaas_default。

獲取 IMEI / IMSI

在低于 Android 10 的系統(tǒng)上，已獲得相關(guān)權(quán)限的情況下默認會獲取設(shè)備的 IMEI 和 IMSI，如果您需要完全禁止獲取這類信息的行為，請在AndroidManifest 中添加以下配置：

<meta-data
    android:name="imei.switch"
    android:value="off" />

添加日志

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

• 報活日志

• 性能日志

• 閃退日志

• 自定義事件日志

• 自動化日志

查看本地日志

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

上報日志

將客戶端本地文件中的日志同步到日志服務(wù)器。參見 上報日志 說明文檔了解相關(guān)操作。