应用资源概览

资源是指代码使用的附加文件和静态内容，例如位图、界面字符串、动画说明等。

请始终将应用资源（例如图片和字符串）与代码分隔开，以便能够独立地维护这些资源。此外，还应为特定设备配置提供备用资源，方法是将其进行分组并放入专门命名的资源目录中。在运行时，Android 会根据当前配置使用合适的资源。例如，您可能想根据语言设置提供不同的字符串。

外部化应用资源后，您便可使用在项目的 R 类中生成的资源 ID 来访问相应资源。本文档介绍了如何对 Android 项目中的资源进行分组。此外，还介绍了如何为特定设备配置提供备用资源，以及如何从您的应用代码或其他 XML 文件访问这些资源。

分组资源类型

将每种类型的资源放在项目的 res/ 目录下的相应子目录中。例如，以下是一个简单项目的文件层次结构：

MyProject/
    src/
        MyActivity.kt
    res/
        drawable/
            graphic.png
        mipmap/
            icon.png
        values/
            strings.xml

res/ 目录中包含存储在其子目录中的所有资源，包括一个图片资源、一个用于存储启动器图标的 mipmap/ 目录，以及一个字符串资源文件。资源目录名称非常重要，具体说明请参见表 1。

注意：如需详细了解如何使用 mipmap 文件夹，请参阅将应用图标放在 mipmap 目录中。

表 1. 项目 res/ 目录中支持的资源目录。

目录 资源类型
drawable/

位图文件（PNG、.9.png、JPG 或 GIF）或编译为以下可绘制资源子类型的 XML 文件：

  • 位图文件
  • 九宫图（可调整大小的位图）
  • 状态列表
  • 形状
  • 动画可绘制对象
  • 其他可绘制对象

如需了解详情，请参阅可绘制资源。
mipmap/ 适用于不同启动器图标密度的可绘制对象文件。如需详细了解如何使用 mipmap/ 文件夹管理启动器图标，请参阅将应用图标放在 mipmap 目录中。
raw/

需以原始形式保存的任意文件。如要使用原始 InputStream 打开这些资源，请使用资源 ID（即 R.raw.filename）调用 Resources.openRawResource。

但是，如需访问原始文件名和文件层次结构，请考虑将资源保存在 assets/ 目录（而非 res/raw/）下。assets/ 中的文件没有资源 ID，因此您只能使用 AssetManager 读取这些文件。
values/

包含字符串、整数和颜色等简单值的 XML 文件。

其他 res/ 子目录中的 XML 资源文件会根据 XML 文件名定义单个资源，而 values/ 目录中的文件可描述多个资源。对于此目录中的文件，<resources> 元素的每个子元素均会定义一个资源。例如，<string> 元素会创建一个 R.string 资源，<color> 元素会创建一个 R.color 资源。

由于每个资源均使用自己的 XML 元素进行定义，因此您可以随意命名文件，并在同一文件中放入不同的资源类型。但是，您可能需要将不同的资源类型分别放在不同的文件中，使其一目了然。例如，对于可在此目录中创建的资源，下面给出了相应的文件名约定：

如需了解详情，请参阅字符串资源、样式资源和更多资源类型。
xml/ 可在运行时通过调用 Resources.getXML 读取的任意 XML 文件。各种 XML 配置文件都必须保存在此处。
font/ 带有扩展名的字体文件（例如 TTF、OTF 或 TTC），或包含 <font-family> 元素的 XML 文件。如需详细了解以资源形式使用的字体，请参阅将字体添加为 XML 资源。

注意：切勿将资源文件直接保存在 res/ 目录内，否则会导致编译器错误。

在表 1 定义的子目录中，保存的资源为默认资源。换言之，这些资源定义应用的默认设计和内容。然而，不同类型的 Android 设备可能需要不同类型的资源。

例如，您可以提供不同的字符串资源，以便根据设备的语言设置翻译界面中的文本。

