转载地址:http://developer.android.com/intl/zh-cn/guide/topics/resources/providing-resources.html#BestMatch
当您请求要为其提供备用资源的资源时,Android 会根据当前的设备配置选择要在运行时使用的备用资源。为演示 Android 如何选择备用资源,假设以下 Drawable 目录分别包含相同图像的不同版本:
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
中选择 Drawable。
系统使用以下逻辑决定要使用的资源:
图 2. Android 如何找到最匹配资源的流程图。
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/
未被淘汰,因为此时每个屏幕密度均视为匹配。如需了解详细信息,请参阅支持多个屏幕文档。
drawable/ drawable-en/ drawable-en-port/ drawable-en-notouch-12key/ drawable-port-ldpi/ drawable-port-notouch-12key/
例外:如果涉及的限定符是屏幕像素密度,则 Android 会选择最接近设备屏幕密度的选项。通常,Android 倾向于缩小大型原始图像,而不是放大小型原始图像。请参阅支持多个屏幕。
drawable-en/ drawable-en-port/ drawable-en-notouch-12key/
剩下的目录是 drawable-en-port
。
尽管对所请求的每个资源均执行此程序,但是系统仍会对某些方面做进一步优化。 例如,系统一旦知道设备配置,即会淘汰可能永远无法匹配的备用资源。 比如说,如果配置语言是英语(“en”),则系统绝不会将语言限定符设置为非英语的任何资源目录包含在选中的资源池中(不过,仍会将不带语言限定符的资源目录包含在该池中)。
根据屏幕尺寸限定符选择资源时,如果没有更好的匹配资源,则系统将使用专为小于当前屏幕的屏幕而设计的资源(例如,如有必要,大尺寸屏幕将使用标准尺寸的屏幕资源)。 但是,如果唯一可用的资源大于当前屏幕,则系统不会使用这些资源,并且如果没有其他资源与设备配置匹配,应用将会崩溃(例如,如果所有布局资源均用xlarge
限定符标记,但设备是标准尺寸的屏幕)。
注:限定符的优先顺序(表 2 中)比与设备完全匹配的限定符数量更加重要。例如,在上面的第 4 步中,列表剩下的最后选项包括三个与设备完全匹配的限定符(方向、触摸屏类型和输入法),而 drawable-en
只有一个匹配参数(语言)。但是,语言的优先顺序高于其他两个限定符,因此 drawable-port-notouch-12key
被淘汰。
如需了解有关如何在应用中使用资源的更多信息,请转至访问资源。
表 2. 配置限定符名称。
配置 | 限定符值 | 描述 |
---|---|---|
MCC 和 MNC | 示例:mcc310 mcc310-mnc004 mcc208-mnc00 等等 |
移动国家代码 (MCC),(可选)后跟设备 SIM 卡中的移动网络代码 (MNC)。例如, 如果设备使用无线电连接(GSM 手机),则 MCC 和 MNC 值来自 SIM 卡。 也可以单独使用 MCC(例如,将国家/地区特定的合法资源包括在应用中)。如果只需根据语言指定,则改用“语言和区域”限定符(稍后进行介绍)。 如果决定使用 MCC 和 MNC 限定符,请谨慎执行此操作并测试限定符是否按预期工作。 另请参阅配置字段 |
语言和区域 | 示例:en fr en-rUS fr-rFR fr-rCA 等等 |
语言通过由两个字母组成的 ISO 639-1 语言代码定义,(可选)后跟两个字母组成的 ISO 3166-1-alpha-2 区域码(前带小写字母“ 这些代码不区分大小写; 如果用户更改系统设置中的语言,它有可能在应用生命周期中发生改变。 如需了解这会在运行期间给应用带来哪些影响,请参阅处理运行时变更。 有关针对其他语言本地化应用的完整指南,请参阅本地化。 另请参阅 |
布局方向 | 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.) 注:要为应用启用从右到左的布局功能,必须将 此项为API 级别 17 中新增配置。 |
smallestWidth | sw<N>dp 示例: sw320dp sw600dp sw720dp 等等 |
屏幕的基本尺寸,由可用屏幕区域的最小尺寸指定。 具体来说,设备的 smallestWidth 是屏幕可用高度和宽度的最小尺寸(您也可以将其视为屏幕的“最小可能宽度”)。无论屏幕的当前方向如何,您均可使用此限定符确保应用 UI 的可用宽度至少为 例如,如果布局要求屏幕区域的最小尺寸始终至少为 600dp,则可使用此限定符创建布局资源 设备的 smallestWidth 将屏幕装饰元素和系统 UI 考虑在内。例如,如果设备的屏幕上有一些永久性 UI 元素占据沿 smallestWidth 轴的空间,则系统会声明 smallestWidth 小于实际屏幕尺寸,因为这些屏幕像素不适用于您的 UI。因此,使用的值应该是布局所需要的实际最小尺寸(通常,无论屏幕的当前方向如何,此值都是布局支持的“最小宽度”)。 以下是一些可用于普通屏幕尺寸的值:
应用为多个资源目录提供不同的 smallestWidth 限定符值时,系统会使用最接近(但未超出)设备 smallestWidth 的值。 此项为 API 级别 13 中新增配置。 另请参阅 如需了解有关设计不同屏幕和使用此限定符的详细信息,请参阅支持多个屏幕开发者指南。 |
可用宽度 | w<N>dp 示例: w720dp w1024dp 等等 |
指定资源应该使用的最小可用屏幕宽度,以 应用为多个资源目录提供不同的此配置值时,系统会使用最接近(但未超出)设备当前屏幕宽度的值。 此处的值考虑到了屏幕装饰元素,因此如果设备显示屏的左边缘或右边缘上有一些永久性 UI 元素,考虑到这些 UI 元素,它会使用小于实际屏幕尺寸的宽度值,这样会减少应用的可用空间。 此项为 API 级别 13 中新增配置。 另请参阅 如需了解有关设计不同屏幕和使用此限定符的详细信息,请参阅支持多个屏幕开发者指南。 |
可用高度 | h<N>dp 示例: h720dp h1024dp 等等 |
指定资源应该使用的最小可用屏幕高度,以“dp”为单位,由 应用为多个资源目录提供不同的此配置值时,系统会使用最接近(但未超出)设备当前屏幕高度的值。 此处的值考虑到了屏幕装饰元素,因此如果设备显示屏的上边缘或下边缘有一些永久性 UI 元素,考虑到这些 UI 元素,同时为减少应用的可用空间,它会使用小于实际屏幕尺寸的高度值。 非固定的屏幕装饰元素(例如,全屏时可隐藏的手机状态栏)并不在考虑范围内,标题栏或操作栏等窗口装饰也不在考虑范围内,因此应用必须准备好处理稍小于其所指定值的空间。 此项为 API 级别 13 中新增配置。 另请参阅 如需了解有关设计不同屏幕和使用此限定符的详细信息,请参阅支持多个屏幕开发者指南。 |
屏幕尺寸 | small normal large xlarge |
注:使用尺寸限定符并不表示资源仅适用于该尺寸的屏幕。 如果没有为备用资源提供最符合当前设备配置的限定符,则系统可能使用其中最匹配的资源。 注意:如果所有资源均使用大于当前屏幕的尺寸限定符,则系统不会使用这些资源,并且应用在运行时将会崩溃(例如,如果所有布局资源均用 此项为 API 级别 4 中新增配置。 如需了解详细信息,请参阅支持多个屏幕。 另请参阅 |
屏幕纵横比 | long notlong |
此项为 API 级别 4 中新增配置。 它完全基于屏幕的纵横比(宽屏较宽),而与屏幕方向无关。 另请参阅 |
屏幕方向 | port land |
如果用户旋转屏幕,它有可能在应用生命周期中发生改变。 如需了解这会在运行期间给应用带来哪些影响,请参阅处理运行时变更。 另请参阅 |
UI 模式 | car desk television appliance watch |
此项为 API 级别 8 中新增配置,API 13 中新增电视配置,API 20 中新增手表配置。 如需了解应用在设备插入手机座或从中移除时的响应方式,请阅读确定并监控插接状态和类型。 如果用户将设备放入手机座中,它有可能在应用生命周期中发生改变。 可以使用 |
夜间模式 | night notnight |
此项为 API 级别 8 中新增配置。 如果夜间模式停留在自动模式(默认),它有可能在应用生命周期中发生改变。在这种情况下,该模式会根据当天的时间进行调整。 可以使用 |
屏幕像素密度 (dpi) | ldpi mdpi hdpi xhdpi xxhdpi xxxhdpi nodpi tvdpi |
六个主要密度之间的缩放比为 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 |
另请参阅 |
键盘可用性 | keysexposed keyshidden keyssoft |
如果提供了 如果用户打开硬键盘,它有可能在应用生命周期中发生改变。 如需了解这会在运行期间给应用带来哪些影响,请参阅处理运行时变更。 另请参阅配置字段 |
主要文本输入法 | nokeys qwerty 12key |
另请参阅 |
导航键可用性 | navexposed navhidden |
如果用户显示导航键,它有可能在应用生命周期中发生改变。 如需了解这会在运行期间给应用带来哪些影响,请参阅处理运行时变更。 另请参阅 |
主要非触摸导航方法 | nonav dpad trackball wheel |
另请参阅 |
平台版本(API 级别) | 示例:v3 v4 v7 等等 |
设备支持的 API 级别。例如, |
注:有些配置限定符是从 Android 1.0 才开始添加,因此并非所有版本的 Android 系统都支持所有限定符。使用新限定符会隐式添加平台版本限定符,因此较旧版本系统的设备必然会忽略它。 例如,使用 w600dp
限定符会自动包括 v13
限定符,因为可用宽度限定符是 API 级别 13 中的新增配置。为了避免出现任何问题,请始终包含一组默认资源(一组“不带限定符”的资源)。 如需了解详细信息,请参阅利用资源提供最佳设备兼容性部分。