借助 App 监控的 SDK,您可以获取完备的远程日志。

前提条件

已在 ARMS 中创建 App 监控任务。请参见创建监控任务

背景信息

本文档适用于使用 gradle 管理依赖的 Android Studio 项目。可参考 demo 工程 ha_android_demo

说明 日志在移动端最多存储7天。

步骤一:添加依赖

Maven 仓库依赖接入。

  1. 在项目 build.gradle 中添加阿里云 Maven 仓库地址。
        repositories {    
        maven { url "http://maven.aliyun.com/nexus/content/repositories/releases" }
        }
  2. app 模块中的 build.gradle 的 dependencies 节点内添加以下代码。
    compile('com.aliyun.ams:alicloud-android-ha-adapter:1.1.3.2-open@aar') {
            transitive=true
        }
    compile('com.aliyun.ams:alicloud-android-ha-tlog:1.1.2.2-open@aar') {
            transitive=true
        }

步骤二:接入服务

  1. 在自定义 Application 类的 onCreate 里面启动服务。

        public class MyApplication extends Application {
            @Override
            public void onCreate() {
                initHa();
            }
            private void initHa() {
                 Log.e("ha", "init");
                 AliHaConfig config = new AliHaConfig();
                 config.appKey = "xxxxxxxx";         //appkey
                 config.appVersion = "x.xx";         //应用的版本号信箱
                 config.appSecret = "xxxxxxxxxxxx";  //appsecret
                 config.channel = "mqc_test";        //应用的渠道号标记,自定义
                 config.userNick = null;
                 config.application = this;
                 config.context = getApplicationContext();
                 config.isAliyunos = false;          //是否为yunos
                 config.rsaPublicKey = "xxxxxxx";    //tlog公钥, 在控制台下载 aliyun-emas-services.json文件,文件内的appmonitor.tlog.rsaSecret字段即为公钥信息(文件下载方式:在 EMAS控制台-> 应用管理  找到对应的应用,点击应用所在区块右上角菜单内的“配置下载”),必填
                 AliHaAdapter.getInstance().addPlugin(Plugin.tlog);
                 AliHaAdapter.getInstance().openDebug(true);
                 AliHaAdapter.getInstance().start(config);
            }
        }
    说明 appkey 和 appsecret,可在创建监控任务中,步骤4下载的配置文件中获得。
  2. AndroidManifest.xml 里面指定自定义 Application。

        <application
            android:name=".MyApplication"
            android:allowBackup="true"
            android:icon="@mipmap/ic_launcher"
            android:label="@string/app_name"
            android:supportsRtl="true"
            android:theme="@style/AppTheme" >
            ...
        </application>
  3. app 模块的 build.gradle 的 defaultConfig 节点内添加以下代码,根据需要配置 abi:
    ndk {
            abiFilters 'armeabi-v7a'
        }

步骤三:获取远程日志

import com.alibaba.ha.adapter.service.tlog.TLogService;

示例代码:

    String TAG = "xxx";
    String MODEL = "xxxxx";

    TLogService.logv(MODEL,TAG,"test tlog1");
    TLogService.logd(MODEL,TAG,"test tlog2");
    TLogService.logi(MODEL,TAG,"test tlog3");
    TLogService.logw(MODEL,TAG,"test tlog4");
    TLogService.loge(MODEL,TAG,"test tlog5");

结果验证

在完成上述步骤之后,您可以对您的 APP 进行测试,并登录 ARMS 控制台查看数据报表。