本文已授权微信公众号：鸿洋（hongyangAndroid）在微信公众号平台原创首发。
转载请标明出处：
http://blog.csdn.net/lmj623565791/article/details/51635533；
本文出自:【张鸿洋的博客】
上一篇文章，已经初步对Android Studio的模板有了初步的介绍与使用，以及一些开源模板的推荐：
本文将对如何编写Template，进行详细的介绍（以activity摸版为例）。
学习编写模板最好的方式呢，就是参考IDE中已经提供的最简单的模板，那么在android Studio中最简单的activity模板就是:Empty Activity了，我们打开该模板文件，首先对文件结构有个直观的了解，如图：
可以看到每个插件对应一个文件夹，文件夹包含
下面我们逐一对上述每个文件的作用就行介绍。
打开该文件，发现其主要内容如下：
<?xml version="1.0"?><template name="Empty Activity" minApi="7" minBuildApi="14" description="Creates a new empty activity"> <category value="Activity" /> <parameter id="activityClass" name="Activity Name" type="string" constraints="class|unique|nonempty" suggest="${layoutToActivity(layoutName)}" default="MainActivity" help="The name of the activity class to create" /> <thumbs> <!-- default thumbnail is required --> <thumb>template_blank_activity.png</thumb> </thumbs> <globals file="globals.xml.ftl" /> <execute file="recipe.xml.ftl" /></template>其中
<template>中的name属性，对应新建Activity时显示的名字<category>对应New的类别为Activity剩下的，对应我们AndroidStudio新建Empty Activity的界面就非常好理解了，如图：
看到这个界面，大部分属性都应该能才出来了，我们重点看parameter，界面上每一个紫色框出来的部分都对应一个parameter，部分属性介绍：
这个部分对应界面还是非常好理解的，大家可以简单的修改一些字符串，或者添加一个<parameter>，重启AS，看看效果。
template.xml的最下面的部分引入了globals.xml.ftl和recipe.xml.ftl。
这两个我们会详细介绍。
<?xml version="1.0"?><globals> <global id="hasNoActionBar" type="boolean" value="false" /> <#include "../common/common_globals.xml.ftl" /></globals>通过名称可以猜到它是用于定义一些全局的变量，可以看到其内部有<global>标签，分别定义id,type,默认值。
同理，我们可以通过id的值访问到该值，例如：
${hasNoActionBar}的值为false。
<recipe><copy from="root/res/drawable-hdpi" to="${escapeXmlAttribute(resOut)}/drawable-hdpi" /><merge from="root/${resIn}/values/strings.xml.ftl" to="${escapeXmlAttribute(resOut)}/values/strings.xml" /><instantiate from="root/src/app_package/SimpleActivity.java.ftl" to="${escapeXmlAttribute(srcOut)}/${activityClass}.java" /><open file="${escapeXmlAttribute(srcOut)}/${activityClass}.java" /></recipe>为了介绍，我将该xml中比较重要的几个标签都列出来了：
ftl->freemarker process -> java。在介绍instantiate时，涉及到了freemarker，不可避免的需要对它进行简单的介绍。
目前我们已经基本了解了一个模板其内部的文件结构了，以及每个文件大致包含的东西，我们简单做个总结：
那么整体的关系类似下图：
图片来源：http://www.slideshare.net/murphonic/custom-android-code-templates-15537501
上面我们已经基本了解模板生成的大致的流程以及涉及到的文件，大致了解了我们生成的源码或者xml文件，需要经过：
ftl->freemarker process->java/xml这样的流程，那么我们必须对freemarker有个简单的了解。
其实非常简单：
比如我们有个变量user=zhy；有个ftl文件内容：helloL${user}最后经过freemarker的输出结果即为 hello:zhy<#if generateLayout> //生成layout文件</#if>看一眼就知道大概的意思了~有一定的编程经验，即使不知道这个叫freemarker，对于这些简单的语法还是能看懂的。
我们最后以Empty Activity模板的中的SimpleActivity为例：
root/src/app_package/SimpleActivity.Java.ftl
package ${packageName};import ${superClassFqcn};import android.os.Bundle;public class ${activityClass} extends ${superClass} { @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState);<#if generateLayout> setContentView(R.layout.${layoutName});</#if> }}可以看到其内部包含很多变量，这些变量的值一般来源于用户输入和global.xml.ftl中预定义的值，经过recipe.xml.ftl中instantiate标签的处理，将变量换成实际的值，即可在我们的项目的指定位置，得到我们期望的Activity。
流程大致可用下图说明：
图片来源：http://www.slideshare.net/murphonic/custom-android-code-templates-15537501
看到这，最起码理解了，当我们选择创建不同的Activity类型，最终得到的不同的效果其中的原理原来在这。
了解了基本的理论之后，下面我们可以通过一个实例来将上面的知识点整合。
我们编写一个Activity模板叫做：ViewPagerWithTabActivity，用于创建一个携带TabLayout的ViewPager，效果如下：
当我们点击New->Activity->ViewPagerWithTabActivity 就可能完成上面的Activity的创建，而避免了编写布局文件，引入design库，以及一些简单的编码。
是不是感觉还是不错的，大家可以针对自己的需求，按照规范的格式随意定制模板。
建议大家copy一个现有的模板，再其基础上修改即可，比如本例是在Empty Activity基础之上修改的。
下面我们看上例的具体的实现。
通过上面的学习我们知道template.xml中可以定义我们创建面板的控件布局等，本例我们创建Activity的界面如下：
对应的template.xml如下：
<?xml version="1.0"?><template> <category value="Activity" /> <formfactor value="Mobile" /> <parameter id="activityClass"/> <parameter id="activityLayoutName"/> <parameter id="tabCount"/> <parameter id="isLauncher"/> <parameter id="packageName"/> <!-- 128x128 thumbnails relative to template.xml --> <thumbs> <!-- default thumbnail is required --> <thumb>template_vp_with_tab_activity.png</thumb> </thumbs> <globals file="globals.xml.ftl" /> <execute file="recipe.xml.ftl" /></template>经过前面的学习应该很好理解，每个parameter对应界面上的一个控件，控件的这个id最终可以得到用户输入值，后面会用于渲染ftl文件。
本例中最终需要生成Fragment和Activity，也就是说对应会有两个ftl文件分别用于最终生成这两个类。
root/src/app_package/MainActivity.java.ftlpackage ${packageName};import android.os.Bundle;import android.support.design.widget.TabLayout;import android.support.v4.app.Fragment;import android.support.v4.app.FragmentPagerAdapter;import android.support.v4.view.ViewPager;import android.support.v7.app.AppCompatActivity;import ${packageName}.fragment.SimpleFragment;public class ${activityClass} extends AppCompatActivity{ private TabLayout mTabLayout; private ViewPager mViewPager; private int mTabCount = ${tabCount}; @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.${activityLayoutName}); mTabLayout = (TabLayout) findViewById(R.id.id_tablayout); mViewPager = (ViewPager) findViewById(R.id.id_viewpager); mViewPager.setAdapter(new FragmentPagerAdapter(getSupportFragmentManager()) { @Override public Fragment getItem(int position) { return new SimpleFragment(); } @Override public int getCount() { return mTabCount; } @Override public CharSequence getPageTitle(int position) { return "Tab:" + position; } }); mTabLayout.setupWithViewPager(mViewPager); }}注意不是.java文件而是.ftl文件，可以看到上面的代码基础上和Java代码没什么区别，实际上就是Java代码，把可变的部分都换成了${变量名}的方式而已。
例如：类名是用户填写的，我们就使用${activityClass}替代，其他同理。
root/src/app_package/SimpleFragment.java.ftlpackage ${packageName}.fragment;import android.os.Bundle;import android.support.annotation.Nullable;import android.support.v4.app.Fragment;import android.view.Gravity;import android.view.LayoutInflater;import android.view.View;import android.view.ViewGroup;import android.widget.TextView;/** * Created by zhy on 16/6/6. */public class SimpleFragment extends Fragment{ @Nullable @Override public View onCreateView(LayoutInflater inflater, @Nullable ViewGroup container, @Nullable Bundle savedInstanceState) { TextView tv = new TextView(getActivity()); tv.setGravity(Gravity.CENTER); tv.setTextSize(40); tv.setText("just test"); return tv ; }}这个类更简单，除了package是动态的，其他都写好了，主要用于作为ViewPager的Fragment Item.
root/res/layout/activity_main.xml.ftl<?xml version="1.0" encoding="utf-8"?><LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" xmlns:tools="http://schemas.android.com/tools" android:layout_width="match_parent" android:layout_height="match_parent" android:orientation="vertical" tools:context=" ${packageName}.${activityClass}"> <android.support.design.widget.TabLayout android:id="@+id/id_tablayout" android:layout_width="match_parent" android:layout_height="wrap_content"> </android.support.design.widget.TabLayout> <android.support.v4.view.ViewPager android:id="@+id/id_viewpager" android:layout_width="match_parent" android:layout_height="0dp" android:layout_weight="1" /></LinearLayout>发现和我们真正编写的Activity并无多大区别。
看完用到的类和布局文件的ftl，大家心里应该有个底了，这模板几乎就和我们平时写的Java类一样，只是根据用户在新建Actiivty界面所输入的参数进行替换一些变量或者做一些简单的操作而已。
除了template.xml还有globals.xml.ftl和recipe.xml.ftl，globals.xml.ftl中基本上没有修改任何内容就不介绍了。
recipe.xml.ftl中定义的东西比较关键，例如将ftl->java，copy、合并资源文件等。
内容较长，我们拆开描述。
<?xml version="1.0"?><recipe> <#include "../common/recipe_manifest.xml.ftl" /> <#if !appCompat && !(hasDependency('com.android.support:support-v4'))> <dependency mavenUrl="com.android.support:support-v4:${buildApi}.+"/> </#if> <#if appCompat && !(hasDependency('com.android.support:appcompat-v7'))> <dependency mavenUrl="com.android.support:appcompat-v7:${buildApi}.+" /> </#if> <#if (buildApi gte 22) && appCompat && !(hasDependency('com.android.support:design'))> <dependency mavenUrl="com.android.support:design:${buildApi}.+" /> </#if>//省略其他</recipe>本例依赖v4、v7、和design库，我们需要在这里定义引入；
你可能会问，这个引入的代码看起来挺复杂，你怎么知道这样写呢？
其实我也不知道怎么写，但是我可以打开IDE自带模板参考参考，copy过来就好了。
<?xml version="1.0"?><recipe> //省略依赖 <instantiate from="root/src/app_package/MainActivity.java.ftl" to="${escapeXmlAttribute(srcOut)}/${activityClass}.java" /> <instantiate from="root/src/app_package/SimpleFragment.java.ftl" to="${escapeXmlAttribute(srcOut)}/fragment/SimpleFragment.java" /> <instantiate from="root/res/layout/activity_main.xml.ftl" to="${escapeXmlAttribute(resOut)}/layout/${activityLayoutName}.xml" /> <open file="${escapeXmlAttribute(resOut)}/layout/${activityLayoutName}.xml"/> <open file="${escapeXmlAttribute(srcOut)}/${activityClass}.java" /></recipe>可以看到包含多个instantiate标签，该标签很明显是将我们内置的ftl转化为当前项目有中的java类。
上例，转化了
${activityClass}.javafragment/SimpleFragment.java"/layout/${activityLayoutName}.xml剩下是两个open标签，主要就是用于新建完成后，自动打开该文件。
本例新建完成后，Activity和其对应的布局文件都会自动打开。
恩，这里没用到merge标签，不过也很简单，假设你fragment上显示的文本，你可以定义到一个strings.xml里面，最后你需要将这个strings.xml合并到当前项目的strings.xml就可以使用merge标签（内置模板很多用了merge标签，参考下，抄一抄就搞定了）。
ok，到这，我们整个模板的编写介绍就结束了。
本文我们首先详细介绍了一个模板文件夹下各个文件以及其内部的标签的作用，然后通过一个具体的实例，来演示如何编写一个activity模板。
如果你看的足够仔细，再花点时间动手，根据需求编写几个模板应该是不成问题的。
当然，文中一些细节并没有谈到，对于这些不要担心，你有什么需求，你就想哪个内置的模板好像有类似的需求，看它的实现，copy它的相关代码改一改就好了，没有必要去被各种文件的编写，这种东西copy修改就好了。
测试过程中，需要重启Android Studio，如果有问题，记得查看Event Log面板的信息。
此外，模板这个东西我觉得最好的集大家的力量，所以我在github建立了一个组织仓库，https://github.com/WanAndroid/AndroidStudioTemplates，如果你对模板有兴趣或者想要将自己的模板文件与他人共享，可以加入这个组织，然后分享你的代码，本文的例子也在其中。
欢迎关注我的微博：
http://weibo.com/u/3165018720
群号： 497438697 ，欢迎入群
微信公众号：hongyangAndroid
（欢迎关注，不要错过每一篇干货，支持投稿）
联系客服
