前言
最近看到有關(guān)技術(shù)博客寞射,發(fā)現(xiàn)了關(guān)于androidstudio的模板的有關(guān)文章活尊,表示感興趣玻孟。
包括文中的引用部分缔杉。
關(guān)于自定義模板
在新建Activity的時(shí)候都有許多的模板供我們選擇,大哦滋茫可以自定義模板荞驴,減少開發(fā)時(shí)候的重復(fù)工作。
比如這樣:
圖片來自鴻洋的csdn博客
其實(shí)模板不僅限于activity 包括圖片自由 布局文件 fragment service 以及一個(gè)類都可以制作成模板贯城。
這里只想看下Activity模板:
模板制作學(xué)習(xí)
分為三個(gè)步驟:
分析系統(tǒng)模板
改寫系統(tǒng)模板
自己創(chuàng)造模板
分析和改寫系統(tǒng)模板
Activity的模板地址在AS的 plugins\android\lib\templates\activities 目錄下:
比如我的電腦在
C:\Program Files\Android\Android Studio\plugins\android\lib\templates\activities
Login界面用的比較多,就從他開始吧霹娄。
點(diǎn)開文件夾能犯,看到以下目錄:
模板LoginActivity.png
下面來一一分析這些文件:
template.xml
這個(gè)是模板配置文件鲫骗,打開可以看到:
template_login_activity.png
最外面的template標(biāo)簽寫的是基本的配置:包括模板名,描述踩晶,是否請(qǐng)求系統(tǒng)主題等等执泰。我們可以將其修改為中文。
parameter標(biāo)簽
參數(shù)渡蜻,也就是要在創(chuàng)建的時(shí)候自己設(shè)置的東西术吝。每一個(gè) parameter標(biāo)簽對(duì)應(yīng)一個(gè)參數(shù)。這些參數(shù)會(huì)顯示在創(chuàng)建頁面上茸苇。也修改為中文排苍。
. id :唯一標(biāo)識(shí),最終通過該屬性的值学密,獲取用戶輸入值(文本框內(nèi)容淘衙,是否選中)
. name:界面上的類似label的提示語
. type : 輸入值類型
. constraints:填寫值的約束
. suggest:建議值,比如填寫ActivityName的時(shí)候腻暮,會(huì)給出一個(gè)布局文件的建議值彤守。
. default:默認(rèn)值
. help:底部顯示的提升語
3.thumbs
里面放置了樣例圖,可以嘗試更換。
4.最后指定了兩個(gè)引用文件
可以測(cè)試一下修改的效果:
my.gif
globals.xml.ftl和recipe.xml.ftl
在這之前先了解一下ftl結(jié)尾的文件是什么:
freemarker的文件一般以后綴ftl.
freemarker確實(shí)是不錯(cuò)的模版語言引擎哭靖,尤其是處理對(duì)象圖很方便具垫,處理xml也很方便,還支持xpath
FreeMarker 是一個(gè)模版引擎试幽,一個(gè)基于文本的模板輸出工具(生成任意的HTML表單代碼)筝蚕。它是一個(gè)Java package,面向Java程序員的class library抡草。它本身并不是針對(duì)最終用戶的應(yīng)用饰及,而是允許程序員將其嵌入到他們的產(chǎn)品中。
FreeMarker被設(shè)計(jì)用來生成HTML Web頁面康震,特別是基于MVC(Model View Controller)模式的應(yīng)用程序燎含。使用 MVC 模式作為動(dòng)態(tài)的WEB頁面的想法,是為了分隔頁面設(shè)計(jì)者 (HTML 設(shè)計(jì)者) 和程序員腿短。.每個(gè)人做自己擅長(zhǎng)的那一部分屏箍。設(shè)計(jì)者可以不通過程序員的改變或修改代碼來改變網(wǎng)頁的樣子,因?yàn)閼?yīng)用邏輯(Java程序)和頁面設(shè)計(jì)(FreeMarker 模版)是分開的橘忱。模板不會(huì)被復(fù)雜繁瑣的程序框架所破壞赴魁。即使當(dāng)一個(gè)項(xiàng)目的程序員和HIMTL頁面的制作者是同一個(gè)人時(shí),這種分隔也是很有用钝诚,因?yàn)檫@樣有助于保持應(yīng)用的清晰并易于維護(hù)颖御。
不知道大家寫過網(wǎng)頁沒有,不管是jsp還是asp還是asp.net
都會(huì)有這種在標(biāo)簽語言里面插入編程語言的方式凝颇,大概類似潘拱。
關(guān)于ftl的語法:
組成部分
一疹鳄、整體結(jié)構(gòu)
1、注釋:<#--注釋內(nèi)容-->芦岂,不會(huì)輸出瘪弓。
2、文本:直接輸出禽最。
3腺怯、interpolation:由 ${var} 或 #{var} 限定,由計(jì)算值代替輸出川无。
4呛占、FTL標(biāo)記
二、指令:
freemarker指令有兩種:
1舀透、預(yù)定義指令:引用方式為<#指令名稱>
2栓票、用戶定義指令:引用方式為<@指令名稱>,引用用戶定義指令時(shí)須將#換為@愕够。
注意:如果使用不存在的指令走贪,F(xiàn)reeMarker不會(huì)使用模板輸出,而是產(chǎn)生一個(gè)錯(cuò)誤消息惑芭。
freemarker指令由FTL標(biāo)記來引用坠狡,F(xiàn)TL標(biāo)記和HTML標(biāo)記類似,名字前加#來加 以區(qū)分遂跟。如HTML標(biāo)記的形式為
則FTL標(biāo)記的形式是<#list>< /#list>(此處h1標(biāo)記和list指令沒有任何功能上的對(duì)應(yīng)關(guān)系逃沿,只是做為說明使用一下)。
有三種FTL標(biāo)記:
1)幻锁、開始標(biāo)記:<#指令名稱>
2)凯亮、結(jié)束標(biāo)記:
3)、空標(biāo)記:<#指令名稱/>
注意:
1) FTL會(huì)忽略標(biāo)記之中的空格哄尔,但是假消,<#和指令 與
2) FTL標(biāo)記不能夠交叉,必須合理嵌套岭接。每個(gè)開始標(biāo)記對(duì)應(yīng)一個(gè)結(jié)束標(biāo)記富拗,層層嵌套。 如:
<#list>
${數(shù)據(jù)}
<#if 變量>
game over!
注意事項(xiàng):
1)鸣戴、FTL對(duì)大小寫敏感啃沪。 所以使用的標(biāo)記及interpolation要注意大小寫。name與NAME就是不同的對(duì)象窄锅。<#list>是正確的標(biāo)記创千,而<#List>則不是。
2)、interpolation只能在文本部分使用签餐,不能位于FTL標(biāo)記內(nèi)寓涨。如<#if ${var}>是錯(cuò)誤的,正確的方法是:<#if var>,而且此處var必須為布爾值氯檐。
3)、FTL標(biāo)記不能位于另一個(gè)FTL標(biāo)記內(nèi)部体捏,注釋例外冠摄。注釋可以位于標(biāo)記及interpolation內(nèi)部。
其實(shí)只要知道if即可以了几缭,這里只用if來判斷河泳。
globals.xml.ftl
定義了全局變量,并引用了一個(gè)內(nèi)置的通用globals.xml.ftl
String"/><#include"../common/common_globals.xml.ftl" />
recipe.xml.ftl
指定資源文件的路徑并相應(yīng)的生成到我們的項(xiàng)目目錄去:
<#ifappCompat&& !(hasDependency('com.android.support:appcompat-v7'))><#if(buildApigte22) &&appCompat&& !(hasDependency('com.android.support:design'))>
. copy :從root中copy文件到我們的目標(biāo)目錄年栓,比如我們的模板Activity需要使用一些圖標(biāo)拆挥,那么可能就需要使用copy標(biāo)簽將這些圖標(biāo)拷貝到我們的項(xiàng)目對(duì)應(yīng)文件夾。
. merge : 合并的意思某抓,比如將我們使用到的strings.xml合并到我們的項(xiàng)目的stirngs.xml中
. instantiate : 和copy類似纸兔,但是可以看到上例試將ftl->java文件的,也就是說中間會(huì)通過一個(gè)步驟否副,將ftl中的變量都換成對(duì)應(yīng)的值汉矿,那么完整的流程是ftl->freemarker process -> java。
. open:在代碼生成后备禀,打開指定的文件洲拇,比如我們新建一個(gè)Activity后,默認(rèn)就會(huì)將該Activity打開曲尸。
那么整體的關(guān)系類似下圖:
這里只是指定了生成的路徑的文件名赋续,但是如何生成呢,這就要根據(jù)前面創(chuàng)建的選項(xiàng)來設(shè)置生成的目標(biāo)文件另患。
root文件夾
里面都是加了ftl的java文件和XML文件纽乱,所以我們用if來判斷生成的方式。
兩個(gè)步驟:
取值--->判斷-->生成
xml文件中:
配置文件:
android:label="@string/app_name"<#else>android:label="@string/title_${simpleName}"<#ifhasNoActionBar>android:theme="@style/${themeNameNoActionBar}"<#ifbuildApigte16&&parentActivityClass!= "">android:parentActivityName="${parentActivityClass}"><#ifparentActivityClass!= ""><#ifisLauncher&& !(isLibraryProject!false)>
獲取值柴淘,包括設(shè)定值和全局變量:
設(shè)定值:activityClass獲取迫淹,${activityClass}
全局變量:isNewProject,hasNoActionBar
if判斷
<#ifisNewProject>android:label="@string/app_name"<#else>android:label="@string/title_${simpleName}"
java文件中
代碼太長(zhǎng)不貼
也是類似的方式:
比如包名引入 package ${packageName};
判斷:
<#ifparentActivityClass!= "">setupActionBar();
最后系統(tǒng)根據(jù)這些東西來生成最終的文件:
流程大致可用下圖說明:
自己創(chuàng)造模板
分析改寫已經(jīng)完成了,下面開始創(chuàng)造
寫個(gè)自己的登錄界面
不用完全從頭開始为严。我們就拿LoginActivity模板來寫敛熬。