首页 帮助中心 听云App Android平台-IntelliJ

听云Android平台SDK安装-IntelliJ部署方式

1 设置应用名称

  请为需要监测的App设置一个易于识别的应用名称,该App名称将出现在App列表和相关的报表中来代表对应的App。
  App名称可以使用字母数字和中文,最长32个字符。设置App名称时,尽量不要设置重复的App名称,以免给自己造成不必要的麻烦。
  您的App名称可以在设置选项中随时修改

2 使用IntelliJ构建

2.1 安装探针

注意:

需要确保已经安装了Gradle构建环境和IntelliJ开发环境。

1、下载并解压nbs-newlens-android.zip探针压缩包

2、将解压后的nbs-newlens-agent.jar拷贝至嵌码项目工程的libs目录下,如未找到该目录,需新建libs目录并添加。

2.2 配置听云环境变量

1、打开IntelliJ IDEA -> Preferences…

2、将其中的Additional VM参数值的设置为:

-javaagent:/path/nbs.newlens.class.rewriter.jar文件所在的绝对路径。

2.3 配置应用权限

  构建完成后,请在待监测的App工程的AndroidMainfest.xml文件中增加以下的权限

<uses-permissionandroid:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permissionandroid:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permissionandroid:name="android.permission.READ_PHONE_STATE"/>
<uses-permissionandroid:name="android.permission.READ_LOGS" />
<uses-permissionandroid:name="android.permission.INTERNET" />

2.4 插入初始化探针代码

1、在嵌码项目工程的启动页面“MainActivity”中import NBSAppAgent类

import com.networkbench.agent.impl.NBSAppAgent;

2、在“MainActivity”中的onCreate()方法(如未找到该方法请新增onCreate())中初始化Android SDK

NBSAppAgent.setLicenseKey("AppKey").withLocationServiceEnabled(true).
start(this.getApplicationContext());
//Appkey请从官网获取

3、在“Application”中的onCreate()方法(如未找到该方法请新增onCreate())中初始化Android SDK(可选)

注意:

该配置仅仅只限于有多进程性能监控需求的应用。

NBSAppAgent.setLicenseKey("AppKey").withLocationServiceEnabled(true).
startInApplication(this.getApplicationContext());
//Appkey请从官网获取

4、若无需采集地理位置,请使用以下配置

NBSAppAgent.setLicenseKey("AppKey").start(this.getApplicationContext());
//Appkey请从官网获取

2.5 配置混淆

1、发布前请在proguard混淆配置文件中增加以下内容,以免tingyunSDK不可用

# ProGuard configurations for NetworkBench Lens
-keep class com.networkbench.** { *; }
-dontwarn com.networkbench.**
-keepattributes Exceptions, Signature,InnerClasses
# End NetworkBench Lens

2、若需要保留行号信息,请在proguard.cfg 中添加以下内容

-keepattributes SourceFile,LineNumberTable

3 嵌码验证

1、数据收集服务器校验

2、嵌码完成后可通过“LogCat”查看听云SDK日志输出结果,用以进行数据收集服务器校验TAG为NBSAgent,标准日志输出结果如下所示:

NBSAgent start
NBSAgent enabled
NBSAgent V “TingYun_Version” //TingYun_Version 为当前SDK的版本号
connect success

3、数据功能完整性校验

  嵌码完成后可通过“LogCat”查看听云SDK日志输出结果,用以进行数据功能完整性校验TAG为TingYun,标准日志输出结果如下所示:

D/TingYun: Crash switch is true
D/TingYun: webView switch is true
D/TingYun: ANR monitor switch is true
D/TingYun: UserAction Switch  is true
D/TingYun: cdnSwitch Switch  is true

4 高级功能

4.1 用户自定义ID

1、功能说明

  用户自定义ID为当前用户设置唯一标示码,在任意位置均可设置UserID。

2、相关接口

//UserID最多包含64个字符,支持中文、英文、数字、下划线,但不能包含空格或其他的转义字符
NBSAppAgent.setUserIdentifier("userIdentifier");

3、代码示例

