QualityMatters 源码集分离秘诀：main/debug/release 三套代码如何优雅共存

QualityMatters 是一个践行《Android Development Culture》的开源示例 App，它最大的特色之一就是用 Gradle 源码集（Source Set）分离机制，让main / debug / release 三套代码在同一个工程里优雅共存：调试工具只进 debug 包，线上包干净轻量。本文带你完整拆解这套源码集分离思路，新手也能直接抄作业。

为什么要把代码分成三套？🤔

很多新手习惯把所有代码堆在main里，用if (BuildConfig.DEBUG)到处打分支。代码一多，问题就来了：

• 调试工具污染 release 包：LeakCanary、Stetho 这类工具动辄数千个方法，全塞进线上包既增大体积，又可能撞上 dex 65536 方法数上限（QualityMatters 在 README 中明确提到，正式项目里 debug 包甚至被迫开启了 multidex）。
• release 代码里混着调试逻辑，既难读又危险。

QualityMatters 的答案是：主代码只依赖抽象，具体实现按构建类型各放一套。

三套源码集的目录结构长什么样？

打开 app/build.gradle，可以看到app/src下按构建类型组织出三套源码目录：

构建类型本身也在 app/build.gradle 中声明：debug 包加了applicationIdSuffix '.debug'，因此 debug 版和 release 版 App可以安装在同一台手机上并行运行，方便对照验证源码集分离是否生效。

优雅共存的核心套路：接口 + Dagger 注入

这是全文最值得学的部分。整个"魔法"由三步完成：

1️⃣ main 里只留"接口"，不认识任何调试库

main源码集里定义了三个小接口，对具体工具零感知：

• DeveloperSettingsModel.java —— 开发者设置面板
• LeakCanaryProxy.java —— 内存泄漏检测的代理
• DevMetricsProxy.java —— 性能指标采集的代理

LeakCanaryProxy的注释写得很直白："Tiny interface to hide LeakCanary from main source set"——接口存在的意义，就是把 LeakCanary 从 main 源码集里"藏起来"。

2️⃣ debug 里放真货

debug 源码集的同名模块 DeveloperSettingsModule.java 通过 Dagger 提供真实实现：

• DeveloperSettingsModelImpl：启动 Stetho、LeakCanary、TinyDancer、Lynx 等调试面板
• MainActivityViewModifier.java：给主页 Drawer 动态塞入"开发者设置"页
• OkHttpInterceptorsModule.java：注入 HTTP 日志拦截器和 Stetho 网络拦截器

3️⃣ release 里放 no-op 空壳

release 源码集用完全相同类名提供空实现，例如：

• DeveloperSettingsModule.java：provideDeveloperSettingsModel()直接返回一个什么都不做的 lambda
• NoOpLeakCanaryProxy.java、NoOpDevMetricsProxy.java
• NoOpAsyncJobsObserver.java：性能任务监听器在 release 中直接空跑
• OkHttpInterceptorsModule.java：拦截器列表一律返回空列表

💡关键设计：由于 debug/release 两套实现类名完全相同、Dagger 模块也同名，主代码QualityMattersApp里只需要if (BuildConfig.DEBUG)判断是否调用 QualityMattersApp.java 中的初始化入口，无需关心背后是哪套实现。release 编译时 debug 代码根本不会被打包，if分支里的调试库引用也自然消失。

依赖也分离：debugImplementation 的妙用

源码集分离不止于代码，依赖同样分构建类型注入。app/build.gradle 中：

• implementation：Retrofit、RxJava、Dagger 等所有包都要的核心库
• debugImplementation：Stetho、LeakCanary、TinyDancer、Lynx、Paperwork、ProcessPhoenix 等仅 debug 生效的调试库

所有版本号集中在根目录 dependencies.gradle 统一管理，配合 build.sh 一条命令跑完编译、Lint、测试、打包。依赖与代码双分离，让"调试库不进线上包"从口头约定变成编译期保证。

测试源码集也是同一套思路 🧪

三套主代码之外，QualityMatters 还为每个构建类型配了对应测试源码集，映射关系在 app/build.gradle 的sourceSets块中声明：

• src/unitTests —— 通用单元测试
• src/debugUnitTests —— 专门测 debug 特有代码（如 DeveloperSettingsModelImplTest.java）
• src/releaseUnitTests —— 专门测 release 的 no-op 实现（如 NoOpLeakCanaryProxyTest.java）
• src/integrationTests —— 集成测试
• src/functionalTests —— 基于 Espresso 的 UI 功能测试

总结：4 步在你的项目落地源码集分离 ✅

1. main 只写抽象：为调试能力定义最小接口（模型、代理），不 import 任何调试库
2. debug 放真实实现：同名 Dagger Module 提供 Stetho、LeakCanary 等真货
3. release 放 no-op：同名类返回空实现，保证主代码一行不改即可编译
4. 依赖用debugImplementation：让调试库在编译期就与 release 包绝缘

这套"接口 + 构建类型源码集 + no-op"的组合拳，正是 QualityMatters 给 Android 新手最实用的一课：源码集分离不是目录技巧，而是把"环境差异"从 if 分支升级为编译期隔离。项目完整背景可阅读 README.md 了解其测试体系与开发者设置的设计动机。