flutter .gradle的坑

每次用更新或者遇到gradle的问题都会很上头,这次将本次安装gradle遇到的坑总结一下。此文章适合gradle配置出错的小白看,之前开发边上有安卓大神所以没在意这个问题。于是在配置好以后总结了一下几点:

用MacOS15系统
1.开局先研究大神提供的大牛的著作
🔧Flutter 3.24.x项目AGP环境升级,支持Android 15(API 级别 35)
https://juejin.cn/post/7522824239830532132

2.如果遇到gradle下载很慢,甚至下载不下来,或者下载下来每次打包都很慢。
方式一:可以先设置android文件下的gradle/warpper底下的gradle-warpper.properties文件
先将#distributionUrl改为国内阿里云的
https://mirrors.aliyun.com/macports/distfiles/gradle/gradle-8.7-all.zip
gradle-8.7-all.zip可换为https://mirrors.aliyun.com/macports/distfiles/gradle/底下的任何你想要的包,但是需要适配你的flutter版本。
过段时间这个gradle包就下载完成,并且会在你的根目录下有

截屏2025-08-23 11.27.02.png

但是这个打包超级慢,每次都2000s,4000s一等就是半个小时一个小时这样子。
此时可以将#distributionUrl=https://mirrors.aliyun.com/macports/distfiles/gradle/gradle-8.7-all.zip
代码注释,并且用到最原始的路径distributionUrl=https://services.gradle.org/distributions/gradle-8.7-all.zip
由于网络问题,我的这个根本下载不下来,但是可以生成一个文件
截屏2025-08-23 11.30.26.png

类似这种gradle-8.13-bin.zip.part,意味着没下载完成,就我的网也不会下载成功的。
此时就可以将之前用阿里云https://mirrors.aliyun.com/macports/distfiles/gradle/gradle-8.7-all.zip下载的文件夹1t9c3jolv5idz7jyxqfpggmqs里面的东西复制到https://services.gradle.org/distributions/gradle-8.7-all.zip生成的(不是空文件,如上图看的gradle-8.13-bin.zip.part没下载完全的包)aan3ydargesu18aqyqjwhr3pc文件夹内
这里注意1t9c3jolv5idz7jyxqfpggmqs和aan3ydargesu18aqyqjwhr3pc的文件夹是系统生成的每次都不一样,不要乱改文件名称。复制完成后1t9c3jolv5idz7jyxqfpggmqs和aan3ydargesu18aqyqjwhr3pc里的文件是一模一样的。
方式二:(这个方式也可以直接从网页下载想要的gradle 对应的zip包,不要解压,我的电脑是macos15默认会解压,需要从safari设置-》通用-》下载后打开安全文件取消勾选,你会得到一个zip包,将这个包放入distributionUrl=https://services.gradle.org/distributions/gradle-8.7-all.zip
生成的aan3ydargesu18aqyqjwhr3pc文件夹然后关闭文件夹,开始运行项目,就会自动生成所需要的文件)
这两种方式都很简单粗暴,我用的方式一自己按照原理想的办法,方式二是网友提供推荐的方式,没试过,但是方式二的下载速度要快很多,一分钟就能下载下来,我的方式一也是用了几十分钟下载的。
总结:不知道为什么切换到distributionUrl=https://services.gradle.org/distributions/gradle-8.7-all.zip
就打包很快distributionUrl=https://mirrors.aliyun.com/macports/distfiles/gradle/gradle-8.7-all.zip 就打包超级慢,大神可以指正说一下缘由。
android文件下的gradle/warpper底下的gradle-warpper.properties文件完整代码

distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists
#distributionUrl=https\://mirrors.aliyun.com/macports/distfiles/gradle/gradle-8.7-all.zip
distributionUrl=https\://services.gradle.org/distributions/gradle-8.7-all.zip

3.每次都需要下载gradle问题
我遇到的原因纯属自己将.gradle文件移到了其他文件目录底下导致的,我认为在Android studio中设置了.gradle 修改后路径就可以,但是上边的gradle-warpper.properties文件里的distributionBase=GRADLE_USER_HOME指的就是下载了根目录,当你修改了.gradle的路径后,它还是默认去根目录找文件,找不到就重新下载。我的建议是,就放了根目录不要修改文件目录。

4.
微信图片_20250823120650_865.jpg

这个问题需要加上
   maven {
            url 'https://storage.flutter-io.cn/download.flutter.io'
        }

5.电脑设置DNS有的也可能屏蔽Android studio的设置。如果发现无法设置
截屏2025-08-23 12.12.15.png

可能需要修改一下你的网络的dns,或者切换。我的这个set页面就没法勾选,只显示安装的SDK,不能选择。将DNS修改后就可以正常显示了。

暂时写到这里。这次更新gradle学到了很多知识,有用的知识又又又进入了我的脑子。愿大家gradle升级安装没有烦恼。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

推荐阅读更多精彩内容