使用jenkins构建Android+Flutter项目依赖自动升级带来兼容性问题及Jenkins构建速度慢问题解决

使用jenkins构建Android+Flutter项目依赖自动升级兼容性问题及Jenkins构建速度慢问题解决

问题1 flutter下载依赖自动升级导致兼容性问题

有个Android项目使用了flutter技术，按照常规执行flutter clean && flutter pub get以后，开发在pubsepec.yaml文件定义了shared_preferences版本为^2.1.1, 并且开发上传的pubspec.lock中shared_preferences为2.1.1，shared_preferences_android版本为2.1.4, 但是jenkins下载完代码，编译后，发现pubspec.lock中shared_preferences的版本为2.5.2，并且shared_preferences_android变成了2.4.5，其结果导致编译后报错，引入了一个兼容性的错误： "A problem occurred configuring project ':shared_preferences_android'. > Failed to notify project evaluation listener. "

通过查找资料，发现是flutter clean后导致了pubspec.lock文件发生了变化，flutter根据pubsepec.yaml文件定义了shared_preferences版本为^2.1.1，自动将shared_preferences依赖更新到2.5.2，shared_preferences_android更新到了2.4.5.

具体原理：

在Flutter项目中，pubspec.yaml中定义的依赖版本使用^符号表示允许在兼容范围内自动升级，而pubspec.lock会记录实际下载的具体版本。当执行flutter clean和flutter pub get时，依赖版本可能发生变化，具体原因如下：

版本符号^的作用

shared_preferences: ^2.1.1表示允许使用2.1.1到3.0.0之间的最新兼容版本（如2.5.2）。如果服务器上的包版本更新，执行flutter pub get会拉取符合约束的最新版本，导致pubspec.lock中记录的版本升级。

Jenkins构建时的依赖解析

Jenkins在编译时可能执行了flutter clean（清除缓存）和flutter pub get（重新解析依赖），这会根据pubspec.yaml中的^符号拉取最新的shared_preferences（如2.5.2），同时其子包shared_preferences_android也会升级到对应的版本（如2.4.5）。

未提交或忽略pubspec.lock文件

如果pubspec.lock未被提交到版本控制（如.gitignore中包含该文件），Jenkins会基于pubspec.yaml重新生成pubspec.lock，而本地开发环境可能使用了旧的锁定版本。这会导致不同环境的依赖版本不一致。

解决方案：

固定版本：在pubspec.yaml中写死版本（如shared_preferences: 2.1.1），避免自动升级。

提交pubspec.lock：将pubspec.lock纳入版本控制，确保所有环境使用完全相同的依赖版本。

避免flutter pub upgrade：仅使用flutter pub get，除非明确需要升级依赖。

依赖自动升级问题解决方案

为保证项目的依赖纯净，执行了如下命令

bash 复制代码

flutter pub cache clean -f
flutter pub get

然后可以在log中看到，jenkins下载了开发指定的pubspec.lock文件中的全部依赖版本，部分日志如下：

bash 复制代码

  shared_preferences 2.1.1 (2.5.2 available)
  shared_preferences_android 2.1.4 (2.4.5 available)
  shared_preferences_foundation 2.5.2 (2.5.4 available)
  source_span 1.10.0 (1.10.1 available)
  sqflite 2.3.3+1 (2.4.2 available)

问题2 Jenkins执行flutter pub get速度相比直接命令行执行慢很多倍问题

通过查找deepseek，这个问题跟jenkins的环境有关，解决方案就是直接在jenkins shell中配置如下环境变量：

bash 复制代码

export PUB_HOSTED_URL=https://pub.flutter-io.cn
export FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn

问题3 jenkins调用gradle插件来编译flutter项目报错

问题原因现在没查清楚，将插件去掉，改为命令行调用gradlew直接构建打包：

bash 复制代码

cd app
chmod +x gradlew
./gradlew assemble${Env}Release

猜测gradle插件与flutter或者JDK的版本不匹配导致。