http://www.jcodecraeer.com/a/anzhuokaifa/androidkaifa/2015/0309/2567.html
第一部分
安卓開發中,在寫佈局代碼的時候,ide可以看到佈局的預覽效果。
但是有些效果則必須在運行之後才能看見,比如這種情況:TextView在xml中沒有設置任何字符,而是在activity中設置了text。因此爲了在ide中預覽效果,你必須在xml中爲TextView控件設置android:text屬性
1
2
3
4
5
6
7
|
<TextView android:id= "@+id/text_main" android:layout_width= "match_parent" android:layout_height= "wrap_content" android:textAppearance= "@style/TextAppearance.Title" android:layout_margin= "@dimen/main_margin" android:text= "I am a title" /> |
一般我們在這樣做的時候都告訴自己,沒關係,等寫完代碼我就把這些東西一併刪了。但是你可能會忘,以至於在你的最終產品中也會有這樣的代碼。
用tools吧,別做傻事
以上的情況是可以避免的,我們使用tools命名空間以及其屬性來解決這個問題。
1
|
xmlns:tools= "http://schemas.android.com/tools" |
tools可以告訴Android Studio,哪些屬性在運行的時候是被忽略的,只在設計佈局的時候有效。比如我們要讓android:text屬性只在佈局預覽中有效可以這樣
1
2
3
4
5
6
7
|
<TextView android:id= "@+id/text_main" android:layout_width= "match_parent" android:layout_height= "wrap_content" android:textAppearance= "@style/TextAppearance.Title" android:layout_margin= "@dimen/main_margin" tools:text= "I am a title" /> |
tools可以覆蓋android的所有標準屬性,將android:換成tools:即可。同時在運行的時候就連tools:本身都是被忽略的,不會被帶進apk中。
tools屬性的種類
tools屬性可以分爲兩種:一種是影響Lint提示的,一種是關於xml佈局設計的。以上介紹的是tools的最基本用法:在UI設計的時候覆蓋標準的android屬性,屬於第二種。下面介紹Lint相關的屬性。
Lint相關的屬性
1
2
3
|
tools:ignore tools:targetApi tools:locale |
tools:ignore
ignore屬性是告訴Lint忽略xml中的某些警告。
假設我們有這樣的一個ImageView
1
2
3
4
5
6
7
|
<ImageView android:layout_width= "wrap_content" android:layout_height= "wrap_content" android:layout_marginStart= "@dimen/margin_main" android:layout_marginTop= "@dimen/margin_main" android:scaleType= "center" android:src= "@drawable/divider" /> |
Lint會提示該ImageView缺少android:contentDescription屬性。我們可以使用tools:ignore來忽略這個警告:
1
2
3
4
5
6
7
8
|
<ImageView android:layout_width= "wrap_content" android:layout_height= "wrap_content" android:layout_marginStart= "@dimen/margin_main" android:layout_marginTop= "@dimen/margin_main" android:scaleType= "center" android:src= "@drawable/divider" tools:ignore= "contentDescription" /> |
tools:targetApi
假設minSdkLevel 15,而你使用了api21中的控件比如RippleDrawable
1
2
|
<ripple xmlns:android= "http://schemas.android.com/apk/res/android" android:color= "@color/accent_color" /> |
則Lint會提示警告。
爲了不顯示這個警告,可以:
1
2
3
4
|
<ripple xmlns:android= "http://schemas.android.com/apk/res/android" android:color= "@color/accent_color" tools:targetApi= "LOLLIPOP" /> |
tools:locale(本地語言)屬性
默認情況下res/values/strings.xml中的字符串會執行拼寫檢查,如果不是英語,會提示拼寫錯誤,通過以下代碼來告訴studio本地語言不是英語,就不會有提示了。
1
2
3
4
5
6
7
8
|
<resources tools:locale= "it" > <!-- Your strings go here --> </resources> |
這篇文章首先介紹了tools的最基本用法-覆蓋android的屬性,然後介紹了忽略Lint提示的屬性。下篇文章中,我們將繼續介紹關於UI預覽的其他屬性(非android標準屬性)。
ps:關於忽略Lint的屬性,如果不想了解的話也沒關係,因爲並不影響編譯,一般我都不會管這些警告。
第二部分
這部分我們將繼續介紹關於UI預覽的其他屬性(非android標準屬性)。
-
tools:context
-
tools:menu
-
tools:actionBarNavMode
-
tools:listitem/listheader/listfooter
-
tools:showIn
-
tools:layout
tools:context
context屬性其實正是的稱呼是activity屬性,有了這個屬性,ide就知道在預覽佈局的時候該採用什麼樣的主題。同時他還可以在android studio的java代碼中幫助找到相關的文件(Go to Related files)
該屬性的值是activity的完整包名
1
2
3
4
5
6
7
8
9
|
<LinearLayout android:id= "@+id/container" android:layout_width= "match_parent" android:layout_height= "match_parent" android:orientation= "vertical" tools:context= "com.android.example.MainActivity" > <!-- ... --> </LinearLayout> |
tools:menu
告訴IDE 在預覽窗口中使用哪個菜單,這個菜單將顯示在layout的根節點上(actionbar的位置)。
其實預覽窗口非常智能,如果佈局和一個activity關聯(指上面所講的用tools:context關聯)它將會自動查詢相關activity的onCreateOptionsMenu方法中的代碼,以顯示菜單。而menu屬性則可以覆蓋這種默認的行爲。
你還可以爲menu屬性定義多個菜單資源,不同的菜單資源之間用逗號隔開。
1
|
tools:menu= "menu_main,menu_edit" |
如果你不希望在預覽圖中顯示菜單則:
1
|
tools:menu= "" |
最後需要注意,當主題爲Theme.AppCompat時,這個屬性不起作用。
tools:actionBarNavMode
這個屬性告訴ide app bar(Material中對actionbar的稱呼)的顯示模式,其值可以是
1
2
3
|
standard tabs list |
1
2
3
4
5
6
|
<LinearLayout xmlns:android= "http://schemas.android.com/apk/res/android" android:orientation= "vertical" android:layout_width= "match_parent" android:layout_height= "match_parent" tools:actionBarNavMode= "tabs" /> |
同樣的,當主題是Theme.AppCompat (r21+, at least) 或者Theme.Material,或者使用了佈局包含Toolbar的方式。 該屬性也不起作用,只有holo主題纔有效。
listitem, listheader 和listfooter 屬性
顧名思義就是在ListView ExpandableListView等的預覽效果中添加頭部 尾部 以及子item的預覽佈局。
1
2
3
4
5
6
7
|
<GridView android:id= "@+id/list" android:layout_width= "match_parent" android:layout_height= "wrap_content" tools:listheader= "@layout/list_header" tools:listitem= "@layout/list_item" tools:listfooter= "@layout/list_footer" /> |
layout屬性
tools:layout告訴ide,Fragment在程序預覽的時候該顯示成什麼樣
1
2
3
4
5
6
7
8
9
|
<fragment xmlns:android= "http://schemas.android.com/apk/res/android" android:id= "@+id/item_list" android:name= "com.example.fragmenttwopanel.ItemListFragment" android:layout_width= "match_parent" android:layout_height= "match_parent" android:layout_marginLeft= "16dp" android:layout_marginRight= "16dp" tools:layout= "@android:layout/list_content" /> |
tools:showIn
該屬性設置於一個被其他佈局<include>的佈局的根元素上。這讓您可以指向包含此佈局的其中一個佈局,在設計時這個被包含的佈局會帶着周圍的外部佈局被渲染。這將允許您“在上下文中”查看和編輯這個佈局。需要 Studio 0.5.8 或更高版本。