Android Studio 添加应用资源

前一小节我们介绍了如何使用 Android Studio 布局编辑器，本小结我们学习 Android 的应用资源类型、备用资源限定和资源合并相关的知识。

1. 应用资源的类型

应用资源是指代码使用的附加文件和静态内容，例如位图、布局定义、界面字符串、动画等。应用资源分很多种：

• 动画资源：定义预先确定的动画，补间动画保存在 res/anim/ 中，帧动画保存在 res/drawable/ 中；

• 颜色状态列表资源：定义根据 View 状态而变化的颜色资源，保存在 res/color/ 中；

• 可绘制资源：使用位图或 XML 定义各种图形，保存在 res/drawable/ 中；

• 布局资源：定义应用界面的布局，保存在 res/layout/ 中；

• 菜单资源：定义应用菜单的内容，保存在 res/menu/ 中；

• 字符串资源：定义字符串、字符串数组，保存在 res/values/ 中；

• 样式资源：定义界面元素的外观和格式，保存在 res/values/ 中；

• 字体资源：在 XML 中定义字体系列并包含自定义字体，保存在 res/font/ 中。

我们应将各类资源放入项目 res/ 目录的特定子目录中。例如，以下是一个简单项目的文件层次结构：

FirstApp/
    src/
        MainActivity.java
    res/
        drawable/
            graphic.png
        layout/
            main.xml
            info.xml
        mipmap/
            icon.png
        values/
            strings.xml

Tips：res/ 目录包含所有资源：一个图像资源、两个布局资源、启动器图标资源以及一个字符串资源文件。

资源目录名称非常重要，项目 res/ 目录中支持的资源目录见下表：

上表所列的目录中，保存的资源为“默认”资源，即这些资源定义应用的默认设计和内容，除默认资源以外，我们还需提供备用资源。

2. 应用备用资源

不同类型的 Android 设备可能需要不同类型的资源。例如，如果设备屏幕比标准屏幕大，则应提供不同的布局资源，从而充分利用额外的屏幕空间；如果设备的语言设置不同，则应提供不同的字符串资源，以便将界面中的文本转换为其他语言。在运行时，Android 会检测当前设备配置并为应用加载合适的资源。

我们如何为一组资源指定配置特定的备用资源呢？分两步：

1. 在 res/ 中创建以 < resources_name >-< config_qualifier > 形式命名的新目录；
   • < resources_name > 是相应默认资源的目录名称；
   • < config_qualifier > 是指定要使用这些资源的各个配置限定符的名称。
2. 将相应的备用资源保存在此新目录下,这些资源文件必须与默认资源文件完全同名。

例如，以下是一些默认资源和屏幕像素密度备用资源：

res/
    drawable/
        icon.png
        background.png
    drawable-hdpi/
        icon.png
        background.png

hdpi 限定符表示该目录中的资源适用于屏幕密度较高的设备。其中，每个可绘制对象目录中的图像均已针对特定的屏幕密度调整了大小，但文件名完全相同。如此一来，用于引用 icon.png 或 background.png 图像的资源 ID 始终相同，但 Android 会通过将设备配置信息与资源目录名称中的限定符进行比较，选择最符合当前设备的各个资源版本。

Android 支持若干配置限定符，我们可以通过使用短划线分隔每个限定符，从而向一个目录名称添加多个限定符。下表按优先级顺序列出了有效的配置限定符；如果对资源目录使用多个限定符，则必须按照表中所列顺序将其添加到目录名称中。

3. 添加应用资源

Android Studio 可以帮助我们通过多种方式添加新资源和备用资源，具体取决于我们要添加的资源的类型。接下来我们学习如何添加基本的资源文件、如何更改资源的位置以及资源合并的原理。

3.1 添加 XML 资源文件

如果我们需要添加任何 XML 资源文件，请按照以下步骤操作：

点击 Project 窗口中的目标应用模块（在 Android 或 Project 视图中时），然后依次选择 File > New > Android resource file；

在对话框中填写详细信息：

• File name：输入 XML 文件的名称（不需要输入 .xml 后缀）；

• Resource type：选择要创建的资源的类型；

• Root element：为文件选择根 XML 元素（如果适用）。某些资源类型仅支持一种类型的根元素，因此这项可能无法修改，具体取决于上面选择的资源类型；

• Source set：选择要将文件保存到的源代码集；

• Directory name：目录命名方式必须特定于资源类型和配置限定符；

• Available qualifiers：我们可以选择左侧列表中的限定符。

添加完所需的所有限定符之后，点击 OK。

3.2 添加资源目录

如果我们需要添加新的资源目录，请按照以下步骤操作：

点击 Project 窗口中的目标应用模块，然后依次选择 File > New > Android resource directory；

在对话框中填写详细信息：

• Directory name：目录命名方式必须特定于资源类型以及配置限定符的组合。

• Resource type：选择要创建的资源的类型。

• Source set：选择要将布局保存到的源代码集。

• Available qualifiers：我们可以选择左侧列表中的限定符。
  添加完所需的所有限定符之后，点击 OK。

3.3 更改资源目录

默认情况下，我们的资源位于 module-name/src/source-set-name/res/。例如，模块的主源代码集的资源位于 src/main/res/，调试源代码集的资源则位于 src/debug/res/。

不过，我们可以使用 sourceSets {} 块中的 res.srcDirs 属性将这些路径更改为任何其他位置（相对于 build.gradle 文件）。例如：

android {
    sourceSets {
        main {
            res.srcDirs = ['resources/main']
        }
        debug {
            res.srcDirs = ['resources/debug']
        }
    }
}

我们还可以为一个源代码集指定多个资源目录，构建工具会将它们合并在一起。例如：

android {
    sourceSets {
        main {
            res.srcDirs = ['res1', 'res2']
        }
    }
}

3.4 资源合并原理

最终 APK 文件中的资源可能有 3 个不同的来源：

• 主源代码集（通常位于 src/main/res/）；

• 构建变体源代码集；

• Android 库 (AAR)。

如果来自各个源代码集或库的所有资源都是唯一的，则它们均会添加到最终 APK 中。如果某项资源的文件名在其资源类型目录和资源限定符（如果已定义）中都是唯一的，系统即会将该资源视为唯一的。

如果存在同一资源的两个或多个匹配版本，则只有一个版本会包含在最终 APK 中。构建工具会根据以下优先级顺序（左侧的优先级最高）选择要保留的版本：

构建变体 > build 类型 > 产品变种 > 主源代码集 > 库依赖项

例如，如果主源代码集包含：

• res/layout/foo.xml

• res/layout-land/foo.xml

并且调试 build 类型包含：

• res/layout/foo.xml

则最终 APK 会包括来自调试 build 类型的 res/layout/foo.xml 和来自主源代码集的 res/layout-land/foo.xml。

Tips：当我们的构建配置为一个给定的源代码集指定了多个资源文件夹时，如果这些来源之间存在冲突，则会发生错误，并且合并会失败，因为各个资源目录的优先级相同。

4. 小结

本节课程我们主要学习了 Android 的应用资源类型、备用限定及如何添加资源。本节课程的重点如下：

• 掌握应用资源的分类和备用资源限定符；
• 掌握添加资源和资源合并的原理。