Mobile Platform as a Service:Quick start

This topic briefly describes how to fast integrate MAS to the Android client. You can integrate MAS through Native AAR or Portal & Bundle.

The complete integration process mainly includes the following six steps:

1. Add SDK

2. Initialize mPaaS

3. Set project

4. Add logs

5. View local logs

6. Upload logs

Prerequisites

• If you integrate MAS through Native AAR, ensure that you have added mPaaS to project.

• If you integrate MAS in componentized integration mode (through Portal & Bundle projects), ensure that you have completed the componentized integration process.

Add SDK

Native AAR mode

Follow the instructions in AAR component management to install the LOGGING component in the project through Component management (AAR).

Componentized integration mode

Install the LOGGING component in the Portal and Bundle projects through Component management.

For more information, see Manage component dependencies > Add/delete component dependencies.

Initialize mPaaS

Native AAR

If you integrate MAS through Native AAR, you must initialize mPaaS.

Add the following codes in the object Application:

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

For more details, see Initialize mPaaS.

Componentized integration mode

To integrate MAS in componentized integration mode (Portal & Bundle), you don't have to implement mPaaS initialization.

Set project

Log uploading

Network access is required to upload logs. You need to declare the following permissions in the AndroidManifest file.

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

Log diagnosis

To use the log About client diagnosis, you need to declare the following permission in the AndroidManifest file, and apply for the permission when the App runs on the Android 6.0+ devices.

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

The diagnostic log will be saved to the SD card of the device. With above permission, you cannot obtain the diagnostic log.

Channel number setting

To distinguish the apk data of different channels in the mPaaS console, you can set channel number for the apk.

In the App project, create the channel.config file under the directory assets and modify the value of channel_id.

# Identify the current release channel
channel_id=alipay

Get IMEI / IMSI

On systems lower than Android 10, the IMEI and IMSI of the device will be obtained by default if the relevant permissions have been obtained. If you need to completely prohibit the behavior of obtaining such information, please add the following configuration to AndroidManifest:

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

Add logs

You can add the following logs after integrating the SDK:

• Active report

• Performance log

• Crash log

• Custom event log

• Automation log

View local logs

View local logs to learn the local log information.

Upload logs

Synchronize the local files on a client to the log server. For specific operations, see Upload logs.