Android Studio Template(模板)开发

引言

Android Studio提供的代码模板可帮助我们减少重复编写同一段代码的负担,而且可以遵循优化后的设计和标准。AS采用的是Apache FreeMarker模板引擎。

在网上,关于模板开发的资料比较少,而且Studio版本较低,也缺少实际开发中很多功能的示例(比如说Studio在加入kotlin后,我们怎么生成kotlin的模板)。这篇文章将基于TemplateBuilder模板插件,简化模板生成的难度。

环境:

Android Studio 3.1.1

TemplateBuilder 2.0

一、TemplateBuilder

简单介绍下TemplateBuilder的使用。

1.插件安装

在Studio菜单栏选择【File】-【Settings】,在左侧菜单中选择【Plugins】,点击【Browse repositories】。在弹出框中输入TemplateBuilder,点击安装并重启Studio后生效。

这里写图片描述

2.创建模板

1.定义模板:

这里定义了activityName、textViewName变量,之后在生成模板时,由用户输入。

publicclass${activityName} extends AppCompatActivity {privateTextView ${textViewName};@OverrideprotectedvoidonCreate(Bundle savedInstanceState){super.onCreate(savedInstanceState);        setContentView(R.layout.activity_main);    }}

2.生成模板

选中模板文件,按下【ALT + T】(或在Tools下选择Generate Template),配置模板信息

这里写图片描述

属性说明:

Template Category 对应模板的分类,对应选择导入模板时的模板分类,这里默认值是电脑的用户名。

Template Name 对应模板名称,对应选择导入模板时的模板名称,默认值是当前的Project名称。

Template Description 对应模板描述信息,对应导入模板时弹出的导入界面的文字描述,默认为空。

Template Folder 对应生成模板所存放的位置,如果是Mac操作系统则默认为/Applications/Android Studio.app/Contents/plugins/android/lib/templates, Windows系统的话由于差异比较大,就默认为空了,可以自行配置[Android Studio安装目录]/plugins/android/lib/templates(这里只需要配置一次即可,插件将自动保存该位置)。

Input data 配置模板变量

在【Configure Template Data】下点击【add】配置刚才模板中定义的变量,配置完毕后点击【Finish】。

这里写图片描述

重启Studio后就可使用该自定义模板。

这里写图片描述

关于Input data的使用,先解释下每个属性对应的含义

id 变量名,必须和模板中使用的变量名对应,必填

name 变量简介,必填

type 变量类型,string和boolean两种,通过下拉框选择,必填

default 变量对应的默认值,选填

help 添加该变量时的提示信息,选填

二、定义模板

这里我使用TemplateBuilder插件生成mvp的模板。通过修改相关的属性,实现Activity和layout动态生成,并在AndroidManifest.xml中注册。最后添加kotlin的模板配置,这样模板最终完成。

1.创建Java模板

首先创建一个MVP的Activity,将动态的属性声明为变量。

package${packageName};importandroid.os.Bundle;importcom.blackbox.medicalpension.common.mvp.base.BaseCommonActivity;importcom.blackbox.medicalpension.common.mvp.mvp.BasePresenter;importorg.jetbrains.annotations.Nullable;importjava.util.List;publicclass${activityClass} extends BaseCommonActivity{@OverrideprotectedvoidonCreate(Bundle savedInstanceState){super.onCreate(savedInstanceState);        setContentView(R.layout.${layoutName});        initTitleWithBack("${titleName}");    }@Nullable@OverridepublicList> createPresenter() {returnnull;    }}

创建对应的Layout布局文件

<?xml version="1.0"encoding="utf-8"?>

2.模板生成

选中两个模板文件,点击【ALT + T】,弹出【Configure Template Data】窗口。定义activityClass、layoutName、titleName三个变量,并【Finish】,生成模板。

这里写图片描述

模板文件存放在...\Android Studio\plugins\android\lib\templates下

这里写图片描述

