全部产品
云市场
云游戏

快速开始

更新时间:2020-09-17 16:41:40

根据 mPaaS 客户端与服务端协定的埋点数据格式,服务端从客户端上传的埋点日志中提取有效数据,从而实现对客户端各项指标的监控分析。

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

完整的接入过程分为以下五步:

  1. 添加 SDK
  2. 初始化 mPaaS
  3. 添加配置
  4. 添加日志
  5. 查看本地日志
  6. 上报日志

前置条件

添加 SDK

原生 AAR 方式

参考 AAR 组件管理,通过 组件管理(AAR) 在工程中安装 移动分析(LOGGING)组件。

mPaaS Inside 方式

在工程中通过 组件管理 安装 移动分析(LOGGING)组件。

更多信息,请参考 管理组件依赖 > 增删组件依赖

组件化方式

在 Portal 和 Bundle 工程中通过 组件管理 安装 移动分析(LOGGING) 组件。

更多信息,请参考 管理组件依赖 > 增删组件依赖

初始化 mPaaS

原生 AAR 接入/mPaaS Inside 接入

如果您使用原生 AAR 接入或 mPaaS Inside 接入方式,则需要初始化 mPaaS。

Application 对象中添加以下代码:

  1. public class MyApplication extends Application {
  2. @Override
  3. protected void attachBaseContext(Context base) {
  4. super.attachBaseContext(base);
  5. // mPaaS 初始化回调设置
  6. QuinoxlessFramework.setup(this, new IInitCallback() {
  7. @Override
  8. public void onPostInit() {
  9. // 此回调表示 mPaaS 已经初始化完成,mPaaS 相关调用可在这个回调里进行
  10. }
  11. });
  12. }
  13. @Override
  14. public void onCreate() {
  15. super.onCreate();
  16. // mPaaS 初始化
  17. QuinoxlessFramework.init();
  18. }
  19. }

组件化接入

使用组件化接入方式,mPaaS 框架会自动初始化,您无需操作。

添加配置

上传日志

上传日志需要访问网络,请在 AndroidManifest 中声明以下权限。

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

日志诊断

如果您需要使用日志诊断功能(链接到日志诊断),请在 AndroidManifest 中声明以下权限,并在 Android 6.0+ 设备上运行时动态申请该权限。

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

诊断日志会保存到设备的 SD 卡上,如果未申请该权限,可能无法获取诊断日志。

设置渠道号

如果您需要在控制台中区分不同渠道的 apk 的数据,您可以为 apk 设置渠道号。

在工程的 assets 目录下创建 channel.config 文件,修改 channel_id 的值即可。

  1. # 标识当前的发布渠道
  2. channel_id=alipay

如果未创建 channel.config 文件,渠道号默认为 mpaas_default

添加日志

SDK 接入完毕后,添加以下日志:

查看本地日志

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

上报日志

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