public class MainActivity extends Activity {
    public void onCreate(BundlesavedInstanceState) {
        super.onCreate(savedInstanceState);
        String userIdentifier =getUserID();         NBSAppAgent.setLicenseKey("AppKey").withLocationServiceEnabled(true).
start(this.getApplicationContext());
        NBSAppAgent.setUserIdentifier(userIdentifier);
      }
}

4.2 面包屑

1、功能说明

  面包屑能够更好的协助用户调查崩溃发生的原因,可以知晓用户发生崩溃之前的代码逻辑与崩溃轨迹结合使用能够更好的复现用户崩溃场景。

2、相关接口

//最多包含100个字符,支持中文、英文、数字、下划线 
NBSAppAgent.leaveBreadcrumb("keyPressed”);
NBSAppAgent.leaveBreadcrumb("loginDone");

3、代码示例

public MyActivity extends Activity {
         publicvoid onCreate(Bundle savedInstanceState) {
            super.onCreate(savedInstanceState);          
NBSAppAgent.setLicenseKey("AppKey").withLocationServiceEnabled(true).
start(this.getApplicationContext());
             NBSAppAgent.leaveBreadcrumb("login MyActivityonCreate");
         }
         publicvoid onResume() {
            super.onResume();
            NBSAppAgent.leaveBreadcrumb("login MyActivityonResume");
         }
         publicvoid logginPressed(View view) {
             NBSAppAgent.leaveBreadcrumb("login MyActivitylogginPressed");
             new LoginAsyncTask.execute();
         }
         publicvoid onStop() {
             super.onStop();
             NBSAppAgent.leaveBreadcrumb("login MyActivityonStop");
         }
}

4.3 自定义Event

1、功能说明

  自定义事件用于统计App中的任意事件,开发者可以在SDK初始化后的任意位置添加自定义事件,并设置对应上传参数。如:真实用户操作时候点击某个功能按钮或触发了某个功能事件等。

2、相关接口

//EVENT_ID最多包含32个字符,支持中文、英文、数字、下划线,但不能包含空格或其他的转义字符
NBSAppAgent.onEvent(String EVENT_ID);

3、代码示例

@Override
public void onClick(View v) {
    …………
        NBSAppAgent.onEvent("添加购物车");
      …………
}

4.4 自定义Trace

注意:

由于自定义Trace是成对出现的,请勿跨方法、跨进程以及在异步加载和递归调用中使用该接口。

1、功能说明

  听云SDK默认采集系统类和方法的性能数据,无法采集开发者自定义类和方法的性能数据。使用“自定义Trace”接口就可以帮助开发者时刻了解所写代码的健壮性及其性能数据。如:开发者想要了解某个自定义方法的初始化耗时及性能消耗情况,就可以在该自定义方法前后添加“自定义Trace”接口即可。

2、相关接口

//Name 为当前方法所在方法名或自定义名称,支持中文、英文、数字、下划线,但不能包含空格或其他的转义字符
NBSAppAgent.beginTracer("String Name");
NBSAppAgent.endTracer("String Name");

3、代码示例

//用户可以在SDK初始化后的任意方法前后添加自定义Trace
public void onCreate(Bundle savedInstanceState) {
      super.onCreate(savedInstanceState);
      setContentView(R.layout.main);
      init();
     }
private void init() {
     //方法开始前添加beginTracer
     NBSAppAgent.beginTracer(“这是Init方法”); 
        try {
            ………
        } catch(NameNotFoundException e) {
           e.printStackTrace();
        }
     //方法结束后添加endTracer
     NBSAppAgent.endTracer(“这是Init方法”);
}

4.5 自定义Log

注意:

收集LogCat信息,需要使用READ_LOGS权限,请将下列代码添加到应用程序的AndroidManifest.xml文件中,默认收集50行,最多收集100行日志。

< uses-permissionandroid:name="android.permission.READ_LOGS" >

1、功能说明

  开发者可通过Android日志系统的LogCat,来收集和查看系统调试输出的信息,通过打印输出的Log信息来调查Bug发生时的应用程序信息,并通过听云SDK上传自定义Log日志。

2、控制开关

NBSAppAgent.setLicenseKey("AppKey").withLocationServiceEnabled(true).
enableLogging(true).start(this.getApplicationContext());

3、相关接口

NBSAppAgent.setLogging(int lineNumber);
NBSAppAgent.setLogging(String filter);
NBSAppAgent.setLogging(int lineNumber,String filter);

4、代码示例

public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
     setContentView(R.layout.main);
      // Enablelogging
 NBSAppAgent.setLicenseKey("AppKey").withLocationServiceEnabled(true).
 enableLogging(true).start(this.getApplicationContext());
          // Log last 100messages
         NBSAppAgent.setLogging(100);
}