模板文件后缀名都是以【.ftl】结尾。

globals.xml.ftl 全局变量文件 存放的是一些全局变量

recipe.xml.ftl 配置要引用的模板路径以及生成文件的路径

template.xml 模板的配置信息,以及要输入的参数.定义了模板的流程框架 基本结构

template_blank_activity.png 显示的缩略图(只是展示用)

LinActivity.java.ftl Activity模板文件

1.修改配置

进入到...\Android Studio\plugins\android\lib\templates\linw9目录下

1.修改template.xml文件

为方便用户输入Activity名称或Layout名称,自动提示Layout或Activity名称,需要在文件中添加两个属性:

constraints="class|unique|nonempty"

suggest="${layoutToActivity(layoutName)}"

suggest="${activityToLayout(activityClass)}"

<?xml version="1.0"?><!-- input data --><!-- 128x128 thumbnails relative to com.puke.template.xml --><!-- default thumbnail is required -->template_cover.png

2.修改AndroidManifest.xml文件

进入到...\Android Studio\plugins\android\lib\templates\linw9\LinMvpActivity\root 目录下,打开AndroidManifest.xml.ftl文件,修改内容让Studio自动注册Activity。需要注意的是:需要对AndroidManifest进行代码格式化(Format),不然使用的时候Studio可能会提示Merge。

只针对Java代码的模板到此结束,重新启动Studio后即可使用该模板。

<?xml version="1.0"encoding="utf-8"?>

3.增加Kotlin模板

在网上,我没有查找到关于Kotlin模板配置的相关文章,这里给大家讲解下我的方法。

我是通过学习Studio自带的模板,从中找到了配置Kotlin模板的方法,仅供大家参考。

1.创建Kotlin模板

进入到...\Android Studio\plugins\android\lib\templates\linw9\LinMvpActivity\root\src\app_package目录下,直接创建kotlin模板

package${packageName}importandroid.os.Bundleimportcom.blackbox.medicalpension.common.mvp.base.BaseCommonActivityimportcom.blackbox.medicalpension.common.mvp.mvp.BasePresenterimportkotlinx.android.synthetic.main.${layoutName}.*class${activityClass} : BaseCommonActivity(){override funonCreate(savedInstanceState: Bundle?){super.onCreate(savedInstanceState)        setContentView(R.layout.${layoutName})        initTitleWithBack("${titleName}")    }override funcreatePresenter(): MutableList> ?{returnnull}}

2.修改recipe.xml.ftl

进入到...\Android Studio\plugins\android\lib\templates\linw9\LinMvpActivity目录下,打开recipe.xml.ftl

将java改为${ktOrJavaExt}变量。

<?xml version="1.0"?>

3.修改globals.xml.ftl

进入到...\Android Studio\plugins\android\lib\templates\linw9\LinMvpActivity目录下,打开globals.xml.ftl

添加ktOrJavaExt变量声明:

这里写图片描述

<?xml version="1.0"?><#assigngenerateKotlin=(((includeKotlinSupport!false)|| (language!'Java')?string=='Kotlin'))>

4.结束

重启Studio后,就可以生成Java或Kotlin的代码。对于写的不好的地方,希望大家多提建议。

作者:JustinMiller

链接:https://www.jianshu.com/p/e3548f441440

來源:简书

简书著作权归作者所有,任何形式的转载都请联系作者获得授权并注明出处。

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 221,548评论 6 515
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 94,497评论 3 399
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 167,990评论 0 360
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 59,618评论 1 296
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 68,618评论 6 397
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 52,246评论 1 308
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,819评论 3 421
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 39,725评论 0 276
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 46,268评论 1 320
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 38,356评论 3 340
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 40,488评论 1 352
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 36,181评论 5 350
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 41,862评论 3 333
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 32,331评论 0 24
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 33,445评论 1 272
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 48,897评论 3 376
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 45,500评论 2 359

推荐阅读更多精彩内容