3. Android项目集成LeakCanary SDK

LeakCanary 的 SDK 集成是构建自动化内存泄漏检测的基础。本章从依赖配置、Application 初始化、运行模式区分三个维度完整展示接入步骤，确保 CI 流水线在 debug 构建时自动激活检测，release 构建时完全剥离。

3.1 依赖配置（build.gradle）

在模块级 build.gradle 的 dependencies 块中添加 LeakCanary 依赖。推荐使用 2.12+ 版本，该版本默认启用 ObjectWatcher 并内置 Android 10+ 支持。

dependencies {
    // LeakCanary 核心库
    debugImplementation 'com.squareup.leakcanary:leakcanary-android:2.12'
    
    // 可选：在 release 构建中禁用（非必须，上一步已通过 debugImplementation 自动隔离）
    // 如果需要自定义 release 行为，可添加以下配置：
    releaseImplementation 'com.squareup.leakcanary:leakcanary-android-no-op:2.12'
}

3.2 Application 初始化

1. 创建自定义 Application 类（例如 App 继承自 Application）。
2. 在 onCreate() 中调用 LeakCanary.install(this)。
3. 在 AndroidManifest.xml 的 <application> 标签中注册该类。

Application 代码示例：

public class App extends Application {
    @Override
    public void onCreate() {
        super.onCreate();
        // LeakCanary 初始化（仅 debug 构建有效）
        LeakCanary.install(this);
        // 其他初始化（如 Firebase、Analytics）放在后面
    }
}

AndroidManifest 注册：

<application
    android:name=".App"
    android:icon="@mipmap/ic_launcher"
    android:label="@string/app_name"
    ... >

3.3 debug/release 模式区分

LeakCanary 官方推荐使用 debugImplementation + releaseImplementation 的组合实现模式区分。Gradle 构建系统会自动根据当前变体选择正确的依赖。

验证方式：编译不同变体后检查 APK 中类是否存在。

// debug 构建包含：
com.squareup.leakcanary.internal.HeapDumperImpl

// release 构建仅包含 no-op 桩类：
com.squareup.leakcanary.internal.HeapDumperImpl (不存在)
com.squareup.leakcanary.NoOpApplication

若需要使用 BuildConfig.DEBUG 进行运行时分支（不推荐，但部分场景需兼容），可参考以下模版：

if (BuildConfig.DEBUG) {
    LeakCanary.install(this);
} else {
    // release 下不执行任何操作
}

3.4 集成流程图

下图展示了 LeakCanary SDK 集成的完整决策与执行流程：

3.5 集成后的验证步骤

1. 编译 debug 变体：执行 ./gradlew assembleDebug，安装 APK 后首次启动应弹出 LeakCanary 通知（通知栏显示“LeakCanary is monitoring”）。
2. 编译 release 变体：执行 ./gradlew assembleRelease，安装后不应出现任何 LeakCanary 相关进程或通知。
3. 检查 APK 文件：使用 apktool d app-debug.apk 对比，release 包中不存在 leakcanary 相关类文件。

3.6 常见错误与解决方案