注意：在 Compose 中，界面、动画和状态驱动的颜色是在 Kotlin 中声明的，因此 layout/、menu/、anim/、animator/ 和 color/ 目录对于现代应用来说已过时。如需了解详情，请参阅 Compose 中的动画和 Compose 中主题的剖析。

提供备用资源

大多数应用都提供备用资源，以便支持特定的设备配置。例如，对于不同的屏幕密度和语言，分别添加备用可绘制资源和备用字符串资源。在运行时，Android 会检测当前设备配置并为应用加载合适的资源。

如需为一组资源指定适用于特定配置的备用资源，请执行以下操作：

  1. 在 res/ 中创建以 <resources_name>-<qualifier> 形式命名的新目录。
    • <resources_name> 是相应默认资源的目录名称（如表 1 中所定义）。
    • <qualifier> 是一个名称，用于指定要使用这些资源的各个配置（如表 2 中所定义）。

    您可以在末尾追加多个 <qualifier>，并使用短划线进行分隔。

    注意：在末尾追加多个限定符时，必须按照表 2 中列出的相同顺序放置限定符。如果限定符的顺序错误，则相应资源将被忽略。

  2. 将相应的备用资源放入这个新建的目录中。这些资源文件必须与默认资源文件完全同名。

例如，以下是一些默认资源和备用资源：

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

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

注意：定义备用资源时，请确保也在默认配置中定义该资源。否则，当设备更改配置时，您的应用可能会遇到运行时异常。例如，如果您仅向 values-en（而不是 values）添加字符串，则当用户更改默认系统语言时，您的应用可能会出现 Resource Not Found 异常。

表 2 按优先级顺序列出了配置限定符。您可以通过使用短划线分隔每个限定符，从而向一个目录名称添加多个限定符。如果对资源目录使用多个限定符，则必须按照表中所列顺序将相应限定符添加到目录名称中。

表 2. 配置限定符名称。

配置 限定符值 说明
MCC 和 MNC 示例：
mcc310
mcc310-mnc004
mcc208-mnc00

移动设备国家/地区代码 (MCC)，（可选）后跟设备 SIM 卡中的移动网络代码 (MNC)。例如，mcc310 是指美国的任一运营商，mcc310-mnc004 是指美国的 Verizon 公司，而 mcc208-mnc00 是指法国的 Orange 公司。

如果设备使用无线电连接（即为 GSM 手机），则 MCC 和 MNC 值来自 SIM 卡。

您也可以单独使用 MCC，例如，将国家/地区特定的合法资源加入应用。如果只需根据语言指定，则改用语言、脚本（可选）和区域（可选）限定符（稍后进行介绍）。如果使用 MCC 和 MNC 限定符，请谨慎执行此操作并测试限定符是否按预期工作。

另请参阅配置字段 mcc 和 mnc，二者分别表示当前的移动设备国家/地区代码和移动网络代码。
语言、脚本（可选）和区域（可选） 示例：
en
fr
en-rUS
fr-rFR
fr-rCA
b+en
b+en+US
b+es+419
b+zh+Hant
b+sr+Latn+RS

语言通过由两个字母组成的 ISO 639-1 语言代码进行定义，可以选择后跟两个字母组成的 ISO 3166-1-alpha-2 区域码（前缀用小写字母 r）。

这些代码不区分大小写。r 前缀用于区分区域码。您不能单独指定区域。

Android 7.0（API 级别 24）引入对 BCP 47 语言标记的支持，可供您用来限定特定于语言和区域的资源。语言标记由一个或多个子标记序列组成，每个子标记都能优化或缩小由整体标记标识的语言范围。如需了解有关语言标记的详细信息，请参阅用于标识语言的标记。

如要使用 BCP 47 语言标记，请将 b+ 和两个字母的 ISO 639-1 语言代码串联；其后还可选择使用其他子标记，用 + 分隔即可。

如果用户在系统设置中更改语言，则语言标记可能会在应用的生命周期中发生变更。如需了解这会在运行时期间给应用带来哪些影响，请参阅处理配置更改。

