一、Android Studio的模板所在路徑

{Android Studio}/plugins/android/lib/templates/activities

• 自制模板若無錯誤，直接拷至此目錄下即可使用

二、最簡單的預設模板EmptyActivity介紹

0、EmptyActivity目錄結構

EmptyActivity
|- template.xml                     //建立Activity時的屬性配置
|- globals.xml.ftl                  //定義一些全域性的設定
|- recipe.xml.ftl                   //拷貝程式碼或檔案的命令
|- template_blank_activity.png      //效果圖
|- root
    |- src
        |- app_package
            |- SimpleActivity.java.ftl      //被拷貝轉化的程式碼
 

1、template.xml 建立Activity時的屬性配置

配置介面 (檔案寫好後在使用時的介面)

全部內容

<?xml version="1.0"?>
<template
    format="5"
    revision="5"
    name="Empty Activity"
    minApi="9"
    minBuildApi="14"
    description="Creates a new empty activity">

    <category value="Activity" />
    <formfactor value="Mobile" />

    <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"/>

    <parameter
        id="generateLayout"
        name="Generate Layout File"
        type="boolean"
        default="true"
        help="If true, a layout file will be generated" />

    <parameter
        id="layoutName"
        name="Layout Name"
        type="string"
        constraints="layout|unique|nonempty"
        suggest="${activityToLayout(activityClass)}"
        default="activity_main"
        visibility="generateLayout"
        help="The name of the layout to create for the activity" />

    <parameter
        id="isLauncher"
        name="Launcher Activity"
        type="boolean"
        default="false"
        help="If true, this activity will have a CATEGORY_LAUNCHER intent filter, making it visible in the launcher" />

    <parameter
        id="backwardsCompatibility"
        name="Backwards Compatibility (AppCompat)"
        type="boolean"
        default="true"
        help="If false, this activity base class will be Activity instead of AppCompatActivity" />

    <parameter
        id="packageName"
        name="Package name"
        type="string"
        constraints="package"
        default="com.mycompany.myapp" />

    <!-- 128x128 thumbnails relative to template.xml -->
    <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 是AS建立Activity，選擇模板時顯示的名字；其他屬性可直觀看出，如最低可選擇該模板的工程API版本。

• 每個 < parameter /> 都對應於配置介面的一項屬性選擇，如activityClass(Activity的名字）、generateLayout（是否生成layout檔案）等等。

  <!-- id             唯一標識 -->
  <!-- name           label提示語 -->
  <!-- type           輸入值型別 -->
  <!-- constraints    填寫值的約束 -->
  <!-- suggest        建議值 -->
  <!-- default        預設值 -->
  <!-- help           提示語 -->
   
  

• < thumbs /> 設定 效果圖

• < globals /> 設定 全域性設定檔案
• < execute /> 執行 命令檔案

2、globals.xml.ftl 用於定義一些全域性的設定

<?xml version="1.0"?>
<globals>
    <global id="hasNoActionBar" type="boolean" value="false" />
    <global id="parentActivityClass" value="" />
    <global id="simpleLayoutName" value="${layoutName}" />
    <global id="excludeMenu" type="boolean" value="true" />
    <global id="generateActivityTitle" type="boolean" value="false" />
    <#include "../common/common_globals.xml.ftl" />
</globals>

• include 是指將目標檔案中的程式碼也包含進來，如本例中包含進了通用全域性設定檔案
• ${layoutName} 是變數名，定義於“template.xml”中的 < parameter />。

3、recipe.xml.ftl 拷貝程式碼或檔案的命令

<?xml version="1.0"?>
<recipe>
    <#include "../common/recipe_manifest.xml.ftl" />

<#if generateLayout>
    <#include "../common/recipe_simple.xml.ftl" />
    <open file="${escapeXmlAttribute(resOut)}/layout/${layoutName}.xml" />
</#if>

    <instantiate from="root/src/app_package/SimpleActivity.java.ftl"
                   to="${escapeXmlAttribute(srcOut)}/${activityClass}.java" />

    <open file="${escapeXmlAttribute(srcOut)}/${activityClass}.java" />
</recipe>

• instantiate : 將ftl轉化為java檔案，並放置到目標目錄。中間會通過一個步驟，將ftl中的變數都換成對應的值，那麼完整的流程是ftl->freemarker process -> java。
• open : 在程式碼生成後，開啟指定的檔案，比如我們新建一個Activity後，預設就會將該Activity開啟。

include 的程式碼中包含：

• copy : 將原始檔複製到目標目錄，比如我們的模板Activity需要使用一些圖示，那麼可能就需要使用copy標籤將這些圖示拷貝到我們的專案對應資料夾。
• merge : 合併源文 件和目標文 件，如將模板中的strings.xml合併到專案中的stirngs.xml。

4、SimpleActivity.java.ftl 將被轉化的Activity程式碼（.java複製，.ftl轉化）

package ${packageName};

import ${superClassFqcn};
import android.os.Bundle;
<#if includeCppSupport!false>
import android.widget.TextView;
</#if>

public class ${activityClass} extends ${superClass} {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
<#if generateLayout>
        setContentView(R.layout.${layoutName});
</#if>
<#include "../../../../common/jni_code_usage.java.ftl">
    }
<#include "../../../../common/jni_code_snippet.java.ftl">
}