Android 如何查找最佳匹配资源

转自应用资源概览  |  Android 开发者  |  Android Developers

当您请求要为其提供备用资源的资源时，Android 会根据当前的设备配置选择要在运行时使用的备用资源。为演示 Android 如何选择备用资源，假设以下可绘制对象目录分别包含相同图像的不同版本：

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

同时，假设设备配置如下：

语言区域 = en-GB
屏幕方向 = port
屏幕像素密度 = hdpi
触摸屏类型 = notouch
主要文本输入法 = 12key

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

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

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

1. 淘汰与设备配置冲突的资源文件。

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

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

   例外：屏幕像素密度是唯一一个未因冲突而被淘汰的限定符。尽管设备的屏幕密度为 hdpi，但是 drawable-port-ldpi/ 未被淘汰，因为此时每个屏幕密度均视为匹配。如需了解详细信息，请参阅支持多种屏幕文档。

2. 选择列表（表 2）中（下一个）优先级最高的限定符。（从 MCC 开始，然后向下移动。）
3. 是否有资源目录包含此限定符？
   • 若无，请返回到第 2 步，看看下一个限定符。（在该示例中，除非到达语言限定符，否则答案始终为“否”。）
   • 若有，请继续执行第 4 步。
4. 淘汰不含此限定符的资源目录。在该示例中，系统会淘汰所有不含语言限定符的目录：

   drawable/
   drawable-en/
   drawable-en-port/
   drawable-en-notouch-12key/
   drawable-port-ldpi/
   drawable-port-notouch-12key/
   

   例外：如果问题中的限定符是屏幕像素密度，则 Android 会选择最接近设备屏幕密度的选项。一般来说，Android 偏向于缩小较大的原始图像，而非放大较小的原始图像。请参阅支持多种屏幕。

5. 返回并重复第 2 步、第 3 步和第 4 步，直到仅剩一个目录为止。在此示例中，屏幕方向是下一个判断是否匹配的限定符。因此，系统会淘汰未指定屏幕方向的资源：

   drawable-en/
   drawable-en-port/
   drawable-en-notouch-12key/
   

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

尽管系统会对所请求的每个资源执行此程序，但是其仍会对某些方面做进一步优化。例如，已知设备配置后，系统会淘汰可能永远无法匹配的备用资源。比如，如果配置语言是英语（“en”），则系统绝不会将语言限定符设置为非英语的任何资源目录加入选中的资源池（不过，仍会将不带语言限定符的资源目录加入该池）。

在根据屏幕尺寸限定符选择资源时，如果没有更好的匹配资源，则系统将使用专为小于当前屏幕的屏幕而设计的资源（例如，必要时，大尺寸屏幕将使用标准尺寸的屏幕资源）。但是，如果唯一可用的资源大于当前屏幕，则系统不会使用这些资源，并且如果没有其他资源与设备配置匹配，应用将会崩溃（例如，如果所有布局资源均用 xlarge 限定符标记，但设备是标准尺寸的屏幕）。

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