4.6 自定义附加信息

1、功能说明

  用户可以在初始化之后任意位置配置该接口,最多可添加10条附加信息,每条附加信息最大支持100个字节随崩溃上传。

2、相关接口

NBSAppAgent.setUserCrashMessage(String key,Stringvalue);

3、代码示例

public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
     setContentView(R.layout.main);        		 NBSAppAgent.setLicenseKey("AppKey").withLocationServiceEnabled(true).
start(this.getApplicationContext());
      //初始化后的任意位置插入自定义附加信息
      NBSAppAgent.setUserCrashMessage(“张三”,“13700001234”);
}

5 设置本地配置文件

5.1 新建tingyun.properties配置文件

  在嵌码项目工程根目录下,新建tingyun.properties配置文件即可。

6.2 配置Crash反混淆(mapping)

  听云SDK提供了两种方式进行反混淆设置。

通过报表上传mapping文件

1、报表中选择“崩溃”模块,在“崩溃历史记录列表”打开“dSYM/Mapping文件管理”。

2、找到所需版本,并上传本地mapping文件即可。

通过tingyun.properties文件自动上传mapping文件

1、添加如下配置到tingyun.properties文件

authKey=听云API账号授权Key,由报表系统生成
appKey=听云AppKey
mapping_file_auto_upload=true

2、配置Authkey授权码

a.  登陆报表后选择“授权码”。

b.  复制当前授权码并添加到tingyun.properties即可。

3、配置AppKey

​   tingyun.properties配置文件中的AppKey相同,在“修改设置”中获取即可。

4、配置mapping_file_auto_upload控制开关

mapping_file_auto_upload=true

5、开启混淆器

  mapping_file_auto_upload控制开关只有在启用混淆器的时候才会生效,开启控制开关后,听云SDK会将本地目录下的mapping文件自动上传到听云服务器。若未开启混淆器则该配置项不生效。

5.3 配置OkHttp控制开关

注意:

听云SDK默认对OkHttp2.0系列版本进行嵌码。请选择对应版本进行配置,不可设置多个版本。

1、若当前App使用的是OkHttp2.0系列版本请忽略该设置

2、若当前App使用的是OkHttp3.0系列版本请添加如下配置到tingyun.properties配置文件中

okhttp3.0=true

3、若当前App使用的是OkHttp1.0系列版本请添加如下配置到tingyun.properties配置文件中

okhttp2.0=false

5.4 配置WebView控制开关

注意:

WebView(H5)页面的性能数据是通过JS回调方式采集的,请开启JS回调开关:WebView.setWebContentsDebuggingEnabled(**true**);

注:允许JS回调在Android4.0系统上会有一些系统级别的安全漏洞,如有较高安全需求,则可在Android5.0及其以上版本使用或忽略该配置。

1、请将如下配置添加到tingyun.properties配置文件中

webview=true

2、采集WebView数据需调用setWebViewClient方法,如嵌码App中未调用该方法,请添加如下内容

webview.setWebViewClient(new WebViewClient(){});

附录

支持协议类库

HttpURLConnection

AndroidHttpClient
 4.0

Apache HttpClient ( > 4.0)

Volley+OkHttpClient

OkHttp 2.0 ( > 2.1)

OkHttp 1.0

Retrofit (> 1.9)

WebView(原生)

支持操作系统

Android2.0版本~Android7.0版本

支持数据采集项

Android SDK通过在指定的方法中嵌码去采集下列方法中的数据。可以通过报表服务器查询各种方法的数据和调用次数。

应用响应时间

DNS解析时间

TCP建连时间

SSL握手时间

首包时间

访问量

Android SDK探针也可以采集线程堆栈,数据库、自定义参数和HTTP请求参数。