[译]Android Tools属性

Android tools属性
https://developer.android.com/studio/write/tool-attributes.html

Android Studio在tools命名空间中支持一些XML属性来开关设计时功能和编译时行为。当构建应用时，编译工具会删除这些属性从而不会影响apk大小和运行行为。

为了使用这些属性，将tools命名空间添加到每个XML文件的根元素，使用方式如下：

<RootTag xmlns:android="http://schemas.android.com/apk/res/android"    xmlns:tools="http://schemas.android.com/tools" >

错误处理属性

以下属性帮着过滤lint警告消息。

tools:ignore

目标: 任何元素
使用: Lint
这个属性接收逗号分隔的lint问题ID列表
例如，可以告知tools忽略MissingTranslation错误

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

tools:targetApi

目标: 任何元素
使用: Lint
这个属性功能与Java代码中的@TargetApi注解相同：对元素指定支持的API级别。
告知tools，元素只用于指定的或更高的API级别。如果元素或它的属性在指定的minSdkVersion API级别不适用，它将停止lint产生警告。
例如因为GridLayout只适用于API级别14及以上，你可以使用它。

<GridLayout xmlns:android="http://schemas.android.com/apk/res/android"    xmlns:tools="http://schemas.android.com/tools"    tools:targetApi="14" >

tools:locale

目标: <resources>

使用: Lint, Android Studio编辑器
通知tools给定<resources>元素的默认语言/区域是什么，来避免拼写检查器的警告。该值必须是有效的区域设置限定符。
例如，可在values/strings.xml文件中添加来指定默认字符串的语言是西班牙语而不是英语：

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

设计时视图属性

以下属性定义了布局特性，这些特性只在Android Studio布局预览时可见。

tools: instead of android:

目标: <View>
使用: Android Studio布局编辑器
在布局预览中，使用前置tools:插入例子数据代替带属性android:。在开发期希望开到布局预览可以使用这个属性。
例如，在运行时设置android:text属性，或者希望查看非默认值得布局，可以添加tools:text来指定布局预览中显示。

可以同时添加android:和tools:命名空间的属性。
也可以使用tools:属性来在布局预览中取消一个属性。

<Button    android:id="@+id/button"    android:layout_width="wrap_content"    android:layout_height="wrap_content"    android:text="First" /><Button    android:id="@+id/button2"    android:layout_width="wrap_content"    android:layout_height="wrap_content"    android:text="Second"    tools:visibility="invisible"  />

tools:context

目标: 任何根<View>
使用: Lint, Android Studio布局编辑器
这个属性声明布局默认关联的Activity。这使得需要知晓Activity的功能在编辑器或布局预览可用。

可以使用manifest文件中的dot前缀指定Activity类名。

<android.support.constraint.ConstraintLayout    xmlns:android="http://schemas.android.com/apk/res/android"    xmlns:tools="http://schemas.android.com/tools"    tools:context=".MainActivity" >

tools:layout

目标: <fragment>
使用: Android Studio布局编辑器
这个属性声明哪个布局在布局预览时画到fragment中。
例如：

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

tools:listitem / tools:listheader / tools:listfooter

目标: <AdapterView> (<ListView>的子类)
使用: Android Studio布局编辑器
这个属性指定在布局预览中显示列表的项，头部和尾部的布局。
例如：

<ListView xmlns:android="http://schemas.android.com/apk/res/android"    xmlns:tools="http://schemas.android.com/tools"    android:id="@android:id/list"    android:layout_width="match_parent"    android:layout_height="match_parent"    tools:listitem="@layout/sample_list_item"    tools:listheader="@layout/sample_list_header"    tools:listitem="@layout/sample_list_footer" />

注意: 这个属性在Android Studio 2.2对ListView不工作，但在2.3中解决了(问题215172)。

tools:showIn

目的: 布局中的任何根<View>引用<include>

使用: Android Studio布局编辑器
允许指定一个布局就像include那样，这样可以预览这个文件就像他嵌入到父布局中。
例如：

<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" />

现在布局预览显示这个TextView布局好像它显示在activity_main不居中。

tools:menu

目的: 任何根<View>
使用: Android Studio布局编辑器
这个属性指定在布局预览的AppBar中显示的菜单。该值可意识1个活多个菜单ID，以逗号分隔。例如：

<?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" />

资源压缩属性

以下属性允许启用严格引用检查，并声明在使用资源缩减时是保留还是丢弃某些资源。
为了启动资源压缩，在build.gradle文件中设置shrinkResources为true。

android {    ...    buildTypes {        release {            shrinkResources true            minifyEnabled true            proguardFiles getDefaultProguardFile('proguard-android.txt'),                    'proguard-rules.pro'        }    }}

tools:shrinkMode

目标: <resources>
使用: 带资源压缩的构建工具
这个属性允许你指定构建工具是否使用“安全模式”或“严格模式”
模式使用安全模式(shrinkMode="safe")。为了使用严格模式，添加shrinkMode="strict"到<resources>标签，如下所示：

<?xml version="1.0" encoding="utf-8"?><resources xmlns:tools="http://schemas.android.com/tools"    tools:shrinkMode="strict" />

当启用严格模式，需要使用tools:keep来保持那些真实需要但被删除的资源，使用tools:discard来明确删除更多资源。
更多信息，参见压缩资源。

tools:keep

目标: <resources>
使用: 带资源压缩的构建工具
当使用资源压缩来删除无用资源时，这个属性允许保持指定资源。
为了使用它，在资源目录创建一个带<resources>标签的xml文件，由tools:keep属性指定每个要保持的资源并以逗号分隔。

<?xml version="1.0" encoding="utf-8"?><resources xmlns:tools="http://schemas.android.com/tools"    tools:keep="@layout/used_1,@layout/used_2,@layout/*_3" />

更多信息，参见压缩资源。

tools:discard

目标: <resources>
使用: 带资源压缩的构建工具
当使用资源压缩来删除无用资源时，这个资源允许手动指定要丢弃的资源。
为了使用它，在资源目录创建一个带<resources>标签的xml文件，由tools:keep属性指定每个要丢弃的资源并以逗号分隔。

<?xml version="1.0" encoding="utf-8"?><resources xmlns:tools="http://schemas.android.com/tools"    tools:discard="@layout/unused_1" />

更多信息，参见压缩资源。