Android Studio Bumblebee 2021.1.1如何创建自定义项目模板

该版本完全支持创建New Project流程下的项目级自定义模板，此前检索到的方案失效核心原因是：从Android Studio Arctic Fox（2020.3）版本开始，官方将模板渲染引擎从旧版FreeMarker替换为基于Kotlin的Wizard模板体系，旧版方案逻辑完全不兼容；零散的模板修改教程大多只覆盖了「New > 新建组件/Activity」场景的模板，没有触达项目级模板的存放路径和配置逻辑。

具体实现步骤 #

• 第一步：定位模板存放目录
  先关闭正在运行的Android Studio，根据你的操作系统找到对应安装路径下的模板根目录：
  • Windows：<Android Studio安装盘符>/Program Files/Android/Android Studio/plugins/android/lib/templates/
  • Mac：/Applications/Android Studio.app/Contents/plugins/android/lib/templates/
  • Linux：<解压后的Android Studio目录>/plugins/android/lib/templates/
• 第二步：基于内置模板生成自定义模板基准
  进入模板根目录下的gradle-projects文件夹，这里存放的就是New Project入口展示的所有项目级模板，内置的Empty Activity、Basic Activity等模板都在该目录下。
  选择一个和你预期模板逻辑最接近的内置模板，完整复制整个文件夹，重命名为你的自定义模板名称，命名不要包含中文、空格和特殊字符。
• 第三步：修改模板配置和初始内容
  打开你复制出的自定义模板文件夹，按需修改对应配置：
  1. 修改根目录下的配置文件（Bumblebee版本同时兼容template.xml和template.yaml两种格式，你复制的内置模板用哪种就改哪种）：
     • 将id字段修改为全局唯一值，不要和内置模板id重复，例如com.yourdomain.custom.project
     • 将name字段修改为你要在新建项目列表中展示的模板名称
     • 将description字段修改为模板的功能说明
     • 将category字段设置为模板要展示的分类，例如填写Phone and Tablet就会出现在手机/平板分类下
  2. 修改项目生成逻辑：如果是旧格式模板编辑recipe.xml.ftl，如果是新Kotlin格式模板编辑recipe.kt，文件中定义了创建项目时的全流程操作，包括默认依赖配置、初始文件生成、build.gradle修改规则等，可以按需调整默认参数，比如预设最低SDK版本、默认开启ViewBinding、预置基础依赖等。
  3. 替换初始项目文件：模板文件夹下的root目录对应生成后新项目的根目录结构，你可以直接把预先写好的通用代码、配置文件、资源文件按对应路径放到root目录下，新建项目时会直接将这些文件拷贝到目标项目路径，支持占位符做包名、项目名等动态内容替换。
• 第四步：验证生效
  所有修改保存后重启Android Studio，打开New Project入口，即可在你设置的对应分类下找到自定义模板，使用逻辑和内置模板完全一致，支持选择保存路径、包名、编程语言、最低SDK版本等常规配置。

注意：Android Studio大版本升级会覆盖安装目录下的所有内置文件，升级前请提前备份自定义的模板文件夹，升级完成后放回对应路径即可恢复。不建议直接修改内置原有模板，修复安装或版本升级时所有修改会被重置。

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