Android Resources匹配规则

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

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

表 2. 配置限定符名称。

注意： 并非所有版本的 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> 元素：

1
2
3
4

<?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> 元素：

1
2
3
4

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

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

字符串和其他简单值 #

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

1
2
3
4
5

<?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 的别名。

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

1
2
3
4
5
6

<?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