一、tools 命名空间是啥？在哪里有？

在Android Studio 中，我们创建一个 xml 布局文件之后，通常在自动生成的代码中，会有一个 tools 命名空间： xmlns:tools="http://schemas.android.com/tools" 。之前一直不知道是干嘛用的，从来没有用过，然后要么手动删除，要么格式化代码的时候就自动把它删除了。直到今天翻看文档时才发现，这玩意儿竟然有大用途！

二、tools 命名空间的作用有哪些？

根据官方文档描述，根据其属性的功能类别，大致有三种主要功能：

• xml中的错误处理
• xml 预览
• 资源压缩

说的通俗一点就是：

• 减少或者避免黄线提示，让代码更清爽，让编译少报错
• 让预览界面更灵活，可以随心所欲的定制预览视图
• 压缩资源文件，降低APK体积。

三、tools 命名空间属性功能详解

该部分内容是基于官方文档的总结整理，由于个人水平有限，理解可能会有偏差，欢迎指正

（一）、xml 中的错误处理属性

1、tools:ignore

示例1：
Lint 检查时默认语言为 英文，如果在 xml 中有中文，就会报 MissingTranslation 错误，我们加上 tools:ignore 之后即可避免。

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

示例2：

image.png

2、tools:targetApi

示例：

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

3、 tools:locale

示例：
我们在 values/strings.xml中指明元素的语言版本。

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

（二）、xml视图预览相关属性

以下属性在xml中定义之后，只在预览时会展示，正式部署之后并不会展示。类似于 DataBindg 中引用字符串资源时的 default 属性。

1、用 tools:xxxx 替代 android:xxxx

示例代码1：
预览时展示指定文本

 <TextView
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        tools:text="欢迎关注 CnPeng 公众号"
       />

示例代码2：
tools:text 和 android:text 同时存在，在预览时会优先展示 tools:text

     <TextView
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        tools:text="这些在预览时展示，并会在预览时优先于 android:text 展示"
        android:text="这些在部署之后会展示"
       />

2、tools:context

示例代码：
先声明关联的activity，然后直接写 onclick 方法名，然后按下自动完成代码的快捷键，就会提示在对应的activity中创建该方法。

3、tools:itemCount

示例代码：
预览界面展示 4个 条目

4、tools:layout

示例代码：
在预览时将 testlayout 这个布局文件填充到fragment。testlayout的布局中包含一个 RecyclerView，并通过 itemCount 设置的预览时展示的条数为4（参考 tools:itemCount）

5、tools:listitem 、 tools:listheader 、 tools:listfooter

示例代码：
这里略微有点尴尬，listfooter 在预览时并没有展示出来，不知道是不是我操作的姿势不对

item_spinner.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:layout_width="match_parent"
    android:layout_height="match_parent"
    android:gravity="center_vertical"
    android:orientation="horizontal">
    
    <ImageView
        android:layout_width="@dimen/dp50"
        android:layout_height="@dimen/dp50"
        android:src="@drawable/logo"
        tools:ignore="ContentDescription"/>

    <!--ignore 后面根由多个错误id时，用逗号分隔 ； -->
    <TextView
        android:id="@+id/tv_item_suspendRv"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_marginRight="@dimen/dp10"
        android:gravity="center_vertical"
        android:text="abc"
        tools:ignore="HardcodedText,RtlHardcoded"/>

    <!--使用 tools:text 设置预览文本-->
    <TextView
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        tools:text="这是设置的预览文本"/>
</LinearLayout>

注意
如果 条目布局中有 TextView及其子类控件

• 如果设置了 tools:text , 在预览时会优先展示该值；
• 如果没有设置 tools:text ，但设置了 android:text , 在预览时就会展示android:text 的属性值；
• 如果都没有设置，则会默认使用 item1、item2 填充到 TextView中作为预览文本

6、 tools:showIn

示例代码：

testlayout2.xml 将会被 testlayout 引用。

testlayout2.xml

<?xml version="1.0" encoding="utf-8"?>
<TextView
    android:id="@+id/testFragment"
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    tools:showIn="@layout/testlayout"
    tools:text="预览文本">

</TextView>

testlayout.xml

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent">
    <include layout="@layout/testlayout2"/>
    