如需查看将应用本地化为其他语言的完整指南，请参阅本地化您的应用。

另请参阅 getLocales 方法，了解该方法提供的已定义语言区域列表。此列表包含主要的语言区域。
语法性别 masculine
feminine
neuter

用户的语法性别。适用于具有语法性别的语言。

例如，如果您需要为讲法语的用户提供不同的资源，则可以使用以下目录：

res/
  values-fr/
    strings.xml（未指定适用性别的默认字符串）
  values-fr-masculine/
    strings.xml（男性字符串）
  values-fr-feminine/
    strings.xml（女性字符串）
  values-fr-neuter/
    strings.xml（中性字符串）

请参阅使用语法性别对应用界面进行个性化设置。

另请参阅 getGrammaticalGender 配置方法，该方法用于指示语法性别。

在 API 级别 34 中引入。
广色域 widecg
nowidecg
  • widecg：显示广色域，如 Display P3 或 AdobeRGB
  • nowidecg：显示窄色域，如 sRGB

此项为 API 级别 26 中的新增配置。

另请参阅 isScreenWideColorGamut 配置方法，该方法用于指示屏幕是否具有广色域。
高动态范围 (HDR) highdr
lowdr
  • highdr：显示高动态范围
  • lowdr：显示低/标准动态范围

此项为 API 级别 26 中的新增配置。

另请参阅 isScreenHdr 配置方法，该方法用于指示屏幕是否具有 HDR 功能。
界面模式 car
desk
television
appliance
watch
vrheadset
  • car：设备正在车载基座中显示
  • desk：设备正在桌面基座中显示
  • television：设备正在通过电视显示内容，通过将界面投影到离用户较远的大屏幕上，为用户提供“十英尺”体验。该体验主要面向遥控交互或其他非触控式交互
  • appliance：设备用作不带显示屏的装置
  • watch：设备配有显示屏，并且可戴在手腕上
  • vrheadset：设备正在通过虚拟现实耳机显示内容

此项为 API 级别 8 中的新增配置；API 13 中的新增电视配置；API 16 中的新增设备配置；API 20 中的新增手表配置；API 26 中的新增 VR 头戴式设备配置。

如需了解在设备插入基座或从基座中取出时您的应用会如何响应，请参阅确定和监控插接状态和基座类型。

如果用户将设备插入基座，此配置可能会在应用生命周期中发生变化。您可以使用 UiModeManager 启用或停用其中的部分模式。如需了解这会在运行时期间给应用带来哪些影响，请参阅处理配置更改。
夜间模式 night
notnight
  • night：夜晚时光
  • notnight：日间节目

此项为 API 级别 8 中的新增配置。

如果夜间模式停留在自动模式（默认），此配置可能会在应用生命周期中发生变化。在这种情况下，该模式会根据当天的时间进行调整。您可以使用 UiModeManager 启用或停用此模式。如需了解这会在运行时期间给应用带来哪些影响，请参阅处理配置更改。
屏幕像素密度 (dpi) ldpi
mdpi
hdpi
xhdpi
xxhdpi
xxxhdpi
nodpi
tvdpi
anydpi
nnndpi
  • ldpi：低密度屏幕；约为 120 dpi。
  • mdpi：中密度（传统 HVGA）屏幕；约为 160 dpi。
  • hdpi：高密度屏幕；约为 240 dpi。
  • xhdpi：超高密度屏幕；约为 320 dpi。此项为 API 级别 8 中的新增配置。
  • xxhdpi：超超高密度屏幕；约为 480 dpi。此项为 API 级别 16 中的新增配置。
  • xxxhdpi：超超超高密度屏幕使用（仅限启动器图标，请参阅支持不同的像素密度）；约为 640 dpi。此项为 API 级别 18 中的新增配置。
  • nodpi：用于您不希望为匹配设备密度而进行缩放的位图资源。
  • tvdpi：密度介于 mdpi 和 hdpi 之间的屏幕；约为 213 dpi。 这不属于“主要”密度组。它主要用于 720p 电视，而大多数应用都不需要它。对于 1080p 电视面板，请使用 xhdpi；对于 4K 电视面板，请使用 xxxhdpi。此项为 API 级别 13 中的新增配置。
  • anydpi：适合所有屏幕密度，其优先级高于其他限定符。这对于矢量可绘制对象非常有用。此项为 API 级别 21 中的新增配置。
  • nnndpi：用于表示非标准密度，其中 nnn 是正整数屏幕密度。大多数情况下不使用此限定符。使用标准密度存储分区，可显著减少因支持市场上各种设备屏幕密度而产生的开销。

