Android库模块仅在Debug构建中引入Stetho的技术实现咨询

这个问题其实很常见，我来给你拆解一下完整的解决方案：

一、正确配置依赖 #

首先你提到的依赖配置是对的，一定要用debugImplementation而不是implementation，这样只有Debug构建会引入Stetho相关依赖，Release构建完全不会包含：

debugImplementation 'com.facebook.stetho:stetho:1.4.1'
debugImplementation 'com.uphyca:stetho_realm:2.0.0'

二、解决Release编译的代码问题 #

关键在于让Release构建时完全不接触Stetho相关的代码，这里有两种简单可靠的方式：

1. 用BuildConfig.DEBUG做条件判断 #

Android构建系统会自动生成BuildConfig类，其中的DEBUG常量在Debug构建时为true，Release构建时为false。我们可以用这个常量来包裹Stetho的代码逻辑：

Kotlin示例：

val okHttpClientBuilder = OkHttpClient.Builder()

// 仅在Debug模式下添加Stetho拦截器
if (BuildConfig.DEBUG) {
    okHttpClientBuilder.addNetworkInterceptor(StethoInterceptor())
}

val okHttpClient = okHttpClientBuilder.build()

Java示例：

OkHttpClient.Builder okHttpClientBuilder = new OkHttpClient.Builder();

// 仅在Debug模式下添加Stetho拦截器
if (BuildConfig.DEBUG) {
    okHttpClientBuilder.addNetworkInterceptor(new StethoInterceptor());
}

OkHttpClient okHttpClient = okHttpClientBuilder.build();

这种方式的好处是简单直接，而且Release构建时，编译器会把if (false)里的代码当成死代码优化掉，完全不会尝试加载Stetho的类，自然不会出现编译错误。

2. 用抽象接口隔离（适合大型项目） #

如果你的项目架构比较复杂，也可以通过抽象接口来隔离Debug和Release的实现：

• 定义一个NetworkInterceptorProvider接口，提供获取拦截器的方法
• 在Debug源码目录（src/debug/java/）下实现该接口，返回StethoInterceptor
• 在Release源码目录（src/release/java/）下实现该接口，返回空列表或者null
• 业务代码中只依赖这个接口，不直接引用Stetho类

这种方式耦合度更低，适合需要扩展更多Debug工具的场景。

额外注意事项 #

• 确保不要在Release构建的代码中直接引用Stetho的任何类，哪怕是在注释里也尽量避免（有些编译器会扫描注释里的类名）
• 如果使用ProGuard，不需要额外配置Stetho的规则，因为Release构建根本没有这些依赖

内容的提问来源于stack exchange，提问作者lannyf