Android 冷兵器之 tools

下位子發表於2018-02-05

前言

Android開發在所難免的就是UI的預覽和調整,一般情況下都是直接run看效果,或者是使用ASpreview預覽,但這同樣帶來個小問題,就是你的測試內容會跟隨著程式碼被打包到apk中,如果沒做容錯的處理很有可能將測試內容展示給使用者。

還有就是像一些列表是不支援預覽效果的,比如ListView

其實Android老早就有tools名稱空間,作為一個開發快到一年的我,最近看到一篇文章才發現這個tools大用處,在此做個筆記。

直接看一下效果,最為清楚:

RecyclerView.gif

ListView 預覽.png

GridView 預覽.png

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相關說起,在XMLviewandroid任意屬性值,可以直接替換成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連結到外層佈局,就可以直接連同外層佈局一同展示出來。

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" />
複製程式碼

的方式即可達到預覽的效果。

layout.png

進階使用

tools除去上面的功能,更強大的在於支援列表的預覽展示,也就是文章開頭預覽的效果,效果最明顯的就是ListView

ListView

ListView 預覽.png

// 1. 列表內容的佈局
tools:listitem="@layout/list_content"
// 2. 頭佈局的預覽展示
tools:listheader="@layout/list_header"
// 3. 腳佈局的預覽展示
tools:listfooter="@layout/list_footer"
複製程式碼

一開始使用的時候發現不生效,後來發現需要給ListView設定id,就會立刻生效了。

GridView

GridView 預覽.png

同樣也適用於GridView

RecyclerView

RecyclerView.gif

說到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/*的強大功能,作為預覽檢視的佔位資料。看一看官網的使用介紹。

sample

各種型別的資料都支援構造,這裡我以例子作為展示:

展示

每次使用,都會隨機的更換不同的值,詳情參見列表展示資料。

你以為這樣就結束了嗎?too young!除去原生給的資料支援,我們們也可以自己構造假的資料。

sample data

直接可以建立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了該技能,不說有多大用處吧,至少可以提高開發效率,和減少把測試程式碼部署到線上的失誤率吧,相信會幫助到你的!

感謝

tools 官方文件

名稱空間介紹

tools 大有用處

相關文章