【亲测免费】 LeakCanary 教程：安装与使用指南

1. 项目目录结构及介绍

LeakCanary 的源码仓库包含了多个关键的子模块：

• leakcanary-android：这是核心库，提供了针对 Android 平台的内存泄漏检测功能。
• shark: 分析器组件，用于解析内存快照并识别泄漏。
• samples/leakcanary-android-sample: 示例应用，展示了如何集成和使用 LeakCanary。
• docs: 项目文档，包括 Markdown 文件和网站构建相关的内容。
• build.gradle, settings.gradle 等：Gradle 构建文件，管理项目的依赖和构建设置。

目录结构大致如下：

.
├── leakcanary
│   ├── build.gradle
│   └── src
│       ├── main
│       └── test
├── shark
│   ├── build.gradle
│   └── src
│       ├── main
│       └── test
├── samples
│   └── leakcanary-android-sample
│       ├── build.gradle
│       └── src
├── docs
│   ├── mkdocs.yml
│   └── ...
└── ...

2. 项目启动文件介绍

在 LeakCanary 中，没有典型的“启动文件”，因为它作为一个库被集成到其他 Android 应用程序中。然而，对于应用程序开发者来说，启动使用 LeakCanary 的过程通常涉及到以下几个关键步骤：

• 添加依赖：在应用的 build.gradle 文件的 debugImplementation 部分添加 LeakCanary 的依赖。

  debugImplementation 'com.squareup.leakcanary:leakcanary-android:2.x.y'
  

• 初始化：在你的 Application 类中，不需要像早期版本那样手动调用 LeakCanary.install(this)。现在的版本会自动注册监控。

3. 项目的配置文件介绍

《build.gradle》文件

build.gradle 文件主要用于定义项目依赖，构建变量以及编译选项。例如，在应用的主 build.gradle 文件中，可以找到添加 LeakCanary 依赖的条目。在项目的顶级 build.gradle（settings.gradle）文件中，可能还包括定义项目模块和它们之间的关系。

在 leakcanary-android 或 shark 模块的 build.gradle 文件中，可以找到关于库的编译和打包规则，以及第三方库的依赖声明。

配置项举例

• 设置最低 SDK 版本：

  android {
      defaultConfig {
          minSdkVersion 16
          targetSdkVersion 30
          ...
      }
  }
  

• 控制日志级别：

  debugImplementation('com.squareup.leakcanary:leakcanary-android:2.x.y') {
      exclude group: 'com.squareup.okhttp3', module: 'logging-interceptor'
  }
  

• 自定义分析结果处理：

  LeakCanary.config = LeakCanary.config.copy(
      displayLeaksStrategy = DisplayLeakStrategy.SILENT,
      analysisCompletedStrategy = AnalysisCompletedStrategy.INHIBIT_ANALYSIS
  )
  

请注意，实际配置可能会根据项目的具体需求进行调整。完成上述步骤之后，只需运行调试构建，LeakCanary 就会在适当的时间检测并报告潜在的内存泄漏。