本文以Android App应用为例，介绍App应用接入与使用内存泄漏的完整流程。

步骤一：获取SDK

1. 在project级别的build.gradle文件中，添加maven地址。

   buildscript {
       repositories {
           maven {
               url "https://artifact.bytedance.com/repository/Volcengine/"
           }
           maven {
               url "https://artifact.bytedance.com/repository/byteX/"
           }
       }
   }
   allprojects {
       repositories {
           maven {
               url "https://artifact.bytedance.com/repository/Volcengine/"
           }
       }
   }
   

2. 接入应用性能监控全链路版。

   1. 在project级别的build.gradle文件的dependencies中，添加以下代码，接入插件组件辅助插桩。apm_insight_plugin 国内海外使用同一个版本。

      classpath "com.volcengine:apm_insight_plugin:1.4.2"
      

   2. 在app module的build.gradle文件的dependencies中，添加以下代码，根据国内应用还是海外应用选择下面两个版本的一个。

      • 国内应用接入cn版本，上报到中国，使用如下依赖：

        // 国内应用在dependencies中添加
        implementation 'com.volcengine:apm_insight:1.5.6.cn'
        implementation 'com.volcengine:apm_insight_crash:1.5.9'
        

      • 海外应用接入oversea版本，上报到马来西亚柔佛，使用如下依赖：

        // 海外应用在dependencies中添加
        implementation 'com.volcengine:apm_insight:1.5.7.oversea'
        implementation 'com.volcengine:apm_insight_crash:1.5.8.oversea'
        

步骤二：初始化SDK并开启监控

1. 在Application中onCreate中，添加以下代码，初始化性能相关功能。

   注意

   请在主线程中添加初始化性能相关功能的代码。

   //必须放到Application的onCreate里面，会注册监听生命周期，不涉及数据采集和隐私合规问题
   ApmInsight.getInstance().init(application);
   //初始化自定日志，配置自定义日志最大占用磁盘，内部一般配置20，代表最大20M磁盘占用。1.4.1版本开始存在这个api
   VLog.init(this,20);
   

2. 启动性能监控，开始收集数据。

   注意

   请在用户同意隐私政策后，再调用方法收集数据。

   ApmInsightInitConfig.Builder builder = ApmInsightInitConfig.builder();
   //开启泄露和泄露兜底检测能力，泄露检测和泄露兜底需要分别在平台配置采样
   builder.detectActivityLeak(new IActivityLeakListener() {
       @Override
       public void onActivityLeaked(Activity activity) {
           //activity泄露的回调
      }
   });
   ApmInsight.getInstance().start(builder.build());
   

3. 在app module的build.gradle文件最外层，添加以下代码，完成插桩。
   启动分析和页面体验相关功能依赖插件插桩，需配置ApmPlugin的whiteList为自己的包名，配置后该目录下的代码会被插桩。

   ApmPlugin {// 是否进行插桩
       enable true// 是否在Debug包插桩，默认不插桩
       enableInDebug true// DEBUG("DEBUG"), INFO("INFO"), WARN("WARN"), ERROR("ERROR");// DEBUG 级别Log会汇总所有被插桩处理的类供查看，路径 app/build/ByteX/ApmPlugin/ApmPlugin_log.txt
       logLevel "DEBUG"// 启动分析开关：监控App启动耗时，需要同时开启pageLoadSwitch
       startSwitch = true// 页面响应开关：监控Activity的生命周期耗时
       pageLoadSwitch = true// 网络监控开关：监控okhttp3的网络请求
       okHttp3Switch = true//插桩显示HttpUrlConnection的网络请求开关
       httpUrlConnectionSwitch = true// 白名单下的包进行插桩，需要填写要插桩类所在的包名，支持前缀配置
       whiteList = ["com"
       ]// 黑名单包下类不进行插桩，可以配置包名和类名，没有可以填空
       blackList = ["com.xxx"
       ]
   }
   

步骤三：完成SDK上报配置

端上开启泄漏检测和泄漏兜底处理开关后，平台也可以控制泄漏检测和泄漏兜底处理，泄漏兜底处理依赖泄漏检测。详细操作步骤，请参见SDK上报配置。

1. 登录应用性能监控全链路版控制台。
2. 单击目标应用下的App端监控。
3. 在控制台左上角选择全部功能 > SDK上报配置。
4. 在筛选区域单击Android系统。
5. 在各模块采样率配置页签下，单击内存优化。
6. 在内存优化配置页面，打开总开关。
   总开关打开会根据采样配置上报数据，关闭则整个模块不会上报数据。
   
7. 选择配置项为内存泄漏检测采样率，然后单击创建配置，修改采样率。
8. 选择配置项为内存泄漏兜底采样率，然后单击创建配置，修改采样率。
   
   • 内存泄漏检测采样率 ：控制内存泄漏兜底方案是否开启泄露检测
   • 内存泄露兜底采样率：控制内存泄漏兜底方案是否进行泄露兜底

   说明

   请谨慎开启内存泄露兜底采样率，并逐渐增加采样率。兜底操作会把view的背景图置空，防止有不当逻辑在Activity onDestroy后依然有操作view背景图产生异常。

步骤四：配置泄漏事件

端上检测到泄露事件后，如果判断平台配置了泄露事件上报，会把泄露的Activity名称上报到平台，这样平台就可以查看哪个页面泄露的次数较多。但因为泄露引用链需要dump内存才能解析出来，性能影响较大，这里并不不会dump内存快照解析泄露引用链，只是作为泄露的监控指标。具体泄露引用链可以通过接入OOM崩溃时候dump内存解析出泄露排查问题。

1. 在控制台左上角选择全部功能 > 事件管理。

2. 在筛选区域单击Android系统，然后单击新增事件。

3. 在新建事件页面，完成以下配置，然后单击创建。
   
   配置项说明：

   配置区域	配置项	说明	示例
   事件信息	事件名称	自定义名称，用于标识该事件。不能与已有事件名重复。	apmplus_activity_leak_monitor
   	事件描述	输入事件描述。	无
   	系统	选择系统，支持选择Android和iOS。	Android
   	标签	选择标签。便于查找该事件。	无
   指标/维度信息	名称	输入指标或者维度的名称。	leak_activity
   	类型	选择类型，支持选择指标和维度。 维度：如果您只想查看自定义数据的上报量，选择自定义维度 指标：您想查看自定义数据的上报量、平均值和PCT值，选择自定义指标	维度
   	描述	输入对指标或者维度的描述。	无
   上报配置	规则名称	自定义规则名称，用于标识该规则。	全量采集
   	采样率	配置采样率。 事件上报量与收费相关，采样率应根据业务量大小合理配置。	100%
   	规则条件	配置规则，当满足该规则时上报事件。	无

步骤五：查看泄漏事件

1. 在控制台左上角选择全部功能 > 事件趋势。
2. 在筛选区域单击Android系统，以及其他业务相关的筛选项。
3. 在左侧上报量页签中，单击泄漏事件名称apmplus_activity_leak_monitor，选择维度leak_activity，然后在维度列表中单击维度名称leak_activity。
4. 在详情页面查看leak_activity指标泄漏详情。
   

原理说明

如果Android客户端实现的需求有不当的代码实现，就会导致Activity泄漏。Activity的泄漏会牵连一系列的对象，特别是各种View和他们的背景图Bitmap会占据大量的内存，是内存泄漏非常重要的占比。泄漏分析支持检测上报Activity泄露情况，还可以兜底Activity泄露导致的内存泄露，即断掉View对图片的引用，减少泄露内存。

基本概念