Android项目中如何通过Gradle修改FirebaseAuth库文件无需克隆整库？

你之前尝试的覆写类无效，是因为FirebaseAuth的核心实例是通过内部工厂方法创建的，自定义子类无法替换框架内部实际使用的原类实例。针对你不想克隆维护整个库、只想修改单个文件的需求，Android这边有几个和iOS CocoaPods本地替换等价的Gradle方案，亲测可行：

方案1：本地源码覆盖（最简便，适合修改公开类） #

这是最直接的方案，利用Gradle编译时的类加载优先级，用本地源码替换依赖库中的同名类：

• 保留原有FirebaseAuth的依赖声明，比如：

  implementation 'com.google.firebase:firebase-auth:22.3.1'
  

• 在你的项目src/main/java下创建与目标类完全一致的包路径，比如要修改com.google.firebase.auth.FirebaseAuth，就建src/main/java/com/google/firebase/auth目录
• 从FirebaseAuth的开源仓库中复制该类的完整源码到这个目录，修改你需要调整的逻辑
• 编译项目即可：Gradle会优先使用本地目录下的类，自动覆盖依赖库中的同名类

注意：即使目标类是final修饰的，这个方法依然有效（因为是直接替换类文件而非继承）；如果类中有私有依赖的内部类，可能需要同时复制相关内部类，但大部分场景下单个文件修改足够。

方案2：字节码补丁（适合修改私有方法/不想暴露源码） #

如果要修改的是私有方法、final方法，或者不想把完整源码放到项目里，可以用Gradle字节码补丁插件：

• 在项目根目录的build.gradle中引入插件：

  plugins {
      id 'java-patch' version '1.2.0' apply false
  }
  

• 在app模块的build.gradle中应用插件，并配置补丁规则：

  apply plugin: 'java-patch'
  
  patch {
      // 找到FirebaseAuth的依赖jar包
      def authJar = configurations.implementation.find { it.name.contains('firebase-auth') }
      patches {
          firebaseAuthPatch {
              // 你的补丁类路径，只需要写要修改的方法
              source file('src/main/patches/FirebaseAuthPatch.java')
              targetJar authJar
              // 要修改的目标类全限定名
              className 'com.google.firebase.auth.FirebaseAuth'
          }
      }
  }
  

• 编写补丁类，只包含要修改的方法逻辑，插件会自动替换原jar中的对应方法字节码

方案3：本地模块部分替换（适合修改少量关联文件） #

如果需要修改的文件有少量关联，可以把这些文件抽成一个本地模块，让项目优先依赖：

• 创建一个新的Android Library模块（比如叫firebase-auth-patch）
• 在该模块中创建对应包路径，放入修改后的类
• 在app模块的依赖中，先声明本地模块，再声明官方FirebaseAuth依赖：

  implementation project(':firebase-auth-patch')
  implementation 'com.google.firebase:firebase-auth:22.3.1'
  

• Gradle会优先加载本地模块中的类，其余类仍使用官方库的版本

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