Android Studio新建安卓项目如何设置自定义build.gradle模板

你修改模板不生效的核心原因有两个：一是你改的NewAndroidModule路径是新建模块的模板，不是新建项目的模板，且Android Studio Arctic Fox（2020.3.1）及以上高版本的模板逻辑、存放路径和旧版本有差异；二是新版Android Gradle插件默认把仓库repositories配置写在settings.gradle/settings.gradle.kts中，仅修改build.gradle模板不会生效。

具体操作步骤 #

• 找到对应场景的正确模板文件
  模板文件统一存放在Android Studio安装目录下的plugins/android/lib/templates/gradle-projects/路径下，不同配置对应不同文件：
  • 新建项目根目录build.gradle模板：对应NewAndroidProject/root/build.gradle.ftl（Groovy语法）、NewAndroidProject/root/build.gradle.kts.ftl（Kotlin DSL语法）
  • 新建模块build.gradle模板：对应你之前找到的NewAndroidModule/root/build.gradle.ftl
  • 全局仓库repositories配置：对应NewAndroidProject/root/settings.gradle.ftl（Groovy语法）、NewAndroidProject/root/settings.gradle.kts.ftl（Kotlin DSL语法），两个文件都要修改才能覆盖两种构建脚本的新建场景

  如果你是通过Toolbox安装的Android Studio，安装目录不在默认路径，需要到Toolbox的应用存放路径找对应版本：Windows下一般为C:\Users\<你的用户名>\AppData\Local\JetBrains\Toolbox\apps\AndroidStudio\ch-<版本标识字符串>\，Mac下一般为/Users/<你的用户名>/Applications/JetBrains Toolbox/Android Studio.app/

• 解决文件编辑权限问题
  Windows系统如果把Android Studio装在C:\Program Files目录，直接编辑保存ftl文件会因为权限不足失败，建议先把文件复制到桌面修改完成后，再粘贴回原路径替换，替换时同意管理员权限申请即可；Mac系统修改前先执行sudo chmod -R 777 /Applications/Android\ Studio.app/Contents/plugins/android/lib/templates/给模板目录开放读写权限。
• 清除缓存避免旧模板残留
  改完模板后不要直接新建项目，先关闭Android Studio，删除对应版本的缓存目录后再重启：
  • Windows：C:\Users\<你的用户名>\.AndroidStudio<对应版本号>\system\caches
  • Mac：~/Library/Caches/Google/AndroidStudio<对应版本号>
  • Linux：~/.cache/Google/AndroidStudio<对应版本号>
• 验证配置
  重启Android Studio后新建Empty Activity项目，检查对应build.gradle、settings.gradle文件，确认自定义的repositories等配置已经写入即可。

进阶配置（避免升级后配置丢失） #

如果不想每次升级Android Studio后都重新修改安装目录下的模板，可以把自定义修改后的模板文件夹放到Android Studio的用户配置模板目录，路径为：

• Windows：C:\Users\<你的用户名>\.AndroidStudio<对应版本号>\templates\
• Mac：~/Library/Application Support/Google/AndroidStudio<对应版本号>/templates/
• Linux：~/.config/Google/AndroidStudio<对应版本号>/templates/
  放在这个路径下的自定义模板优先级高于安装目录内置模板，升级Android Studio后只要把模板文件夹迁移到对应新版本的用户配置目录下即可，不会被安装包覆盖。

内容的提问来源于stack exchange，提问作者wgf4242