您的位置:首页 > 移动开发 > Android开发

Android资源文件夹命名规则

2017-01-16 15:46 204 查看


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


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

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

创建指定的具体资源文件:
在res/文件夹下创建一个新的目录:<resources_name>-<config_qualifier>
<resources_name>是默认的默认的目录名称(table1中定义的)
<qualifier>限制条件(table2中定义)

特殊资源目录名称可以有多个限制条件,每个限制条件用(-)短横线隔开。

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

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

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

Table2. 限定条件名称(详见Providing Resources的table2)
ConfigurationQuanlifier ValuesDescription
MCC and MNCExamples:

mcc310

mcc310-mnc004

mcc208-mnc00

etc.
sim卡运营商
Language and regionExamples:

en

fr

en-rUS

fr-rFR

fr-rCA

etc.
语言与地区
Layout Directionldrtl

ldltr
布局方向
smallestWidthsw<N>dp

Examples:

sw320dp

sw600dp

sw720dp

etc.
屏幕最小宽度
Available widthw<N>dp

Examples:

w720dp

w1024dp

etc.
屏幕最佳宽度
Available heighth<N>dp

Examples:

h720dp

h1024dp

etc.
屏幕最佳高度
Screen sizesmall

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

下图是对尺寸以及密度的一个粗略分类。


Screen aspectlong

notlong
屏幕长短边模式。

长宽比是屏幕的物理宽度与物理高度的比例关系。

long: Long screens, such as WQVGA, WVGA, FWVGA 

notlong: Not long screens, such as QVGA, HVGA, and VGA
Round screenround

notround
是否圆形屏幕

round: 圆形屏幕,如一些圆形穿戴设备

notround: 矩形屏幕,如手机、平板等
Screen orientationport

land
当前屏幕横屏竖屏显示模式

port: 设备在纵向(vertical)

land: 设备在横向(horizontal)
UI modecar

desk

television

appliance

watch
dock模式
Night modenight

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 typenotouch

finger
触摸屏类型
Keyboard availabilitykeysexposed

keyshidden

keyssoft
键盘类型
Primary text input methodnokeys

qwerty

12key
硬按键类型
Navigation key availabilitynavexposed

navhidden
方向键是否可用
Primary nontouch navigation methodnonav

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才添加的。


资源文件夹命名规则:

资源文件夹名称可以指定多个限定条件并用(-)短横线分开。如:drawable-en-rUS-land表示美式英语的横向设备。
限定条件必须按table2的优先级排序。如:
错误:drawable-hdpi-port
正确:drawable-port-hdpi

资源目录不允许嵌套。如:不能有 res/drawable/drawable-en这样的目录。
资源目录不区分大小写。
同一限定条件只能有一个值。如:drawable-rES-rFR是不被允许的,你必须把它分成两个单独的资源目录,drawable-rES和drawable-rFR。


命名方法与要求

命名不区分大小写
命名形式:资源名-属性1-属性2-属性3-属性4-属性5……

资源名就是table1的资源类型名,包括:drawable, values, layout, anim, raw, menu, color, animator, xml;

属性1-属性2-属性3-属性4-属性5……就是table2的属性,如:en-port-hdpi;

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


实例说明

把全部属性都用上的例子(个属性按优先级先后排列出来的)

values-mcc310-en-sw320dp-w720dp-h720dp-large-long-port-car-night-ldpi-notouch-keysexposed-nokeys-navexposed-nonav-v7
上述例子属性的中文说明

values-mcc310(sim卡运营商)-en(语言)-sw320dp(屏幕最小宽度)-w720dp(屏幕最佳宽度)-h720dp(屏幕最佳高度)-large(屏幕尺寸)-long(屏幕长短边模式)-port(当前屏幕横竖屏显示模式)-car(dock模式)-night(白天或夜晚)-ldpi(屏幕最佳dpi)-notouch(触摸屏模类型)-keysexposed(键盘类型)-nokey(硬按键类型)-navexposed(方向键是否可用)-nonav(方向键类型)-v7(android版本)


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

获取手机当前的基本配置信息(语言,横竖屏,屏幕密度,屏幕尺寸等等)
根据这些配置信息,排除apk包中与这些配置信息相矛盾的资源目录;如:系统语言为cn,那么所有的其他语言的目录都会被排除掉,注意系统并不会根据一个dpi的冲突而排除掉含有其他dpi的目录,dpi这个限制条件非常特殊。
按照限制条件的优先级,依次拿出配置信息中优先级最高的限制条件,去资源目录中寻找包含这个限制条件的目录,如果有,排除掉其他目录,根据配置中下一个优先级的限制条件继续匹配,如果没有,接着去拿下一个优先级的限制条件,继续寻找和排除,直到找到最合适的目录。

算法如下图:






实例

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

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
根据系统配置信息,首先排除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没有被清除

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

清除不包含此限制条件的所有目录。如:清除所有不包含语言的的目录:

drawable/

drawable-en/

drawable-en-port/

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

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

重复步骤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 
内容来自用户分享和网络整理,不保证内容的准确性,如有侵权内容,可联系管理员处理 点击这里给我发消息
标签:  android 屏幕适配