这六种主要密度之间的缩放比例为 3:4:6:8:12:16（tvdpi 密度忽略不计）。因此，9x9 (ldpi) 位图相当于 12x12 (mdpi)、18x18 (hdpi)、24x24 (xhdpi) 位图，依此类推。

注意：使用密度限定符并不意味着资源仅适用于该密度的屏幕。如果您没有为备用资源提供最符合当前设备配置的限定符，则系统会使用其中最匹配的资源。

如需详细了解如何处理不同屏幕密度以及 Android 如何缩放位图以适应当前密度，请参阅屏幕兼容性概览。
触摸屏类型 notouch
finger
  • notouch：设备没有触摸屏。
  • finger：设备有一个专供用户通过手指直接与其交互的触摸屏。

另请参阅 touchscreen 配置字段，该字段用于指示设备的触摸屏类型。
键盘可用性 keysexposed
keyshidden
keyssoft
  • keysexposed：设备具有可用的键盘。如果设备启用了软件键盘（不无可能），那么即使用户未找到硬件键盘，或者该设备没有硬件键盘，也可使用此限定符。如果设备未提供软件键盘或软件键盘已停用，则只有在向用户公开硬件键盘时，才可使用此限定符。
  • keyshidden：设备具有可用的硬件键盘，但其处于隐藏状态，且设备未启用软件键盘。
  • keyssoft：设备已启用软件键盘（无论是否可见）。

如果您提供了 keysexposed 资源，但未提供 keyssoft 资源，则无论键盘是否可见，只要系统已启用软件键盘，其便会使用 keysexposed 资源。

如果用户打开硬件键盘，此配置可能会在应用生命周期中发生变化。如需了解这会在运行时期间给应用带来哪些影响，请参阅处理配置更改。

另请参阅配置字段 hardKeyboardHidden 和 keyboardHidden，这两个字段分别用于指示硬件键盘的可见性和任一键盘（包括软件键盘）的可见性。
主要的文本输入法 nokeys
qwerty
12key
  • nokeys：设备没有用于文本输入的硬件按键。
  • qwerty：设备具有硬件 QWERTY 键盘（无论其对用户是否可见）。
  • 12key：设备具有包含 12 个按键的硬件键盘（无论其对用户是否可见）。

另请参阅 keyboard 配置字段，该字段用于指示可用的主要文本输入法。
平台版本（API 级别） 示例：
v3
v4
v7
等等

设备支持的 API 级别。例如，v1 对应 API 级别 1（搭载 Android 1.0 或更高版本的设备）；v4 对应 API 级别 4（搭载 Android 1.6 或更高版本的设备）。如需了解有关这些值的详细信息，请参阅 Android API 级别文档。

注意：并非所有版本的 Android 系统都支持所有限定符。使用新限定符会隐式添加平台版本限定符，因此较旧版本系统的设备可以忽略它。为避免出现任何问题，请始终包含一组默认资源（一组不包含任何限定符的资源）。如需了解详情，请参阅利用资源提供最佳的设备兼容性部分。

在 Compose 应用中，不需要与布局和尺寸相关的配置限定符。虽然它们仍然存在，但已从表 2 中排除。这些限定符包括：布局方向、最小宽度、可用宽度、可用高度、屏幕尺寸、屏幕宽高比、圆形屏幕和屏幕方向。如需查看按优先级排序的配置限定符的完整表格，请参阅应用资源概览（视图）。

限定符命名规则