</LinearLayout>

通过这种方式我们在确认该布局文件在哪里使用了的时候就比较方便了。但是：

如果该布局文件被多处 include 引用时，tools:showIn 该怎么写呢？哪位朋友知道烦请告知。

7、 tools:menu

注意：按照官方文档的说明，可以传入多个 menu id 。但是实际测试时发现，传入多个时右上角并没有什么不同的显示。

8、 tools:minValue / tools:maxValue

示例说明：

这个加完之后，并没有看到什么特殊效果。

9、 tools:openDrawer

注意：
1、在 <DrawerLayout > 需要通过 layout_gravity 声明哪一部分作为侧拉窗口，其取值也是 end、start、left、right。
2、tools:openDrawer 的取值必须与侧拉窗口的 layout_gravity 的取值一致

代码示例：

<?xml version="1.0" encoding="utf-8"?>

<!--此处 openDrawer 的取值必须与侧拉窗口的 layout_gravity 取值一致-->
<android.support.v4.widget.DrawerLayout
    android:id="@+id/numberPicker"
    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"
    tools:openDrawer="right">

    <!--这是未展示侧拉界面时的主体内容-->
    <RelativeLayout android:layout_width="match_parent"
                    android:layout_height="match_parent">
        <TextView
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:layout_centerInParent="true"
            tools:text="这是主内容"/>
    </RelativeLayout>

    <!--这是侧拉窗口中的内容。必须通过 layout_gravity 属性声明这是一个侧拉展示的内容-->
    <RelativeLayout
        android:layout_width="100dp"
        android:layout_height="match_parent"
        android:layout_gravity="right"
        android:background="#f2e67b">
        <TextView
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:layout_centerInParent="true"
            android:ems="1"
            tools:text="这是要侧拉的东西"/>
    </RelativeLayout>
</android.support.v4.widget.DrawerLayout>

10、 "@tools:sample/*" 资源

示例代码：

在下面的预览图中，图标和文本都是直接引用的系统预置的。

(三)、资源压缩相关属性 (Resource shrinking attributes)

下面这些属性，可以让我们在 资源压缩时确定哪些资源可以保留或者丢弃，也可以让我们开启严格模式的资源引用检查。 The following attributes allow you to enable strict reference checks and declare whether to keep or discard certain resources when using resource shrinking

开启资源压缩时，在 module 的build.gradle 文件作如下修改：

android {
    buildTypes {
        release {
            shrinkResources true    //开启资源压缩。minifyEnabled 也必须为true,否则编译不通过
            minifyEnabled true     //开启代码混淆/压缩
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
        }
    }
}

1、 tools:shrinkMode

默认是 safe 模式 (即shrinkMode="safe"). 如果想使用 strict 模式，需要在<resources>节点中显示声明 shrinkMode="strict"，具体如下：

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

开启 strict 模式之后, 可以使用 tools:keep 保留那些你不想被移除的资源, 或者使用tools:discard 直接移除资源

2、 tools:keep

使用时，在 resources 目录下创建一个 xml 文件并指定名称，如：res/raw/keep.xml。创建一个<resources> 节点，并为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" />

3、 tools:discard

当使用资源压缩工具去除一些无用资源时，使用该属性可以指明一些需要手动删除的资源 (比如：被引用了但是未能生效的资源，或者 Gradle 插件误引用了某些资源被引用).

使用时，在 resources 目录下创建一个 xml 文件并指定名称，如：res/raw/keep.xml。创建一个<resources> 节点，并为tools:keep赋值，其值代表将被保留的资源，多个资源之间使用逗号间隔，也可以使用 * 作为通配符，示例如下：

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

四、参考资源：

tools 命名空间的官方文档：
https://developer.android.google.cn/studio/write/tool-attributes.html

命名空间介绍：
http://blog.csdn.net/p106786860/article/details/53943540

注解参考：
https://developer.android.google.cn/studio/write/annotations.html?hl=zh-cn

lint 参考：
https://developer.android.google.cn/studio/write/lint.html?hl=zh-cn

资源压缩shrink-resources：
https://developer.android.com/studio/build/shrink-code.html?hl=zh-cn#shrink-resources

本文到此结束，谢谢观看！
如有不足，敬请指正！