如何在Android Studio Giraffe版本创建自定义项目模板
Android Studio Giraffe 完整项目自定义模板创建方法
Android Studio Giraffe 完全支持创建完整项目的自定义模板,旧版本的<installation folder>\plugins\android\lib\templates目录已迁移,以下是具体的位置和创建步骤:
模板目录的新位置
- 当前用户专属模板目录(推荐):
Windows系统:C:\Users\<你的用户名>\.AndroidStudioGiraffe\config\templates
macOS/Linux:~/.AndroidStudioGiraffe/config/templates
这个目录下的模板仅对当前用户可见,且不会被Android Studio更新覆盖。 - 全局模板目录:
位于Android Studio安装目录的plugins/android/resources/templates,修改需要管理员权限,且Studio更新时可能被覆盖,不推荐使用。
创建自定义项目模板的步骤
复制基础模板结构
从Android Studio自带的项目模板中复制一个基础模板作为起点,自带模板路径为安装目录下的plugins/android/resources/templates/projects,比如复制EmptyActivity文件夹到你的用户模板目录下,并重命名为你想要的模板名称(比如MyCustomProject)。修改模板配置
template.xml:这是模板的核心配置文件,你可以修改模板的名称、描述、可配置参数(如包名、项目名称、是否启用Jetpack Compose等)。例如,修改<name>标签来设置模板在新建项目界面显示的名称。recipe.xml.ftl:定义模板的生成逻辑,包括复制哪些文件、替换变量、执行必要的gradle操作。你可以添加自定义文件的复制规则,或者调整变量替换逻辑。globals.xml.ftl:定义模板中使用的全局变量,比如自定义的版本号、依赖库版本等。
自定义模板内容
对模板内的代码文件、布局文件、gradle配置等进行修改,使用Freemarker语法(如${packageName}、${projectName})来替换动态变量。比如修改src/main/java/${packageName}/MainActivity.kt中的代码,添加你需要的默认逻辑;或者调整build.gradle文件,添加常用的依赖库。测试模板
重启Android Studio,点击File > New > New Project,在模板列表中就能找到你自定义的模板。选择它并填写必要参数,生成项目后检查内容是否符合预期。
注意事项
- 如果自定义模板未在新建项目界面显示,检查目录结构是否正确,配置文件是否存在语法错误。可以通过
Help > Show Log in Explorer打开日志文件排查问题。 - 尽量使用用户专属模板目录,避免更新Android Studio时丢失自定义内容。
- 模板中的变量和逻辑需遵循Freemarker语法,错误的语法会导致模板无法正常加载。
内容的提问来源于stack exchange,提问作者V.Rashkov
相关产品推荐
相关产品推荐