以下是一些使用配置限定符名称时需遵循的规则：

  • 您可以为单组资源指定多个限定符，并使用短划线分隔。例如，drawable-en-rUS-night 适用于处于夜间模式且语言为美式英语的设备。
  • 这些限定符必须遵循表 2 中列出的顺序。
    • 错误：drawable-hdpi-night/
    • 正确：drawable-night-hdpi/
  • 不得嵌套备用资源目录。例如，您的目录不能为 res/drawable/drawable-en/。
  • 值不区分大小写。资源编译器会在处理之前将目录名称转换为小写形式，以避免在不区分大小的文件系统中出现问题。名称中使用的所有大写字母只是为了便于认读。
  • 每种限定符类型仅支持一个值。例如，如需针对西班牙语和法语使用相同的可绘制对象文件，则您不能拥有名为 drawable-es-fr/ 的目录，而是需要两个包含相应文件的资源目录，如 drawable-es/ 和 drawable-fr/。

将备用资源保存到以这些限定符命名的目录后，Android 系统会基于当前设备配置自动使用您应用中的资源。在每次请求资源时，Android 系统会检查包含所请求资源文件的备用资源目录，然后寻找最匹配的资源。

如果没有与特定设备配置匹配的备用资源，则 Android 系统会使用相应的默认资源（一组不包含配置限定符的特定类型的资源）。

创建别名资源

如果您想将某一资源用于多种设备配置，但不想以默认资源的形式提供该资源，则无需将同一资源放入多个备用资源目录中。不过，您可以创建备用资源，充当默认资源目录中所保存资源的别名。

可绘制对象

例如，假设您有一个应用图标 icon.png，并且需要针对不同语言区域提供该图标的不同版本。但是，加拿大英语和加拿大法语这两种语言区域需使用同一版本。无需将同一图片复制到加拿大英语和加拿大法语的资源目录中。不过，您可以将这两种语言使用的图片保存为除 icon.png 之外的任意名称（例如 icon_ca.png），并将其放入默认的 res/drawable/ 目录中。然后，在 res/drawable-en-rCA/ 和 res/drawable-fr-rCA/ 中创建 icon.xml 文件，使用 <bitmap> 元素引用 icon_ca.png 资源。

<?xml version="1.0" encoding="utf-8"?>
<bitmap xmlns:android="http://schemas.android.com/apk/res/android" android:src="@drawable/icon_ca" />

这样您就可以只保存一个版本的 PNG 文件和两个指向该版本的小型 XML 文件。然后，您可以使用 painterResource(R.drawable.icon)，系统会在检测到相应语言区域后选择相应的文件。

字符串和其他简单值

如需为现有字符串创建别名，则可将所需字符串的资源 ID 用作新字符串的值：

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <string name="hello">Hello</string>
    <string name="hi">@string/hello</string>
</resources>

R.string.hi 资源现在是 R.string.hello 的别名。

其他简单值的原理相同，例如颜色：

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <color name="red">#f00</color>
    <color name="highlight">@color/red</color>
</resources>

访问应用资源

在应用中提供资源后，您可通过引用其资源 ID 来应用该资源。所有资源 ID 都在您项目的 R 类中进行定义，该类由 aapt 工具自动生成。

编译应用时，aapt 会生成 R 类，其中包含 res/ 目录中所有资源的资源 ID。每种类型的资源都有对应的 R 子类（例如，R.drawable 对应所有可绘制资源）。且相应类型的每个资源都有对应的静态整数（例如 R.drawable.icon）。该整型数就是可用来检索资源的资源 ID。

尽管资源 ID 是在 R 类中指定的，但您不需要在该类中查找资源 ID。资源 ID 始终由以下部分组成：

  • 资源类型：每个资源都会被划分到相应的“类型”，例如 string 或 drawable。
  • 资源名称，即不含扩展名的文件名。

在 Compose 中访问资源