Android 支持若干配置限定符，您可以通过使用短划线分隔每个限定符，从而向一个目录名称添加多个限定符。表 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	语言通过由两个字母组成的 ISO 639-1 语言代码进行定义，可以选择后跟两个字母组成的 ISO 3166-1-alpha-2 区域码（前缀用小写字母 r）。 这些代码不区分大小写；r 前缀用于区分区域码。您不能单独指定区域。 Android 7.0（API 级别 24）引入对 BCP 47 语言标记的支持，可供您用来限定特定语言和区域的资源。语言标记由一个或多个子标记序列组成，每个子标记都能优化或缩小由整体标记标识的语言范围。如需了解有关语言标记的详细信息，请参阅用于标识语言的标记。 如要使用 BCP 47 语言标记，请将 b+ 和两个字母的 ISO 639-1 语言代码连接；其后还可选择使用其他子标记，用 + 分隔即可。 如果用户在系统设置中更改语言，则语言标记可能会在应用的生命周期中发生变更。如需了解运行时应用会因此受到何种影响，请参阅处理运行时变更。 有关针对其他语言本地化应用的完整指南，请参阅本地化。 另请参阅 getLocales() 方法，了解该方法提供的已定义语言区域列表。此列表包含主要的语言区域。
布局方向	ldrtl ldltr	应用的布局方向。ldrtl 是指“布局方向从右到左”。ldltr 是指“布局方向从左到右”（默认的隐式值）。 此配置适用于布局、可绘制资源或值等任何资源。 例如，若要针对阿拉伯语提供某种特定布局，并针对任何其他“从右到左”的语言（如波斯语或希伯来语）提供某种通用布局，则可提供以下资源： res/ layout/ main.xml (Default layout) layout-ar/ main.xml (Specific layout for Arabic) layout-ldrtl/ main.xml (Any "right-to-left" language, except for Arabic, because the "ar" language qualifier has a higher precedence.) 请注意：如要为应用启用从右到左的布局功能，则必须将 supportsRtl 设置为 "true"，并将 targetSdkVersion 设置为 17 或更高版本。 此项为 API 级别 17 中的新增配置。
smallestWidth	sw<N>dp 示例： sw320dp sw600dp sw720dp 等等	屏幕的基本尺寸，由可用屏幕区域的最小尺寸指定。具体而言，设备的 smallestWidth 是屏幕可用高度和宽度的最小尺寸（您也可将其视为屏幕的“最小可能宽度”）。无论屏幕的当前方向如何，您均可使用此限定符确保应用界面的可用宽度至少为 <N> dp。 例如，如果布局要求屏幕区域的最小尺寸始终至少为 600dp，则可使用此限定符创建布局资源 res/layout-sw600dp/。仅当可用屏幕的最小尺寸至少为 600dp（无论 600dp 表示的边是用户所认为的高度还是宽度）时，系统才会使用这些资源。最小宽度为设备的固定屏幕尺寸特征；即使屏幕方向发生变化，设备的最小宽度仍会保持不变。 使用最小宽度确定一般屏幕尺寸非常有用，因为宽度通常是设计布局时的驱动因素。界面经常会垂直滚动，但对其水平方向所需要的最小空间具有非常硬性的限制。可用宽度也是确定是否对手持式设备使用单窗格布局，或对平板电脑使用多窗格布局的关键因素。因此，您可能最关注每台设备上的最小可能宽度。 设备的最小宽度会将屏幕装饰元素和系统界面考虑在内。例如，如果设备屏幕上的某些永久性界面元素沿着最小宽度轴占据空间，则系统会声明最小宽度小于实际屏幕尺寸，因为这些屏幕像素不适用于您的界面。 以下是一些可用于常见屏幕尺寸的值： 320，适用于屏幕配置如下的设备： 240x320 ldpi（QVGA 手机） 320x480 mdpi（手机） 480x800 hdpi（高密度手机） 480，适用于 480x800 mdpi 之类的屏幕（平板电脑/手机）。 600，适用于 600x1024 mdpi 之类的屏幕（7 英寸平板电脑）。 720，适用于 720x1280 mdpi 之类的屏幕（10 英寸平板电脑）。 当应用为多个资源目录提供不同的 smallestWidth 限定符值时，系统会使用最接近（但未超出）设备 smallestWidth 的值。 此项为 API 级别 13 中的新增配置。 另请参阅 android:requiresSmallestWidthDp 属性（声明与应用兼容的最小 smallestWidth）和 smallestScreenWidthDp 配置字段（存放设备的 smallestWidth 值）。 如需了解有关不同屏幕设计和使用此限定符的详细信息，请参阅支持多种屏幕开发者指南。
可用宽度	w<N>dp 示例： w720dp w1024dp 等等	指定资源应使用的最小可用屏幕宽度（以 dp 为单位，由 <N> 值定义）。当屏幕方向在横向和纵向之间切换时，此配置值也会随之变化，以匹配当前的实际宽度。 此功能往往有助于确定是否使用多窗格布局，因为即便在使用平板电脑设备时，您通常也不希望竖屏以横屏的方式使用多窗格布局。因此，您可以使用此功能指定布局所需的最小宽度，而无需同时使用屏幕尺寸和屏幕方向限定符。 应用为此配置提供具有不同值的多个资源目录时，系统会使用最接近（但未超出）设备当前屏幕宽度的值。此处的值会考虑屏幕装饰元素，因此如果设备显示屏的左边缘或右边缘上有一些永久性 UI 元素，考虑到这些 UI 元素，同时为减少应用的可用空间，设备会使用小于实际屏幕尺寸的宽度值。 此项为 API 级别 13 中的新增配置。 另请参阅 screenWidthDp 配置字段，该字段存放当前屏幕宽度。 如需了解有关不同屏幕设计和使用此限定符的详细信息，请参阅支持多种屏幕开发者指南。
可用高度	h<N>dp 示例： h720dp h1024dp 等等	指定资源应使用的最小可用屏幕高度（以“dp”为单位，由 <N> 值定义）。当屏幕方向在横向和纵向之间切换时，此配置值也会随之变化，以匹配当前的实际高度。 对比使用此方式定义布局所需高度与使用 w<N>dp 定义所需宽度，二者均非常有用，且都无需同时使用屏幕尺寸和方向限定符。但大多数应用不需要此限定符，因为界面经常垂直滚动，所以高度需更有弹性，而宽度则应更固定。 当应用为此配置提供具有不同值的多个资源目录时，系统会使用最接近（但未超出）设备当前屏幕高度的值。此处的值会考虑屏幕装饰元素，因此如果设备显示屏的上边缘或下边缘上有一些永久性 UI 元素，考虑到这些 UI 元素，同时为减少应用的可用空间，设备会使用小于实际屏幕尺寸的高度值。非固定的屏幕装饰元素（例如，全屏时可隐藏的手机状态栏）并不在考虑范围内，标题栏或操作栏等窗口装饰亦如此，因此应用必须准备好处理稍小于其指定值的空间。 此项为 API 级别 13 中的新增配置。 另请参阅 screenHeightDp 配置字段，该字段存放当前屏幕宽度。 如需了解有关不同屏幕设计和使用此限定符的详细信息，请参阅支持多种屏幕开发者指南。
屏幕尺寸	small normal large xlarge	small：尺寸类似于低密度 VGA 屏幕的屏幕。小屏幕的最小布局尺寸约为 320x426 dp。例如，QVGA 低密度屏幕和 VGA 高密度屏幕。 normal：尺寸类似于中等密度 HVGA 屏幕的屏幕。标准屏幕的最小布局尺寸约为 320x470 dp。例如，WQVGA 低密度屏幕、HVGA 中等密度屏幕、WVGA 高密度屏幕。 large：尺寸类似于中等密度 VGA 屏幕的屏幕。大屏幕的最小布局尺寸约为 480x640 dp。例如，VGA 和 WVGA 中等密度屏幕。 xlarge：明显大于传统中等密度 HVGA 屏幕的屏幕。超大屏幕的最小布局尺寸约为 720x960 dp。在大多数情况下，屏幕超大的设备体积太大，不能放进口袋，最常见的是平板式设备。此项为 API 级别 9 中的新增配置。 请注意：使用尺寸限定符并不表示资源仅适用于该尺寸的屏幕。如果没有为备用资源提供最符合当前设备配置的限定符，则系统可能会使用其中最匹配的资源。 注意：如果所有资源均使用大于当前屏幕的尺寸限定符，则系统不会使用这些资源，并且应用将在运行时崩溃（例如，如果所有布局资源均以 xlarge 限定符标记，但设备是标准尺寸的屏幕）。 此项为 API 级别 4 中的新增配置。 如需了解详细信息，请参阅支持多种屏幕。 另请参阅 screenLayout 配置字段，该字段指示屏幕是小尺寸、标准尺寸还是大尺寸。
屏幕纵横比	long notlong	long：宽屏，如 WQVGA、WVGA、FWVGA notlong：非宽屏，如 QVGA、HVGA 和 VGA 此项为 API 级别 4 中新增配置。 此配置完全基于屏幕的纵横比（宽屏较宽），并且与屏幕方向无关。 另请参阅 screenLayout 配置字段，该字段指示屏幕是否为宽屏。
圆形屏幕	round notround	round：圆形屏幕，例如圆形可穿戴式设备 notround：方形屏幕，例如手机或平板电脑 此项为 API 级别 23 中的新增配置。 另请参阅 isScreenRound() 配置方法，该方法指示屏幕是否为圆形屏幕。
广色域	widecg nowidecg	{@code widecg}：显示广色域，如 Display P3 或 AdobeRGB {@code nowidecg}：显示窄色域，如 sRGB 此项为 API 级别 26 中的新增配置。 另请参阅 isScreenWideColorGamut() 配置方法，该方法指示屏幕是否具有广色域。
高动态范围 (HDR)	highdr lowdr	{@code highdr}：显示高动态范围 {@code lowdr}：显示低/标准动态范围 此项为 API 级别 26 中的新增配置。 另请参阅 isScreenHdr() 配置方法，该方法指示屏幕是否具有 HDR 功能。
屏幕方向	port land	port：设备处于纵向（垂直） land：设备处于横向状态（水平） 如果用户旋转屏幕，此配置可能会在应用生命周期中发生变化。如需了解这会在运行时期间给应用带来哪些影响，请参阅处理运行时变更。 另请参阅 orientation 配置字段，该字段指示当前的设备方向。
界面模式	car desk television appliance watch vrheadset	car：设备正在车载手机座上显示 desk：设备正在桌面手机座上显示 television：设备正在通过电视显示内容，通过将界面投影到离用户较远的大屏幕上，为用户提供“十英尺”体验。主要面向遥控交互或其他非触控式交互 appliance：设备正在用作没有显示屏的装置 watch：设备配有显示屏，并且可戴在手腕上 vrheadset：设备正在通过虚拟现实耳机显示内容 此项为 API 级别 8 中的新增配置，API 13 中的新增电视配置，API 20 中的新增手表配置。 如需了解应用在设备插入基座或从中移除时的响应方式，请阅读确定并监控插接状态和类型。 如果用户将设备插入基座，此配置可能会在应用生命周期中发生变化。您可以使用 UiModeManager 启用或禁用其中的部分模式。如需了解这会在运行时期间给应用带来哪些影响，请参阅处理运行时变更。
夜间模式	night notnight	night：夜间 notnight：白天 此项为 API 级别 8 中的新增配置。 如果夜间模式停留在自动模式（默认），此配置可能会在应用生命周期中发生变化。在此情况下，该模式会根据当天的时间进行调整。您可以使用 UiModeManager 启用或禁用此模式。如需了解这会在运行时期间给应用带来哪些影响，请参阅处理运行时变更。
屏幕像素密度 (dpi)	ldpi mdpi hdpi xhdpi xxhdpi xxxhdpi nodpi tvdpi anydpi nnndpi	ldpi：低密度屏幕；约为 120dpi。 mdpi：中等密度（传统 HVGA）屏幕；约为 160dpi。 hdpi：高密度屏幕；约为 240dpi。 xhdpi：超高密度屏幕；约为 320dpi。此项为 API 级别 8 中的新增配置 xxhdpi：绝高密度屏幕；约为 480dpi。此项为 API 级别 16 中的新增配置 xxxhdpi：极高密度屏幕使用（仅限启动器图标，请参阅支持多种屏幕中的注释）；约为 640dpi。此项为 API 级别 18 中的新增配置 nodpi：可用于您不希望为匹配设备密度而进行缩放的位图资源。 tvdpi：密度介于 mdpi 和 hdpi 之间的屏幕；约为 213dpi。此限定符并非指“基本”密度的屏幕。它主要用于电视，且大多数应用都不使用该密度 — 大多数应用只会使用 mdpi 和 hdpi 资源，而且系统将根据需要对这些资源进行缩放。此项为 API 级别 13 中的新增配置 anydpi：此限定符适合所有屏幕密度，其优先级高于其他限定符。这非常适用于矢量可绘制对象。此项为 API 级别 21 中的新增配置 nnndpi：用于表示非标准密度，其中 nnn 是正整数屏幕密度。此限定符不适用于大多数情况。使用标准密度存储分区，可显著减少因支持市场上各种设备屏幕密度而产生的开销。 六个基本密度之间的缩放比为 3:4:6:8:12:16（忽略 tvdpi 密度）。因此，9x9 (ldpi) 位图相当于 12x12 (mdpi)、18x18 (hdpi)、24x24 (xhdpi) 位图，依此类推。 如果您认为图像资源在电视或其他某些设备上的呈现效果不够好，进而想尝试使用 tvdpi 资源，则缩放系数应为 1.33*mdpi。例如，mdpi 屏幕的 100px x 100px 图像应相当于 tvdpi 屏幕的 133px x 133px 图像。 请注意：使用密度限定符并不表示资源仅适用于该密度的屏幕。如果没有为备用资源提供最符合当前设备配置的限定符，则系统可能使用其中最匹配的资源。 如需详细了解如何处理不同屏幕密度以及 Android 如何缩放位图以适应当前密度，请参阅支持多种屏幕。
触摸屏类型	notouch finger	notouch：设备没有触摸屏。 finger：设备有一个专供用户通过手指直接进行交互的触摸屏。 另请参阅 touchscreen 配置字段，该字段指示设备上的触摸屏类型。
键盘可用性	keysexposed keyshidden keyssoft	keysexposed：设备拥有可用的键盘。如果设备启用了软键盘（不无可能），那么即使用户未找到硬键盘，或者该设备没有硬键盘，也可使用此限定符。如果未提供或已禁用软键盘，则只有在配备硬键盘的情况下才可使用此限定符。 keyshidden：设备具有可用的硬键盘，但其处于隐藏状态，且设备未启用软键盘。 keyssoft：设备已启用软键盘（无论是否可见）。 如果您提供了 keysexposed 资源，但未提供 keyssoft 资源，则无论键盘是否可见，只要系统已启用软键盘，其便会使用 keysexposed 资源。 如果用户打开硬键盘，此配置可能会在应用生命周期中发生变化。如需了解这会在运行时期间给应用带来哪些影响，请参阅处理运行时变更。 另请参阅配置字段 hardKeyboardHidden 和 keyboardHidden，二者分别指示硬键盘的可见性和任一键盘（包括软键盘）的可见性。
主要的文本输入法	nokeys qwerty 12key	nokeys：设备没有用于文本输入的硬按键。 qwerty：设备拥有标准硬键盘（无论是否对用户可见）。 12key：设备拥有 12 键硬键盘（无论是否对用户可见）。 另请参阅 keyboard 配置字段，该字段指示可用的主要文本输入法。
导航键可用性	navexposed navhidden	navexposed：导航键可供用户使用。 navhidden：导航键不可用（例如，在密封盖子后面）。 如果用户显示导航键，此配置可能会在应用生命周期中发生变化。如需了解这会在运行时期间给应用带来哪些影响，请参阅处理运行时变更。 另请参阅 navigationHidden 配置字段，该字段指示导航键是否处于隐藏状态。
主要的非触摸导航方法	nonav dpad trackball wheel	nonav：除了使用触摸屏以外，设备没有其他导航设施。 dpad：设备具有用于导航的方向键。 trackball：设备具有用于导航的轨迹球。 wheel：设备具有用于导航的方向盘（不常见）。 另请参阅 navigation 配置字段，该字段指示可用的导航方法类型。
平台版本（API 级别）	示例： v3 v4 v7 等等	设备支持的 API 级别。例如，v1 对应 API 级别 1（装有 Android 1.0 或更高版本系统的设备），v4 对应 API 级别 4（装有 Android 1.6 或更高版本系统的设备）。如需了解有关这些值的详细信息，请参阅 Android API 级别文档。

应用资源概览  |  Android 开发者  |  Android Developers