React Native Android构建可变依赖项及版本锁定方法咨询

一、Android构建中易变的依赖类型 #

• Gradle插件与Gradle核心版本：如果依赖声明用了+、latest.release这类通配符，会自动拉取最新版本，新版本可能和React Native或其他库存在兼容性冲突
• 第三方直接依赖：比如com.facebook.react:react-native如果指定的是0.7x.x这种范围版本，而非具体版本号，每次构建可能拉取同大版本下的最新小版本，引入未知问题
• 传递依赖：主依赖自带的子依赖，如果没有锁定版本，上游库更新后会同步替换这些子依赖，很容易引发依赖冲突
• SNAPSHOT快照依赖：带-SNAPSHOT后缀的依赖会每次构建拉取最新快照包，这类包本身就是未稳定的开发版本，变动性极大
• Android SDK组件：buildToolsVersion、compileSdkVersion如果未固定，或CI环境自动更新SDK组件，会导致构建环境不一致

二、锁定版本的具体实现方案 #

1. 替换动态版本为固定版本 #

把所有依赖中的通配符、范围版本直接改成具体版本号，彻底杜绝自动更新：

错误写法：
implementation 'com.android.tools.build:gradle:+'
implementation 'com.facebook.react:react-native:0.71.x'

正确写法：
implementation 'com.android.tools.build:gradle:7.4.2'
implementation 'com.facebook.react:react-native:0.71.8'

2. 启用Gradle官方依赖锁定 #

通过Gradle的依赖锁定功能，把所有直接/传递依赖的版本写入锁定文件，提交到版本控制后，构建会严格遵循锁定版本：

• 在项目根目录的settings.gradle中添加配置：

dependencyLocking {
    lockAllConfigurations()
}

• 执行命令生成锁定文件：

./gradlew dependencies --write-locks

• 后续如果需要更新某依赖，执行：

./gradlew dependencies --update-locks com.example:target-library

• 把生成的gradle.lockfile提交到Git，确保CI构建时读取这个文件。

3. 固定Gradle Wrapper版本 #

确保gradle/wrapper/gradle-wrapper.properties中的distributionUrl指向固定版本的Gradle包，同时把gradle-wrapper.jar和该文件一起提交到版本控制：

distributionUrl=https\://services.gradle.org/distributions/gradle-7.5-bin.zip

避免CI环境自动下载不同版本的Gradle核心。

4. 锁定Android SDK相关版本 #

在模块级build.gradle中显式指定固定的SDK版本参数，杜绝环境差异：

android {
    compileSdkVersion 33
    buildToolsVersion "33.0.2"
    defaultConfig {
        targetSdkVersion 33
        // 其他配置...
    }
}

同时在CI环境中关闭SDK自动更新，提前安装好固定版本的组件。

5. 手动管控传递依赖 #

如果某传递依赖频繁变动引发问题，直接排除该传递依赖，手动添加固定版本的依赖：

implementation('com.example:some-library:1.0.0') {
    exclude group: 'com.unstable.dep', module: 'unstable-module'
}
// 手动添加固定版本的依赖
implementation 'com.unstable.dep:unstable-module:2.0.1'

三、CI环境额外配置 #

• 禁用Android SDK自动更新，确保每次构建使用的SDK组件版本完全一致
• 配置Gradle依赖缓存，但注意当依赖锁定文件更新时，要清理对应缓存，避免使用旧依赖

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