flutter如何配置gradle-wrapper.properties

我在Flutter项目中发现gradle-wrapper.properties文件配置有问题，具体是在distributionUrl这一行。请问应该如何正确配置这个文件？目前遇到的问题是Gradle版本不兼容导致构建失败，能否提供标准的配置示例？另外，这个配置是否会影响Android端的打包？

2 回复

在Flutter项目中配置gradle-wrapper.properties，主要修改两个地方：

  1. 找到文件： android/gradle/wrapper/gradle-wrapper.properties

  2. 修改内容：

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

常用配置项：

  • distributionUrl：指定Gradle版本（推荐7.5+）
  • distributionBase：缓存目录类型（一般用GRADLE_USER_HOME）
  • zipStoreBase：zip存储目录类型

注意事项：

  • 版本号要与Android Gradle插件版本兼容
  • 修改后需要执行flutter clean
  • 国内网络可考虑使用镜像地址

如果遇到网络问题，可以把services.gradle.org替换为国内镜像地址。

更多关于flutter如何配置gradle-wrapper.properties的实战系列教程也可以访问 https://www.itying.com/category-92-b0.html


在 Flutter 项目中配置 gradle-wrapper.properties 主要用于指定 Gradle 版本，以解决构建问题或兼容性。以下是步骤和注意事项：

1. 文件位置

  • Android 项目路径：android/gradle/wrapper/gradle-wrapper.properties
  • 修改前建议备份原文件。

2. 配置内容示例

打开文件并修改 distributionUrl，例如使用 Gradle 7.5：

distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
distributionUrl=https\://services.gradle.org/distributions/gradle-7.5-all.zip
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists

3. 同步更改

  • 终端运行 flutter clean 清除缓存。
  • 执行 flutter pub get 或 Android Studio 的 “Sync Project with Gradle Files”。

4. 常见问题

  • 版本冲突：确保 Flutter 插件支持的 Gradle 版本（检查 android/build.gradle 中的 dependencies）。
  • 网络问题：若下载失败，可手动下载 Gradle 并配置本地路径。

通过调整版本，可解决构建错误或提升性能。如有依赖问题，需同步更新 android/build.gradle 中的 Gradle 插件版本。

回到顶部