Jetpack Compose 提供内置的、可组合项感知型函数，以便安全地访问资源。

  • 字符串：
    stringResource(id = R.string.hello)
  • 可绘制对象：
    painterResource(id = R.drawable.my_icon)

在非界面代码中访问资源

如果您需要访问界面层次结构之外的资源（例如 ViewModel、Repository 或系统 Service 中的资源），可以使用 Context 解析这些资源。 

// Retrieve a localized string resource
val greeting = context.getString(R.string.hello_world)

您还可利用 Resources 中的方法检索个别资源，并且您可通过 getResources 获得该资源的实例。

语法

以下是在代码中引用资源的语法：

[<package_name>.]R.<resource_type>.<resource_name>
  • <package_name> 是资源所在的软件包的名称（如果所引用的资源来自您自己的软件包，则不需要）。
  • <resource_type> 是资源类型的 R 子类。
  • <resource_name> 是不带扩展名的资源文件名，或 XML 元素中的 android:name 属性值（如果资源为简单值）。

如需详细了解各种资源类型及其引用方法，请参阅 Compose 中的资源。

访问原始文件

尽管并不常见，但您可能会需要访问原始文件和目录。如果确有需要，将文件保存在 res/ 中并没有用，因为从 res/ 读取资源的唯一方法是使用资源 ID。您可以改为将资源保存在 assets/ 目录中。

保存在 assets/ 目录中的文件没有资源 ID，因此您无法通过 R 类或在 XML 资源中引用它们。您可以改为采用类似常见文件系统的方式查询 assets/ 目录中的文件，并利用 AssetManager 读取原始数据。

不过，如果您只需要能够读取原始数据（例如视频文件或音频文件），则可将文件保存在 res/raw/ 目录中，并利用 openRawResource 读取字节流。

访问平台资源

Android 包含许多标准资源，例如系统样式和主题背景。如要访问这些资源，请通过 android 软件包类限定您的资源引用。例如 painterResource(android.R.drawable.ic_menu_info_details)。

利用资源提供最佳的设备兼容性

为使应用支持多种设备配置，请务必为应用使用的每种资源类型提供默认资源，这一点非常重要。

例如，如果应用支持多种语言，请始终包含不带语言和区域限定符的 values/ 目录（用于保存字符串）。相反，如果您将所有字符串文件放入带有语言和区域限定符的目录中，且设备语言已设为您的字符串所不支持的语言，则应用在该设备上运行时会崩溃。

只要您提供默认的 values/ 资源，应用便会正常运行（即使用户不理解该语言）。总比崩溃要好。

提供默认资源至关重要，这不仅是因为应用可能会在超出预期的配置上运行，也因为新版 Android 有时会添加较低版本不支持的配置限定符。如果您使用新的资源限定符，但代码仍然与较低版本的 Android 保持兼容，那么当较低版本的 Android 运行您的应用时，如果您不提供默认资源，应用就会崩溃，因为它不能使用以新限定符命名的资源。

例如，如果您将 minSdkVersion 设置为 4，并使用夜间模式（night 或 notnight，API 级别 8 中的新增配置）限定所有可绘制资源，则 API 级别 4 设备将无法访问可绘制资源，而且会崩溃。在这种情况下，您可能希望 notnight 成为默认资源，因此请排除该限定符，并将可绘制资源放入 drawable/ 或 drawable-night/ 中。

简而言之，为了提供最佳的设备兼容性，请务必为应用正常运行所需的资源提供默认资源。然后使用配置限定符针对特定的设备配置创建备用资源。

这条规则有一个例外情况：如果应用的 minSdkVersion 为 4 或以上，当您通过屏幕密度限定符提供备用可绘制资源时，不需要提供默认可绘制资源。即使没有默认可绘制资源，Android 也可以从备用屏幕密度中找到最匹配的资源，并可根据需要调整位图。但是，为了在所有类型的设备上提供最佳体验，请为所有三种类型的密度提供备用可绘制对象。

Android 如何查找最匹配的资源

