Android studio的自定義模板詳解

前言

最近看到有關(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模板來寫敛熬。

?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末,一起剝皮案震驚了整個(gè)濱河市第股,隨后出現(xiàn)的幾起案子应民,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 218,755評(píng)論 6 507
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件诲锹,死亡現(xiàn)場(chǎng)離奇詭異繁仁,居然都是意外死亡,警方通過查閱死者的電腦和手機(jī)归园,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 93,305評(píng)論 3 395
  • 文/潘曉璐 我一進(jìn)店門黄虱,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人庸诱,你說我怎么就攤上這事捻浦。” “怎么了桥爽?”我有些...
    開封第一講書人閱讀 165,138評(píng)論 0 355
  • 文/不壞的土叔 我叫張陵朱灿,是天一觀的道長(zhǎng)。 經(jīng)常有香客問我钠四,道長(zhǎng)盗扒,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 58,791評(píng)論 1 295
  • 正文 為了忘掉前任缀去,我火速辦了婚禮侣灶,結(jié)果婚禮上,老公的妹妹穿的比我還像新娘朵耕。我一直安慰自己炫隶,他們只是感情好,可當(dāng)我...
    茶點(diǎn)故事閱讀 67,794評(píng)論 6 392
  • 文/花漫 我一把揭開白布阎曹。 她就那樣靜靜地躺著伪阶,像睡著了一般。 火紅的嫁衣襯著肌膚如雪处嫌。 梳的紋絲不亂的頭發(fā)上栅贴,一...
    開封第一講書人閱讀 51,631評(píng)論 1 305
  • 那天,我揣著相機(jī)與錄音熏迹,去河邊找鬼檐薯。 笑死,一個(gè)胖子當(dāng)著我的面吹牛注暗,可吹牛的內(nèi)容都是我干的坛缕。 我是一名探鬼主播,決...
    沈念sama閱讀 40,362評(píng)論 3 418
  • 文/蒼蘭香墨 我猛地睜開眼捆昏,長(zhǎng)吁一口氣:“原來是場(chǎng)噩夢(mèng)啊……” “哼赚楚!你這毒婦竟也來了?” 一聲冷哼從身側(cè)響起骗卜,我...
    開封第一講書人閱讀 39,264評(píng)論 0 276
  • 序言:老撾萬榮一對(duì)情侶失蹤宠页,失蹤者是張志新(化名)和其女友劉穎左胞,沒想到半個(gè)月后,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體举户,經(jīng)...
    沈念sama閱讀 45,724評(píng)論 1 315
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡烤宙,尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 37,900評(píng)論 3 336
  • 正文 我和宋清朗相戀三年,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了俭嘁。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片躺枕。...
    茶點(diǎn)故事閱讀 40,040評(píng)論 1 350
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡,死狀恐怖兄淫,靈堂內(nèi)的尸體忽然破棺而出屯远,到底是詐尸還是另有隱情,我是刑警寧澤捕虽,帶...
    沈念sama閱讀 35,742評(píng)論 5 346
  • 正文 年R本政府宣布,位于F島的核電站坡脐,受9級(jí)特大地震影響泄私,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜备闲,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 41,364評(píng)論 3 330
  • 文/蒙蒙 一晌端、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧恬砂,春花似錦咧纠、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 31,944評(píng)論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至狱掂,卻和暖如春演痒,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背趋惨。 一陣腳步聲響...
    開封第一講書人閱讀 33,060評(píng)論 1 270
  • 我被黑心中介騙來泰國(guó)打工鸟顺, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留,地道東北人器虾。 一個(gè)月前我還...
    沈念sama閱讀 48,247評(píng)論 3 371
  • 正文 我出身青樓讯嫂,卻偏偏與公主長(zhǎng)得像,于是被迫代替她去往敵國(guó)和親兆沙。 傳聞我的和親對(duì)象是個(gè)殘疾皇子欧芽,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 44,979評(píng)論 2 355

推薦閱讀更多精彩內(nèi)容