Flutter 3.32.7+版本下创建使用build.gradle文件的Android项目及相关创建异常问题咨询

最近不少开发者在Flutter 3.32.7及更高版本创建Android项目时，都碰到了几个棘手的问题，我结合大家的反馈和实践经验，整理了问题说明和解决思路：

常见异常情况 #

• 在Android Studio中创建项目时，明明选择了生成*.java文件，却出现创建失败的情况；或者想要生成传统的.gradle配置文件，结果生成的全是.gradle.kts*文件
• 即便是使用flutter create命令手动创建项目，同样会默认生成*.gradle.kts文件，无法直接得到.gradle*文件

针对性解决方法 #

方法一：创建项目时直接指定参数（推荐）

如果你一开始就想生成使用Java语言和Groovy版*.gradle*配置的项目，可以在flutter create命令中加上明确的参数：

flutter create --android-language java --android-build-config groovy your_project_name

• --android-language java：指定Android端的开发语言为Java
• --android-build-config groovy：强制使用Groovy语法的*.gradle配置文件，而非Kotlin DSL的.gradle.kts*

方法二：将已生成的KTS项目转为Groovy配置

如果已经创建了使用*.gradle.kts的项目，想要转换成.gradle*，可以按以下步骤操作：

1. 重命名配置文件：将android/app/build.gradle.kts改为android/app/build.gradle，将android/build.gradle.kts改为android/build.gradle
2. 转换语法：把文件内的Kotlin DSL语法改成Groovy语法（比如KTS中变量用val/var定义，Groovy直接写变量名；KTS的依赖声明implementation("xxx")在Groovy中写成implementation 'xxx'）
3. 同步配置：检查settings.gradle.kts中的项目引用，确保路径对应无误（一般include(":app")这类无需修改）
4. 清理重建：执行flutter clean，然后flutter pub get，最后重新构建项目即可

方法三：检查Android Studio插件配置

打开Android Studio的设置（File -> Settings），导航到Languages & Frameworks -> Flutter -> Android Settings，查看是否有默认构建配置的选项，确认是否将构建配置设置为Groovy而非Kotlin DSL（不同版本的插件选项位置可能略有差异）

额外注意事项 #

• Flutter 3.32+版本默认优先使用Kotlin DSL（.gradle.kts）和Kotlin作为Android开发语言，所以不指定参数的话会生成默认配置
• 如果选择Java语言但创建失败，大概率是本地环境问题：比如Java版本不兼容（推荐使用Java 17，符合Flutter当前版本的要求），或者Android SDK的Build Tools、Platform Tools组件缺失，建议更新SDK组件后再尝试

内容来源于stack exchange