当您请求要为其提供备用资源的资源时，Android 会根据当前的设备配置选择要在运行时使用的备用资源。为了向您说明 Android 如何选择备用资源，假定以下每个可绘制对象目录中分别包含同一图片的不同版本：

drawable/
drawable-en/
drawable-fr-rCA/
drawable-en-night/
drawable-en-notouch-12key/
drawable-night-ldpi/
drawable-night-notouch-12key/

而且假定设备的配置如下所示：

语言区域 = en-GB
夜间模式 = night
屏幕像素密度 = hdpi
触摸屏类型 = notouch
主要文本输入法 = 12key

通过将设备配置与可用的备用资源进行比较，Android 会从 drawable-en-night 中选择可绘制对象。

系统使用以下逻辑确定要使用的资源：

图 2. Android 如何查找最匹配的资源的流程图。

  1. 排除与设备配置相冲突的资源文件。

    drawable-fr-rCA/ 目录与 en-GB 语言区域冲突，因而被排除。

    drawable/
drawable-en/
drawable-fr-rCA/
drawable-en-night/
drawable-en-notouch-12key/
drawable-night-ldpi/
drawable-night-notouch-12key/

    例外：屏幕像素密度是一个不会因冲突而被排除的限定符。尽管设备的屏幕密度为 hdpi，但是 drawable-night-ldpi/ 未被排除，因为此时每种屏幕密度均被视为匹配。如需了解详情，请参阅屏幕兼容性概览。

  2. 从列表（表 2）中查找下一个优先级最高的限定符（从 MCC 开始）。
  3. 是否有资源目录包含此限定符？
    • 如果答案为“否”，则返回第 2 步并寻找下一个限定符。在本示例中，这一问题的答案一直为“否”，直到找到语言限定符为止。
    • 如果答案为“是”，继续进行第 4 步。
  4. 排除不包含此限定符的资源目录。在本例中，系统接下来会排除所有不包含语言限定符的目录： 
    drawable/
drawable-en/
drawable-en-night/
drawable-en-notouch-12key/
drawable-night-ldpi/
drawable-night-notouch-12key/

    例外：如果涉及的限定符为屏幕像素密度，则 Android 会选择与设备屏幕密度最匹配的选项。一般而言，Android 会优先选择将较大的原始图片缩小，而不是将较小的原始图片放大。如需了解详情，请参阅屏幕兼容性概览。

  5. 重复第 2 步、第 3 步和第 4 步，直到仅剩一个目录为止。在本例中，夜间模式是下一个判断是否匹配的限定符。因此，没有指定夜间模式的资源会被排除： 
    drawable-en/
drawable-en-night/
drawable-en-notouch-12key/

    剩下的目录是 drawable-en-night。

尽管系统会对所请求的每个资源执行此流程，但是其仍会对某些方面进行优化。例如，已知设备配置后，系统会排除可能永远无法匹配的备用资源。例如，如果配置语言是英语，那么语言限定符设置为非英语的所有资源目录都不会包含在接受检查的资源池中（不过，系统仍会检查不包含语言限定符的资源目录）。

在根据屏幕尺寸限定符选择资源时，如果没有更匹配的资源，系统将使用针对较小屏幕（小于当前屏幕）设计的资源。例如，大尺寸屏幕在必要时将使用适用于标准尺寸屏幕的资源。

但是，如果唯一可用的资源大于当前屏幕，系统将不会使用这些资源，而且如果没有其他资源与设备配置匹配，您的应用会崩溃。例如，如果所有布局资源均使用 xlarge 限定符进行标记，但设备的屏幕是标准尺寸，就会发生这种情况。

注意：限定符的优先级（参见表 2）比与设备完全匹配的限定符数量更加重要。在上述示例第 4 步中，列表剩下的最后选项包括三个与设备完全匹配的限定符（夜间模式、触摸屏类型和输入法），而 drawable-en 只有一个匹配参数（语言）。但是，语言的优先级高于其他三个限定符，因此系统会排除 drawable-night-notouch-12key。

其他资源

如需详细了解应用资源，请参阅以下其他资源：

文档

查看内容