Android Resources匹配规则

总是不明白Android运行时使用哪个资源,资源匹配的规则是什么样的,找到对应文档,以此记录。 下方内容copy自 官方文档 ,可直接访问查看。

表 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](https://developer.android.google.cn/reference/android/content/res/Configuration?hl=zh-cn#mcc) 和 [mnc](https://developer.android.google.cn/reference/android/content/res/Configuration?hl=zh-cn#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()](https://developer.android.google.cn/reference/android/content/res/Configuration?hl=zh-cn#getLocales()) 方法,了解该方法提供的已定义语言区域列表。此列表包含主要的语言区域。
布局方向ldrtl
ldltr
应用的布局方向。ldrtl 是指“布局方向从右到左”。ldltr 是指“布局方向从左到右”(默认的隐式值)。

此配置适用于布局、可绘制对象或值等任何资源。

例如,如需针对阿拉伯语提供某种特定布局,并针对任何其他“从右到左”的语言(例如波斯语或希伯来语)提供某种通用布局,则可使用以下目录:

res/
  layout/
    main.xml(默认布局)
  layout-ar/
    main.xml(阿拉伯语的特定布局)
  layout-ldrtl/
    main.xml(阿拉伯语以外的任何从右到左的语言,因为“ar”语言限定符的优先级较高)

注意:如要为应用启用从右到左的布局功能,则必须将  SupportsRtl  设置为 "true",并将  TargetSdkVersion  设置为 17 或更高版本。

此项为 API 级别 17 中的新增配置。
最小宽度sw<N>dp

示例:
sw320dp
sw600dp
sw720dp
等等
应用可用屏幕区域的最短尺寸。具体而言,应用窗口的 smallestWidth 是窗口可用高度和宽度的最小尺寸。您也可将其视为窗口的“最小可能宽度”。您可使用此限定符,让应用界面的可用宽度至少为 <N> dp。

例如,如果布局要求屏幕区域的最小尺寸始终至少为 600 dp,则可使用此限定符在 res/layout-sw600dp/ 目录中创建布局资源。仅当可用屏幕的最小尺寸至少为 600 dp(无论 600 dp 表示的边是用户所认为的高度还是宽度)时,系统才会使用这些资源。调整窗口大小(更改可用宽度/高度)或重新定位(可能会更改系统边衬区)时,最小宽度可能会改变。

使用最小宽度确定一般屏幕尺寸非常有用,因为宽度通常是设计布局时的驱动因素。界面通常是竖直滚动的,但其在水平方向上所需的最小空间则相对有很多的限制。

可用宽度也是确定是否针对手机使用单窗格布局,或针对平板电脑使用多窗格布局的关键因素。因此,您可能最关注每台设备上的最小可能宽度。

设备的最小宽度会将屏幕装饰元素和系统界面考虑在内。例如,如果设备屏幕上的永久性界面元素沿着最小宽度轴占据空间,则系统会声明最小宽度小于实际屏幕尺寸,因为这些屏幕像素不适用于您的界面。

以下是一些可用于常见屏幕尺寸的值:

- 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](https://developer.android.google.cn/reference/android/content/res/Configuration?hl=zh-cn#smallestScreenWidthDp) 配置字段(存放设备的 smallestWidth 值)。

如需详细了解如何使用此限定符针对不同的屏幕进行设计,请参阅 支持不同的屏幕尺寸
可用宽度和高度w<N>dp
h<N>dp

示例:
w720dp
w1024dp
h720dp
h1024dp
等等
指定资源使用的最小可用屏幕宽度或高度(以 dp 为单位,由 <N> 值定义)。当设备屏幕方向在横屏和竖屏之间切换时、设备折叠或展开时或者系统进入或退出多窗口模式时,系统会将这些配置值与当前的显示宽度和高度进行比较。在多窗口模式下,这些值反映的是包含应用的窗口的宽度和高度,而不是设备屏幕的宽度和高度。同样,对于嵌入的 activity,该值与各个 activity 的宽度和高度(而非屏幕的宽度和高度)。如需了解详情,请参阅  activity 嵌入

可用宽度和高度通常有助于确定是否使用多窗格布局,因为即使是在平板电脑设备上,您通常也不希望在竖屏模式下像横屏模式那样使用多窗格布局。因此,您可以使用这些限定符来指定布局所需的最小宽度和/或高度,而无需同时使用屏幕尺寸和屏幕方向限定符。

当应用为这些配置提供具有不同值的多个资源目录时,系统会使用最接近(但未超出)设备当前屏幕宽度的值。系统将实际屏幕宽度与指定宽度之间的差值和实际屏幕高度与指定高度之间的差值相加(未指定的高度和宽度值为 0),以确定最接近的目录。

该值会排除 窗口边衬区 占据的区域,因此,如果设备显示屏的边缘具有永久性界面元素,则宽度和高度值会小于实际屏幕尺寸(即使应用使用  Window.setDecorFitsSystemWindows  或  WindowCompat.setDecorFitsSystemWindows  以边缘对齐的方式显示)。

部分非固定的竖屏装饰(例如可在全屏模式下可隐藏的手机状态栏)和窗口装饰(例如标题栏或操作栏)不在考虑范围之内,因此应用必须准备好处理稍小于其指定值的空间。

注意:系统会选择宽度和高度均匹配的资源。因此,强烈建议您同时指定这两种资源,而不是仅指定其中一种资源。例如,如果实际屏幕为 w720dp 乘以 h1280dp,并且其中一个资源符合 w720dp 的条件,另一个资源符合 w700dp-h1200dp 的条件,即使前一个资源与其指定的资源完全匹配,系统也会选择后者。

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

另请参阅 [screenWidthDp](https://developer.android.google.cn/reference/android/content/res/Configuration?hl=zh-cn#screenWidthDp) 和 [screenHeightDp](https://developer.android.google.cn/reference/android/content/res/Configuration?hl=zh-cn#screenHeightDp) 配置字段,这些字段用于保存当前屏幕的宽度和高度。

如需详细了解如何使用此限定符针对不同的屏幕进行设计,请参阅 支持不同的屏幕尺寸
屏幕尺寸small
normal
large
xlarge
- small:尺寸类似于低密度 QVGA 屏幕的屏幕。小屏幕的最小布局尺寸约为 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](https://developer.android.google.cn/reference/android/content/res/Configuration?hl=zh-cn#screenLayout) 配置字段,该字段用于指示屏幕为小尺寸、标准尺寸还是大尺寸。

如需了解详情,请参阅 屏幕兼容性概览
屏幕宽高比long
notlong
- long:宽屏,如 WQVGA、WVGA、FWVGA
- notlong:非宽屏,如 QVGA、HVGA 和 VGA

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

此配置完全基于屏幕的纵横比(long 屏较宽),与屏幕方向无关。

另请参阅 [screenLayout](https://developer.android.google.cn/reference/android/content/res/Configuration?hl=zh-cn#screenLayout) 配置字段,该字段用于指示屏幕是否为宽屏。
圆形屏幕round
notround
- round:圆形屏幕,例如圆形可穿戴式设备
- notround:方形屏幕,例如手机或平板电脑

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

另请参阅 [isScreenRound()](https://developer.android.google.cn/reference/android/content/res/Configuration?hl=zh-cn#isScreenRound()) 配置方法,该方法用于指示屏幕是否为圆形屏幕。
广色域widecg
nowidecg
- widecg:显示广色域,如 Display P3 或 AdobeRGB
- nowidecg:显示窄色域,如 sRGB

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

另请参阅 [isScreenWideColorGamut()](https://developer.android.google.cn/reference/android/content/res/Configuration?hl=zh-cn#isScreenWideColorGamut()) 配置方法,该方法用于指示屏幕是否具有广色域。
高动态范围 (HDR)highdr
lowdr
- highdr:显示高动态范围
- lowdr:显示低/标准动态范围

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

另请参阅 [isScreenHdr()](https://developer.android.google.cn/reference/android/content/res/Configuration?hl=zh-cn#isScreenHdr()) 配置方法,该方法用于指示屏幕是否具有 HDR 功能。
屏幕方向port
land
- port:设备处于竖屏模式(纵向)
- land:设备处于横屏模式(水平)

如果用户旋转屏幕,此配置可能会在应用生命周期中发生变化。如需了解这会在运行时期间给应用带来哪些影响,请参阅 处理配置更改

另请参阅 [orientation](https://developer.android.google.cn/reference/android/content/res/Configuration?hl=zh-cn#orientation) 配置字段,该字段用于指示当前的设备方向。
界面模式car
desk
television
appliance
watch
vrheadset
- car:设备正在车载基座中显示
- desk:设备正在桌面基座中显示
- television:设备正在通过电视显示内容,通过将界面投影到离用户较远的大屏幕上,为用户提供“十英尺”体验。该体验主要面向遥控交互或其他非触控式交互
- appliance:设备用作不带显示屏的装置
- watch:设备配有显示屏,并且可戴在手腕上
- vrheadset:设备正在通过虚拟现实耳机显示内容

此项为 API 级别 8 中的新增配置;API 13 中的新增电视配置;API 20 中的新增手表配置。

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

如果用户将设备插入基座,此配置可能会在应用生命周期中发生变化。您可以使用 [UiModeManager](https://developer.android.google.cn/reference/android/app/UiModeManager?hl=zh-cn) 启用或停用其中的部分模式。如需了解这会在运行时期间给应用带来哪些影响,请参阅 处理配置更改
夜间模式night
notnight
- night:夜晚时光
- notnight:日间节目

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

如果夜间模式停留在自动模式(默认),此配置可能会在应用生命周期中发生变化。在这种情况下,该模式会根据当天的时间进行调整。您可以使用 [UiModeManager](https://developer.android.google.cn/reference/android/app/UiModeManager?hl=zh-cn) 启用或停用此模式。如需了解这会在运行时期间给应用带来哪些影响,请参阅 处理配置更改
屏幕像素密度 (dpi)ldpi
mdpi
hdpi
xhdpi
xxhdpi
xxxhdpi
nodpi
tvdpi
anydpi
_nnn_dpi
- 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 中的新增配置。
- _nnn_dpi:用于表示非标准密度,其中 _nnn_ 是正整数屏幕密度。大多数情况下不使用此限定符。使用标准密度存储分区,可显著减少因支持市场上各种设备屏幕密度而产生的开销。

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

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

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

另请参阅 [touchscreen](https://developer.android.google.cn/reference/android/content/res/Configuration?hl=zh-cn#touchscreen) 配置字段,该字段用于指示设备的触摸屏类型。
键盘可用性keysexposed
keyshidden
keyssoft
- keysexposed:设备具有可用的键盘。如果设备启用了软件键盘(不无可能),那么即使用户未找到硬件键盘,或者该设备没有硬件键盘,也可使用此限定符。如果设备未提供软件键盘或软件键盘已停用,则只有在向用户公开硬件键盘时,才可使用此限定符。
- keyshidden:设备具有可用的硬件键盘,但其处于隐藏状态,且设备未启用软件键盘。
- keyssoft:设备已启用软件键盘(无论是否可见)。

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

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

另请参阅配置字段 [hardKeyboardHidden](https://developer.android.google.cn/reference/android/content/res/Configuration?hl=zh-cn#hardKeyboardHidden) 和 [keyboardHidden](https://developer.android.google.cn/reference/android/content/res/Configuration?hl=zh-cn#keyboardHidden),这两个字段分别用于指示硬件键盘的可见性和任一键盘(包括软件键盘)的可见性。
主要的文本输入法nokeys
qwerty
12key
- nokeys:设备没有用于文本输入的硬件按键。
- qwerty:设备具有硬件 QWERTY 键盘(无论其对用户是否可见)。
- 12key:设备具有包含 12 个按键的硬件键盘(无论其对用户是否可见)。

另请参阅 [keyboard](https://developer.android.google.cn/reference/android/content/res/Configuration?hl=zh-cn#keyboard) 配置字段,该字段用于指示可用的主要文本输入法。
导航键可用性navexposed
navhidden
- navexposed:导航键可供用户使用。
- navhidden:导航键不可用(例如位于合上的盖子后面)。

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

另请参阅 [navigationHidden](https://developer.android.google.cn/reference/android/content/res/Configuration?hl=zh-cn#navigationHidden) 配置字段,该字段用于指示导航键是否处于隐藏状态。
主要的非触摸导航方法nonav
dpad
trackball
wheel
- nonav:除了使用触摸屏以外,设备没有其他导航设施。
- dpad:设备具有用于导航的方向键。
- trackball:设备具有用于导航的轨迹球。
- wheel:设备具有用于导航方向盘(不常见)。

另请参阅 [navigation](https://developer.android.google.cn/reference/android/content/res/Configuration?hl=zh-cn#navigation) 配置字段,该字段用于指示可用的导航方法类型。
平台版本(API 级别)示例:
v3
v4
v7
等等
设备支持的 API 级别。例如,v1 对应 API 级别 1(搭载 Android 1.0 或更高版本的设备);v4 对应 API 级别 4(搭载 Android 1.6 或更高版本的设备)。如需了解有关这些值的详细信息,请参阅  Android API 级别 文档。

注意: 并非所有版本的 Android 系统都支持所有限定符。使用新限定符会隐式添加平台版本限定符,因此较旧版本系统的设备可以忽略它。例如,使用 w600dp 限定符会自动包括 v13 限定符,因为可用宽度限定符是 API 级别 13 中的新增配置。为避免出现任何问题,请始终包含一组默认资源(一组不包含任何限定符的资源)。如需了解详细信息,请参阅 利用资源提供最佳的设备兼容性 部分。

限定符命名规则

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

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

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

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

创建别名资源

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

注意:并非所有资源都提供能够为另一资源创建别名的机制。特别是,xml/ 目录中的动画资源、菜单资源、原始资源及其他未指定资源均不提供此功能。

例如,假设您有一个应用图标 icon.png,并且需要针对不同语言区域提供该图标的不同版本。但是,加拿大英语和加拿大法语这两种语言区域需使用同一版本。无需将同一图片复制到加拿大英语和加拿大法语的资源目录中。不过,您可以将这两种语言使用的图片保存为除 icon.png 之外的任意名称(例如 icon_ca.png),并将其放入默认的 res/drawable/ 目录中。然后,在 res/drawable-en-rCA/ 和 res/drawable-fr-rCA/ 中创建 icon.xml 文件,使用 <bitmap> 元素引用 icon_ca.png 资源。这样您就可以只保存一个版本的 PNG 文件和两个指向该版本的小型 XML 文件。如需了解详情,请参阅以下部分中的示例。

可绘制对象

如要为现有可绘制对象创建别名,请使用 <drawable> 元素:

<?xml version="1.0" encoding="utf-8"?>  
<resources>    
<drawable name="icon">@drawable/icon_ca</drawable>  
</resources>  

如果您将此文件保存为 icon.xml并放入备用资源目录中(例如 res/values-en-rCA/),那么它将被编译为可作为 R.drawable.icon 引用的资源,但它实际上是 R.drawable.icon_ca 资源(保存在 res/drawable/ 中)的别名。

布局

如要为现有布局创建别名,请使用封装在 <merge> 中的 <include> 元素:

<?xml version="1.0" encoding="utf-8"?>  
<merge>    
<include layout="@layout/main_ltr"/>  
</merge>  

如果将此文件保存为 main.xml,则系统会将其编译到可作为 R.layout.main 引用的资源中,但该文件实际是 R.layout.main_ltr 资源的别名。

字符串和其他简单值

如需为现有字符串创建别名,则可将所需字符串的资源 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>

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