填坑！小白使用flutter开发安卓应用的必经之坑！gradle编译，让项目run起来（2024.12.20）

提示：文章写完后，目录可以自动生成，如何生成可参考右边的帮助文档

---

前言

小白使用flutter框架进行安卓开发坑真是太多了，新初始化的项目都没法跑起来，在gradle编译过程中的各种问题很容易劝退小白。尤其随着Android Studio、Flutter框架的更新，很多教程都过时了，教程很多关键性细节都讲不到，一更新开发环境很容易出问题！尤其小白没有师傅带的情况下，自己摸索太难了。
作为一个安卓开发小白，经过三天的摸索和学习，终于让flutter项目跑起来了。难者不会，会者不难，懂的人可能觉得这么简单的事还用问，但对独立学习的小白来说如鸿沟天堑！今天特留文记录，以助后来者。2024.12.20

一、准备工作

1.开发软件包选择

目前（2024年12月20日）对于flutter开发工具我建议目前使用以下软件包：

红框框起来的是我目前在WIN10系统开发安卓使用的三个包，选择的原因如下：
1、AS包这个版本是最新的，支持API35即Android 15系统（目前市面上最新的系统版本）。这个版本内置的java运行时为23.0.3，android-studio2024.1.12内置的还是17.0.13。
2、flutter安装包使用的是3.24.5,前几天flutter最新版升级到3.27了，flutte版本升级太快，我们没必要使用最新的，最新很多flutter插件兼容都没做。国内gradle镜像源最新版本都是gradle8.9，所以我们选择flutter3.24.5和gradle8.9配合。
3、JDK17，因为现在flutter3.24.5编译已支持java17，对于使用java8(也叫java1_8，后来版本命名规则变了）、java11的老项目可以自行下载。新项目直接使用java17即可。
4、因为我使用cursor辅助开发，所以我还下载了cursor。cursor使用VScode集成了AI，所以大家也可以自行下载VScode最新版。Android
Studio运行实在太卡，建议选择VScode这种轻量级编程工具。

2.软件包下载

我这里提供一个我搜集和补充软件的下载链接，大家可从我的百度网盘下载。

通过网盘分享的文件：04 环境搭建相关软件-也可通过教程提供地址下载
链接: https://pan.baidu.com/s/1At1qUHK5NGIf2wopva-0QA?pwd=1234 提取码: 1234
–来自百度网盘超级会员v5的分享

没有百度网盘的朋友可能下载很慢，大家也可以到官网下载，很多官网下载的速度很快，但是要认准版本。
下面是几个其他必要的开发软件，官网下载很快，我就没有上传网盘。

VScode官网https://code.visualstudio.com/，下载最新版即可。
Cursor官网https://www.cursor.com/，下载最新版即可。
Gradle下载，这里咱们使用阿里云镜像https://mirrors.aliyun.com/macports/distfiles/gradle/，下载gradle-8.9-all.zip。

二、flutter环境搭建

1.参考视频进行安装

我安装的是java17,大家注意。当然大家可以安装多个java,只要配置环境变量时注意javahome及时切换就行。
大家视频看到新建flutter项目后，其他的操作就可以不看了，后面我来带大家做后续的调整，很多教程在这里就不太对了,很多细节不讲，挖了不少坑，自学者很容易踩。

17 Flutter介绍-Flutter Windows Android环境搭建 真机调试

视频链接：https://www.bilibili.com/video/BV1S4411E7LY?spm_id_from=333.788.videopod.episodes&vd_source=360fa63253b559e6c34f907c9df2766b&p=17

2.gradle编译知识

推荐两篇其他大佬的相关文章，帮助大家建立基本的gradle知识。第一篇详细介绍了安卓开发中gradle目录结构，必须要看。

第一篇：https://blog.youkuaiyun.com/A1_3_9_7/article/details/143989068Android Studio下载及安装和Gradle的配置（非常详细）从零基础入门到精通，看完这一篇就够了

第二篇：https://blog.youkuaiyun.com/mba16c35/article/details/137080646Android 开发中 Gradle 使用详解：构建、配置与优化技巧

三、配置运行项目（填其它教程的坑）

现在大家基本完成了软件安装、SDK下载和环境变量设置。接下来我们一步步新建和运行项目。

1.android studio中新建flutter项目

**选择和填写项目名称（使用小写和下划线命名）、项目保存位置、安卓开发语言、应用计划要运行的平台。**在弹出的选择窗口中，选择this window即可。

新建flutter项目后我们会进入到项目目录，我们在选择下面android目录打开，如下图：

2.重要！配置文件修改

1、修改gradle-wraooer.properties文件

将distributionUrl更换为国内源，版本为gradle-8.9-all.zip。可复制下面这段替换distributionUrl=https://mirrors.aliyun.com/macports/distfiles/gradle/gradle-8.9-all.zip，减少gradle的下载时间。也可以修改AS中gradle配置项使URL这项失效，直接使用本地安装的gradle.只要保证版本匹配即可。

2、修改settings.gradle

将settings.gradle插件修改为如下：

plugins {
    id "dev.flutter.flutter-plugin-loader" version "1.0.0"
    id "com.android.application" version "8.7.2" apply false
    id "org.jetbrains.kotlin.android" version "2.0.21" apply false
}

如果需要使用国内maven源的，可以在settings.gradle和项目级build.gradle中增加repositories配置。担心国内源不全，我第一次尝试的时候没添加，后来添加上感觉也没有从国内源下载，可能我配置有问题，这里就留给朋友自己探索吧。社区中这个教程很多。

3、修改模块级build.gradle

这里可以将andropd配置修改为，编译的安卓SDK为35，最小安卓SDK为21，目标SDK为35，编译的配置都改为java17。

android {
    namespace = "com.example.ceshi"
    compileSdk = 35
    ndkVersion = flutter.ndkVersion

    compileOptions {
        sourceCompatibility = JavaVersion.VERSION_17
        targetCompatibility = JavaVersion.VERSION_17
    }

    kotlinOptions {
        jvmTarget = JavaVersion.VERSION_17
    }

    defaultConfig {
        // TODO: Specify your own unique Application ID (https://developer.android.com/studio/build/application-id.html).
        applicationId = "com.example.ceshi"
        // You can update the following values to match your application needs.
        // For more information, see: https://flutter.dev/to/review-gradle-config.
        minSdk = 21
        targetSdk = 35
        versionCode = flutter.versionCode
        versionName = flutter.versionName
    }

4、修改项目结构中配置

在flutter完整项目目录下，我们可以看到项目结构选项：



通过AS中的项目结构我们可以看到，项目的SDK尚未选择，我们可以选择API35或者API34。平台设置中的SDKs我们选择本机安装的java17,如果没有本机的java17可以点+添加。

5、进入项目中的android目录加载项目gradle

打开我们项目中的android目录，这时会开始检查和同步项目文件信息，第一次运行的话可能需要很长时间下载文件。

文件下载完成之后我们再点击同步按钮，再检查下是否有错误。有错误的话就搜索解决下，如果按照本教程应该不会出错。

6、编译运行项目

启动我们之前创建的AVD，这里我们使用了API35,也就是android15的虚拟机。点击图片顶部的app右侧的绿色三角开始run起来吧。
开发环境开始编译和向安卓虚拟机安装App。

到这里我们的新建flutter项目终于在Android Studio中跑起来了！

7、VScode中运行

我们日常编写可能更习惯使用VScode，打开vscoe或者cursor。VScode中的flutter插件不要忘记安装。
打开VScode中的文件-首选项-配置文件，就可以进入下图，点击设置，进入settings.json文件，将java runtimes中的java17部分添加"default": true，其他java版本下的"default": true要删掉。

我们在打开安卓虚拟机，开始运行项目。点击界面右下角的devices,打开API35虚拟机。

在终端界面输入flutter run命令，VScode中项目又运行起来了！

总结

本教程将flutter项目中的配置项进行了详细的介绍，填补了很多教程中不透露或不愿透漏的细节，保证了小白能够顺利跑出自己的第一个flutter项目。
本项目使用了flutter3.24.5、Android Studio 2024.2.1、JDK 17.0.2、Gradle-8.9-all.zip、AGP(android gradle plugin)8.7.2、Kotlin插件2.0.21,顺利运行flutter项目到安卓15模拟器中。
如遇错误，欢迎交流，QQ1014983533。记录时间2024年12月20日。