全部產品
Search
文件中心

Mobile Platform as a Service:快速開始

更新時間:Jul 13, 2024

移動分析依賴用戶端 SDK 來進行埋點,收集使用者行為以及 App 效能等相關資料組建記錄檔並上報到服務端。根據 mPaaS 用戶端與服務端協定的埋點資料格式,服務端從用戶端上傳的埋點日誌中提取有效資料,從而實現對用戶端各項指標的監控分析。

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

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

  1. 添加 SDK

  2. 初始化 mPaaS

  3. 添加配置

  4. 添加日誌

  5. 查看本地日誌

  6. 上報日誌

前置條件

添加 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 架構會自動初始化,您無需操作。

添加配置

上傳日誌

上傳日誌需要訪問網路,請在 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

擷取 IMEI / IMSI

在低於 Android 10 的系統上,已獲得相關許可權的情況下預設會擷取裝置的 IMEI 和 IMSI,如果您需要完全禁止擷取這類資訊的行為,請在AndroidManifest 中添加以下配置:

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

僅在 10.2.3.6 及以上基準生效,添加配置後,移動分析、訊息推送、資料同步都將不再擷取裝置的 IMEI 和 IMSI。

添加日誌

SDK 接入完畢後,添加以下日誌:

查看本地日誌

查看本地日誌 瞭解本地日誌資訊。

上報日誌

將用戶端本地檔案中的日誌同步到Log Service器。參見 上報日誌 說明文檔瞭解相關操作。