前言
Android
開發在所難免的就是UI
的預覽和調整,一般情況下都是直接run
看效果,或者是使用AS
的preview
預覽,但這同樣帶來個小問題,就是你的測試內容會跟隨著程式碼被打包到apk
中,如果沒做容錯的處理很有可能將測試內容展示給使用者。
還有就是像一些列表是不支援預覽效果的,比如ListView
。
其實Android
老早就有tools
名稱空間,作為一個開發快到一年的我,最近看到一篇文章才發現這個tools
大用處,在此做個筆記。
直接看一下效果,最為清楚:
XML
中的程式碼區區幾行,但是右側的preview
效果卻很直接,還有就是這些資料並不會打到apk
中,直接執行是沒有任何效果的,這就是厲害之處!相關程式碼已提交到Github
上: Android Tools
初步使用
既然是名稱空間,那肯定就要在XML
開頭就要宣告。
xmlns:tools="http://schemas.android.com/tools"
複製程式碼
類似於
xmlns:android="http://schemas.android.com/apk/res/android"
複製程式碼
然後就可以使用tools
的相關屬性了。屬性功能很多很全,我就介紹一下常用的,文尾會貼上相關的文章連結。
View 相關
先從view
相關說起,在XML
中view
的android
任意屬性值,可以直接替換成tools
,這樣就可以實現實時的預覽效果,並且正式部署之後不會展示。有點類似於dataBinding
中的 default
屬性,以TextView
為例。
//1. 原生
android:text="test text"
//2. databinding
android:text='@{viewModel.content, default="test text"}'
//3. tools
tools:text="test text"
複製程式碼
preview
的效果是一樣的,不過除了 1 以外,其他執行效果是根據程式碼中設定的內容決定的,真正做到了測試預覽。
之前也說了,view
的其他屬性它都支援。
context
通過
tools:context="com.xiaweizi.androidtoolsexample.CommonActivity"
複製程式碼
的方式在根部局引用,主要的作用宣告該佈局檔案預設關聯的Activity
,引號傳Activity
類的完整包名。隨之就可以開啟一些與其相關的特性。比如日常點選事件中,就可以直接在XML
中宣告onClick
的方法名,然後會有錯誤的lint
提示,需要你在Activity
中建立改方法,跟隨著AS
的智慧指引,便可建立對應的方法。點選事件的處理便可以放在裡面。
showIn
tools:showIn="@layout/activity_other"
複製程式碼
在使用include
或者merge
時,內層佈局是預覽不到外層的佈局的。那通過showIn
連結到外層佈局,就可以直接連同外層佈局一同展示出來。
layout
同樣在XML
中引用fragment
佈局也是預覽不到效果的:
那通過:
<fragment
android:id="@+id/fragment"
android:name="com.xiaweizi.androidtoolsexample.CommonFragment"
android:layout_width="match_parent"
android:layout_height="match_parent"
tools:layout="@layout/layout_fragment_test" />
複製程式碼
的方式即可達到預覽的效果。
進階使用
tools
除去上面的功能,更強大的在於支援列表的預覽展示,也就是文章開頭預覽的效果,效果最明顯的就是ListView
。
ListView
// 1. 列表內容的佈局
tools:listitem="@layout/list_content"
// 2. 頭佈局的預覽展示
tools:listheader="@layout/list_header"
// 3. 腳佈局的預覽展示
tools:listfooter="@layout/list_footer"
複製程式碼
一開始使用的時候發現不生效,後來發現需要給
ListView
設定id
,就會立刻生效了。
GridView
同樣也適用於GridView
。
RecyclerView
說到RecyclerView
一開始我以為只支援itemCount
的設定,後來多謝以為小夥伴提的AndroidToolsExample/issues/1,我才發現可以支援複雜的列表展示!
// 1. 設定展示 item 的數量
tools:itemCount="6"
// 2. 設定佈局方式 三種模式可以選擇
// GridLayoutManager
// LinearLayoutManager
// StaggeredGridLayoutManager
tools:layoutManager="GridLayoutManager"
// 3. item 的佈局
tools:listitem="@layout/list_content"
// 4 設定佈局的方向
tools:orientation="horizontal"
// 5. 設定佈局橫、縱的列數
tools:spanCount="2"
複製程式碼
sample
有人會好奇列表的資料哪來的,沒看你設定,竟然能做到每條資料都不一樣。客官別急,接下來就是介紹一下@tools:sample/*
的強大功能,作為預覽檢視的佔位資料。看一看官網的使用介紹。
各種型別的資料都支援構造,這裡我以例子作為展示:
每次使用,都會隨機的更換不同的值,詳情參見列表展示資料。
你以為這樣就結束了嗎?too young
!除去原生給的資料支援,我們們也可以自己構造假的資料。
直接可以建立sample data
,然後就可以建立文字或者json
資料。如果是json
資料,你必須先執行一下才能使用。那看一下如何使用。
先建立json
資料:
{
"data": [
{
"name": "張三",
"phone": "@tools:sample/us_phones",
"time": "@tools:sample/date/hhmmss",
"avatar": "@tools:sample/avatars"
},
{
"name": "李四",
"phone": "@tools:sample/us_phones",
"time": "@tools:sample/date/hhmmss",
"avatar": "@tools:sample/avatars"
},
{
"name": "趙五",
"phone": "@tools:sample/us_phones",
"time": "@tools:sample/date/hhmmss",
"avatar": "@tools:sample/avatars"
},
{
"name": "王二麻",
"phone": "@tools:sample/us_phones",
"time": "@tools:sample/date/hhmmss",
"avatar": "@tools:sample/avatars"
}
]
}
複製程式碼
然後直接在XML
中,通過@sample/
的方式拿到資料。
使用和預覽正如上圖所示。
總結
get
了該技能,不說有多大用處吧,至少可以提高開發效率,和減少把測試程式碼部署到線上的失誤率吧,相信會幫助到你的!