Android 开发小工具之：Tools 属性 （转）

Posted 2020-09-03 从Android出发

android 开发小工具之：Tools 属性

http://blog.chengyunfeng.com/?p=755#ixzz4apLZhfmi

今天来介绍一些 Android 开发过程中比较有用但是大家又不常用的小工具。这些小工具可以提高 Android 应用开发的效率、还可以提高代码质量。所以还是有必要使用的。

首先介绍布局文件中的 tools 属性。

如果你用 Android Studio 创建一个简单的示例项目，在生成的布局文件中会有这么一行内容：

xmlns:tools=”http://schemas.android.com/tools”

在 tools 命名空间下定义了一些属性就是我们要介绍的 tools 属性。 顾名思义，这些属性都是为编辑工具准备的，具体来说就是 Android Studio 和布局文件编译器（AAPT）。 在开发程序的时候，通过这些属性来告诉编辑器一些额外的信息。

tools:ignore

这个属性是为 Lint 准备的，属性的取值为逗号分隔的 Lint 问题 ID。告诉 Lint 在检测代码的时候，这些问题不用检测。例如：

<string name=”show_all_apps” tools:ignore=”MissingTranslation”>All</string>

tools:targetApi

这个属性也是为 Lint 准备的。和 Java 注解 @TargetApi 一样。取值可以为 Android 版本代号或者对应的整数值。例如：

<GridLayout tools:targetApi=”ICE_CREAM_SANDWICH” >

tools:locale

Lint 和 Android Studio 都会使用该属性。取值为 语言和地区缩写。如果设置该值为非英文类型，则 Studio 不会执行拼写检查。该属性通常出现在资源文件的根元素上。用来告诉 Lint 该文件应该用在那种语言环境中。 例如：values/strings.xml 文件 设置该属性为 es

<resources xmlns:tools=”http://schemas.android.com/tools” tools:locale=”es”>

上面的设置告诉工具，默认的文件夹中的资源为西班牙语而不是英语。

tools:context

Lint 和 Android Studio 都会使用该属性。出现在布局根元素中，用来告诉工具该布局文件和哪个 Activity 关联。这样在设计的时候，布局编辑器会使用相关联的 Activity 的 theme 来渲染该布局文件。取值为 manifests 文件中的 activity name 值一样。例如：

<android.support.v7.widget.GridLayout xmlns:android=”http://schemas.android.com/apk/res/android” xmlns:tools=”http://schemas.android.com/tools”tools:context=”.MainActivity” … >

tools:layout

该属性由 Android Studio 使用。通常用在 <fragment> 元素中，用来告诉编辑器该 fragment 使用的是哪个布局文件。

<fragment android:name=”com.example.master.ItemListFragment” tools:layout=”@android:layout/list_content” />

tools:listitem / listheader / listfooter

Android Studio 使用该属性来渲染列表元素。可以用在 AdapterView 的子 View 中。例如 <ListView>、<GridView>、<ExpandableListView> 等。这样在设计的时候，编辑器可以用指定的内容来显示预览内容。

<ListView

android:id=”@android:id/list”

android:layout_width=”match_parent”

android:layout_height=”match_parent”

tools:listitem=”@android:layout/simple_list_item_2″ />

tools:showIn

Android Studio 使用该属性。通常用在被其他布局文件引用的<include> 布局文件中。告诉编辑器该布局文件用在另外一个布局文件中。例如

<?xml version=”1.0″ encoding=”utf-8″?>

<TextView xmlns:android=”http://schemas.android.com/apk/res/android”

xmlns:tools=”http://schemas.android.com/tools”

android:text=”@string/hello_world”

android:layout_width=”wrap_content”

android:layout_height=”wrap_content”

tools:showIn=”@layout/activity_main” />

tools:menu

Android Studio 使用该属性。用在布局文件的根元素中，告诉编辑器在 ActionBar 上的菜单内容。取值为定义的 menu 的 id，多个 id 用逗号分隔；还可以使用定义 menu 的 xml 文件的名字。例如：

<?xml version=”1.0″ encoding=”utf-8″?>

<LinearLayout xmlns:android=”http://schemas.android.com/apk/res/android”

xmlns:tools=”http://schemas.android.com/tools”

android:orientation=”vertical”

android:layout_width=”match_parent”

android:layout_height=”match_parent”

tools:menu=”menu1,menu2″ />

tools:actionBarNavMode

Android Studio 使用该属性。用在布局文件的根元素中，告诉编辑器在 ActionBar 上的导航模式。取值为 “standard”、 “list” 和”tabs” 之一。

<?xml version=”1.0″ encoding=”utf-8″?>

<LinearLayout xmlns:android=”http://schemas.android.com/apk/res/android”

xmlns:tools=”http://schemas.android.com/tools”

android:orientation=”vertical”

android:layout_width=”match_parent”

android:layout_height=”match_parent”

tools:actionBarNavMode=”tabs” />

除了上面这些属性以外，标准的 Android 布局属性都可以当做 tools 属性来使用。布局编辑器用这些属性来选择布局文件。这些属性被称之为 “ 设计时布局属性 ”，他们只被布局编辑器使用，编译后的代码中不存在这些内容。

例如

<RelativeLayout
	xmlns:android="http://schemas.android.com/apk/res/android"
	xmlns:tools="http://schemas.android.com/tools"
	android:layout_width="match_parent"
	android:layout_height="match_parent"
	android:paddingLeft="@dimen/activity_horizontal_margin"
	android:paddingRight="@dimen/activity_horizontal_margin"
	android:paddingTop="@dimen/activity_vertical_margin"
	android:paddingBottom="@dimen/activity_vertical_margin"
	tools:context=".MainActivity">
    <TextView
	    android:text="@string/hello_world"
	    tools:text="hello world"
	    android:layout_width="wrap_content"
	    tools:layout_width="400dp"
	    tools:background="@android:color/holo_red_dark"
	    android:layout_height="wrap_content"/>
</RelativeLayout>
上面的布局文件，在布局编辑器中预览图如下：

 这样做的好处是，在编辑布局文件的时候，不用为了预览效果而给真正的属性设置一些测试的值，然后当程序发布的时候，
这些测试的内容忘记删除了。例如
为了预览 EditText 的显示效果，你把一段文字设置到 text属性上：
<EditText
	android:text="John Doe"
	android:layout_width="wrap_content"
	android:layout_height="wrap_content" />

当你发布项目的时候，却忘记了把该字符串给删除了。 如果这里面包含有比较机密的内容的话，你的秘密就被泄露出去了。 你可以用

tools:text="John Doe" 

这样在发布的时候，这些内容会自动去掉。

设计时布局属性的限制：

•  目前只支持标准的属性，也就是依 android 命名空间下的属性。
•  目前代码提示支持的还不是很好，建议先用 android 命名空间来编辑该属性，然后把 android 替换为 tools。
•  设计时布局属性只能在布局文件中使用，不能在其他资源文件中使用。
•  这类还有一些问题需要注意： https://code.google.com/p/android/issues/detail?id=46186