Android屏幕适配-资源文件夹命名及匹配规则

几乎所有的应用都要提另外的特殊资源来适配特殊配置的设备。例如:你必须提供不同尺寸的图片资源以适配不同屏幕密度的设备;你需要提供多个string资源文件以支持国际化。Android会根据当前设备的配置来加载适当的资源。

一. Android资源文件夹命名规则

android资源文件夹默认的命名见Providing Resources的table1

创建指定的具体资源文件:

  1. 在res/文件夹下创建一个新的目录:<resources_name>-<config_qualifier>
    • <resources_name>是默认的默认的目录名称(table1中定义的)
    • <qualifier>限制条件(table2中定义)
      特殊资源目录名称可以有多个限制条件,每个限制条件用(-)短横线隔开。

警告:特殊资源目录名的多个限制条件必须按table2的优先级排列。如果限定条件的排列顺序错误,则编译不通过。

  1. 特殊资源目录中资源文件名称必须与默认资源目录下的资源文件名称相同。

Table2按优先级列出了所有限定条件。如果你的资源目录用到了多个限定条件,你必须按下表的名称顺命名。
Table2. 限定条件名称(详见Providing Resources的table2)

Configuration Quanlifier Values Description
MCC and MNC Examples:
mcc310
mcc310-mnc004
mcc208-mnc00
etc.
sim卡运营商
Language and region Examples:
en
fr
en-rUS
fr-rFR
fr-rCA
etc.
语言与地区
Layout Direction ldrtl
ldltr
布局方向
smallestWidth sw<N>dp
Examples:
sw320dp
sw600dp
sw720dp
etc.
屏幕最小宽度
Available width w<N>dp
Examples:
w720dp
w1024dp
etc.
屏幕最佳宽度
Available height h<N>dp
Examples:
h720dp
h1024dp
etc.
屏幕最佳高度
Screen size small
normal
large
xlarge
屏幕尺寸。
实际物理尺寸。就是我们常说的3.5英寸屏幕,4.7英寸屏幕等等,这个长度说的是对角线的长度。
在android中屏幕物理尺寸划分为这么几类:small,normal,large,extra large。
xlarge screens are at least 960dp x 720dp
large screen are at least 640dp x 480dp
normal screens are at least 470dp x 320dp
small screens are at least 426dp x 320dp
下图是对尺寸以及密度的一个粗略分类。
Alt text
Screen aspect long
notlong
屏幕长短边模式。
长宽比是屏幕的物理宽度与物理高度的比例关系。
long: Long screens, such as WQVGA, WVGA, FWVGA
notlong: Not long screens, such as QVGA, HVGA, and VGA
Round screen round
notround
是否圆形屏幕
round: 圆形屏幕,如一些圆形穿戴设备
notround: 矩形屏幕,如手机、平板等
Screen orientation port
land
当前屏幕横屏竖屏显示模式
port: 设备在纵向(vertical)
land: 设备在横向(horizontal)
UI mode car
desk
television
appliance
watch
dock模式
Night mode night
notnight
night: 晚上
notnight: 白天
Screen pixel density(dpi) ldpi
mdpi
hdpi
xhdpi
xxhdpi
xxxhdpi
nodpi
tvdpi
屏幕最佳dpi
ldpi: ~120dpi
mdpi: ~160dpi
hdpi: ~240dpi
xhdpi: ~320dpi
xxhdpi: ~480dpi
xxxhdpi: ~640dpi
nodpi: 可用于不想随屏幕密度缩放的bitmap资源
tvdpi: 屏幕密度介于mdpi与hdpi之间,大约为213dpi。
Touchscreen type notouch
finger
触摸屏类型
Keyboard availability keysexposed
keyshidden
keyssoft
键盘类型
Primary text input method nokeys
qwerty
12key
硬按键类型
Navigation key availability navexposed
navhidden
方向键是否可用
Primary nontouch navigation method nonav
dpad
trackball
whell
方向键类型
Platform Version(API level) Examples:
v3
v4
v7
etc.
android版本

注意:有些限定条件是从android 1.0就开始支持的,所以不是所有的Android版本都支持所有的限定条件。一个新版的限定条件,默认包含了android版本的限定条件,旧版Android会会自动忽略这个限定条件的资源文件夹。例如:values-w600dp的资源文件夹默认自动包含了v13的限定条件,因为available-width这个限定条件是从API v13才添加的。

资源文件夹命名规则:

命名方法与要求

注意:各属性的位置顺序必须最受优先级从高到低排列,否则编译不通过。

实例说明

二. 系统如何确定最佳资源

算法如下图:

Alt text Alt text

实例

如:在一下资源目录中含有同一个文件名的图片资源。

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

并假设当前系统配置为:

Locale = en-GB
Screen orientation = port
Screen pixel density = hdpi
Touchscreen type = notouch
Primary text input method = 12key

系统匹配最佳资源的过程为: 首先限制条件的优先级为:en-GB, port, hdpi, nottouch, 12key

  1. 根据系统配置信息,首先排除drawable-fr-rCA 这个目录,因为fr和en冲突。

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

注意:因为dpi使用match选择,所以drawable-port-ldpi没有被清除

  1. 根据限制条件优先级,选择最高优先级限制条件(MCC最高,然后依次向下选择)
  2. 是否有资源目录包含这个限制条件?
    • 没有,返回步骤2,并查看下一个限制条件。(本例中,没有符合的限制条件直到语言和地域)。
    • 有,继续步骤4。
  3. 清除不包含此限制条件的所有目录。如:清除所有不包含语言的的目录:

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

注意:如果限定条件是屏幕像素密度,系统选择设备最匹配的屏幕密度。

  1. 重复步骤2和3,直到步骤4中只剩下一个文件夹则返回。本例中,屏幕方向是下一个最高优先级的属性,所以可以清除两个文件夹:

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

最终的文件夹就是drawable-en-port/

参考资料

http://developer.android.com/guide/topics/resources/providing-resources.html
http://developer.android.com/guide/practices/screens_support.html
http://ivan-ru.iteye.com/blog/1711414
http://www.cnblogs.com/idealgrass/p/4271272.html

Table of Contents