Android developer 阅读笔记--应用资源概览

编辑文章中的疑问
1 R类的原理

在android开发的过程中,应当保持良好的习惯,最好就是把与资源文件相关的东西外部化。例如,给TextView设置一个字符串的时候,不是采用直接把指定字符串传入setText()方法的参数中。而是引用String资源文件中的标签。这样假设用户切换了国家语言,这个标签也会根据规则自动的引用相应国家的string 文件,从而完成显示方面的语言切换。这样就可以很好的国际化。下面我们将一一讲解,资源文件相关东西。 是用来做什么的,下面有什么分类,系统是按照何种规则来选择相应的资源文件的。

用来做什么的

资源文件的主要作用就是解决多环境下的显示适配问题。在运行时,Android 会根据当前配置使用适当的资源。例如平板与手机屏幕不同,显示的界面可能也会不同,这时候我们需要写出分别适应平板和手机的界面,放入指定的文件夹下面。运行时,平板就会出平板的界面,手机就会出手机的界面。当然,运行时怎么选择相应文件是有一定规则的。这个稍后讨论。

代码上是怎么使用的

这个很简单,想必大家应该都用过。就是通过R类中生成的资源id来访问相应的资源, 例如TextView 中 setText(int id) 我们通常是这样使用的: setText(R.string.xxxxxxx);

文件结构

在这里插入图片描述

上面这张图片应该都很熟悉吧。我们的资源文件,就是被存储在res文件夹下面的。下面首先有四个子文件夹,并且这四个文件夹的名字 一定不要更改! 下面是这几个文件夹的用途:
drawable:存放图像资源文件
layout:用来存放布局资源
mipmap:用来存放启动图标
values:用来存放字符串资源
以上四个文件夹的名字不能更改,并且这四个文件夹只是andriod studio 默认帮我们建立好的。事实上,res 文件夹,可支持的子文件夹名称可不止是这些!也就是res可支持的资源类型其实有很多,下面看看它还可以支持啥子文件夹,以及各个名称的子文件夹的作用。每个文件夹所涉及的相关知识将在后期专门写文章,并给出相应链接。
animator/:用来定义属性动画的XML文件。
anim/:用来定义渐变动画的XML文件。(属性动画也可以保存在此目录中,但是为了区分这两种类型,属性动画首选 animator/ 目录。)
color/:用来定义颜色状态列表的XML文件
drawable/:位图文件(.png、.9.png、.jpg、.gif)或编译为以下可绘制对象资源子类型的 XML 文件:
位图文件
九宫格(可调整大小的位图)
状态列表
形状
动画可绘制对象
其他可绘制对象
**mipmap/**适用于不同启动器图标密度的可绘制对象文件。如需了解有关使用 mipmap/ 文件夹管理启动器图标的详细信息
**layout/**用于定义用户界面布局的XML文件。最常用!
**menu/**用于定义应用菜单(如选项菜单,上下文菜单或子菜单的XML文件)这个的用法不是很了解。
**raw/**以原始的形式保存文件。同时如果打开文件需要使用资源 ID(即 R.raw.filename)调用 Resources.openRawResource()。但是,如需访问原始文件名和文件层次结构,则可以考虑将某些资源保存在 assets/ 目录下(而不是 res/raw/)。assets/ 中的文件没有资源 ID,因此只能使用 AssetManager 读取这些文件。
**values/**这个文件夹的应用是非常普遍的!通常用于对语言字符串,颜色,建立新的属性等。
主要的有:
arrays.xml,用于资源数组(类型化数组)。
colors.xml:颜色值。
dimens.xml:尺寸值。
strings.xml:字符串值。
styles.xml:样式。
**xml/**这个文件夹说实话我根本没有用过。可在运行时调用 Resources.getXML() 读取任意的xml文件。各种xml配置文件如可搜索配置)都必须保存在此处。

以上的文件夹里存储的都是默认资源。也就是其他类型资源没有的情况下,就用它。但是其他情况是什么情况呢?
Android机型有千百种,有手机,平板,手表。难道走同样的代码,我展示的都要一模一样么?如果一模一样显然是不行的。让一个手表显示手机上的界面,那得丑到什么程度。。所以,采用Android系统的不同类型的设备设备之间,可能会需要符合自身特点的资源文件。比如屏幕尺寸大于标准尺寸的时候,可能加载的是另外一种样子的布局。
在这里插入图片描述

想要实现这样的效果,除了默认资源以外,我们还需要提供备用资源

提供备用资源

在开发应用中,每个应用都应当提供一些备用资源用于支持一些特殊的资源配置。比如针对不同屏幕密度的设备,和不同国家的文案语言。

如何指定备用资源?

1 在res/大文件夹下,创建一个以 <resorces_name>-<config_qualifier>[-<config_qualifier>] (资源名称-配置限定词后面可以跟随若干个配置限定词)
上一小节里面介绍的子文件夹,提到过名称不要更改,,此处的就是上面的文件夹名称。任意一个都可以。关键是你要做什么用,从而选择不同的名。
<config_qualifier> 是指定要使用这些资源的各个配置的名称,如图所示:
在这里插入图片描述
其中 drawable就是默认情况下的引用文件位置。drawable-xhdpi表示资源适用于屏幕密度较高的设备,当屏幕密度较高的时候,会自动引用drawable-xhdpi的文件。这样一来,用于引用 icon.png 或 background.png 图像的资源 ID 始终相同,但是 Android 会通过将设备配置信息与资源目录名称中的限定符进行比较,选择最符合当前设备的各个资源版本。
那么这种规则是什么呢?如我把手机语言变成English,文案就变成英文的文案。我该如何给文件夹起名字,总不能瞎起吧。

资源文件,子文件夹名字命名规则

接下来这套命名规则是重中之重!
配置 限定符值 说明,这套匹配规则的优先级是按照下面段落的前后来的,前面的段落匹配优先级高于后面的段落!

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 和 mnc,这两个字段分别表示当前的移动国家代码和移动网络代码。

语言和区域 示例:

en
fr
en-rUS
fr-rFR
fr-rCA
等等
语言通过由两个字母组成的 ISO 639-1 语言代码定义,可以选择后跟两个字母组成的 ISO 3166-1-alpha-2 区域码(前带小写字母“r”)。

这些代码不区分大小写;r 前缀用于区分区域码。 不能单独指定区域。

如果用户更改系统设置中的语言,它有可能在应用生命周期中发生改变。 可能会给应用带来影响。

有关针对其他语言本地化应用的完整指南,请参阅本地化。

另请参阅 locale 配置字段,该字段表示当前的语言区域。

布局方向 ldrtl

ldltr
应用的布局方向。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.)
注:要为应用启用从右到左的布局功能,必须将 supportsRtl 设置为 “true”,并将 targetSdkVersion 设置为 17 或更高版本。

此项为 API 级别 17 中新增配置。
smallestWidth swdp

示例:
sw320dp
sw600dp
sw720dp
等等
屏幕的基本尺寸,由可用屏幕区域的最小尺寸指定。 具体来说,设备的 smallestWidth 是屏幕可用高度和宽度的最小尺寸(您也可以将其视为屏幕的“最小可能宽度”)。无论屏幕的当前方向如何,您均可使用此限定符确保应用 UI 的可用宽度至少为 dp。

例如,如果布局要求屏幕区域的最小尺寸始终至少为 600dp,则可使用此限定符创建布局资源 res/layout-sw600dp/。仅当可用屏幕的最小尺寸至少为 600dp 时,系统才会使用这些资源,而不考虑 600dp 所代表的边是用户所认为的高度还是宽度。smallestWidth 是设备的固定屏幕尺寸特性;设备的 smallestWidth 不会随屏幕方向的变化而改变。

设备的 smallestWidth 将屏幕装饰元素和系统 UI 考虑在内。例如,如果设备的屏幕上有一些永久性 UI 元素占据沿 smallestWidth 轴的空间,则系统会声明 smallestWidth 小于实际屏幕尺寸,因为这些屏幕像素不适用于您的 UI。 因此,使用的值应该是布局所需要的实际最小尺寸(通常,无论屏幕的当前方向如何,此值都是布局支持的“最小宽度”)。

以下是一些可用于普通屏幕尺寸的值:

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 属性和 smallestScreenWidthDp 配置字段,前者声明与应用兼容的最小 smallestWidth;后者存放设备的 smallestWidth 值。

如需了解有关设计不同屏幕和使用此限定符的详细信息,请参阅支持多种屏幕开发者指南。

可用宽度 wdp

示例:
w720dp
w1024dp
等等
指定资源应该使用的最小可用屏幕宽度,以 dp 为单位,由 值定义。在横向和纵向之间切换时,为了匹配当前实际宽度,此配置值也会随之发生变化。

应用为多个资源目录提供不同的此配置值时,系统会使用最接近(但未超出)设备当前屏幕宽度的值。 此处的值考虑到了屏幕装饰元素,因此如果设备显示屏的左边缘或右边缘上有一些永久性 UI 元素,考虑到这些 UI 元素,它会使用小于实际屏幕尺寸的宽度值,这样会减少应用的可用空间。

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

另请参阅 screenWidthDp 配置字段,该字段存放当前屏幕宽度。

如需了解有关设计不同屏幕和使用此限定符的详细信息,请参阅支持多种屏幕开发者指南。
可用高度 hdp

示例:
h720dp
h1024dp
等等
指定资源应该使用的最小可用屏幕高度,以“dp”为单位,由 值定义。 在横向和纵向之间切换时,为了匹配当前实际高度,此配置值也会随之发生变化。

应用为多个资源目录提供不同的此配置值时,系统会使用最接近(但未超出)设备当前屏幕高度的值。 此处的值考虑到了屏幕装饰元素,因此如果设备显示屏的上边缘或下边缘有一些永久性 UI 元素,考虑到这些 UI 元素,同时为减少应用的可用空间,它会使用小于实际屏幕尺寸的高度值。 非固定的屏幕装饰元素(例如,全屏时可隐藏的手机状态栏)并不在考虑范围内,标题栏或操作栏等窗口装饰也不在考虑范围内,因此应用必须准备好处理稍小于其所指定值的空间。

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

另请参阅 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 配置字段,该字段表示屏幕是小尺寸、标准尺寸还是大尺寸。
屏幕纵横比 long
notlong
long:宽屏,如 WQVGA、WVGA、FWVGA
notlong:非宽屏,如 QVGA、HVGA 和 VGA
此项为 API 级别 4 中新增配置。

它完全基于屏幕的纵横比(宽屏较宽),而与屏幕方向无关。

另请参阅 screenLayout 配置字段,该字段指示屏幕是否为宽屏。
圆形屏幕 round
notround
round:圆形屏幕,例如圆形可穿戴式设备
notround:方形屏幕,例如手机或平板电脑
此项为 API 级别 23 中新增配置。

另请参阅 isScreenRound() 配置方法,其指示屏幕是否为宽屏。
屏幕方向 port
land
port:设备处于纵向(垂直)
land:设备处于横向(水平)
如果用户旋转屏幕,它有可能在应用生命周期中发生改变。 如需了解这会在运行期间给应用带来哪些影响,请参阅处理运行时变更。

另请参阅 orientation 配置字段,该字段指示当前的设备方向。
UI 模式 car
desk
television
appliance watch
car:设备正在车载手机座上显示
desk:设备正在桌面手机座上显示
television:设备正在电视上显示,为用户提供“十英尺”体验,其 UI 位于远离用户的大屏幕上,主要面向方向键或其他非指针式交互
appliance:设备用作不带显示屏的装置
watch:设备配有显示屏,戴在手腕上
此项为 API 级别 8 中新增配置,API 13 中新增电视配置,API 20 中新增手表配置。

如需了解应用在设备插入手机座或从中移除时的响应方式,请阅读确定并监控插接状态和类型。

如果用户将设备放入手机座中,它有可能在应用生命周期中发生改变。 可以使用 UiModeManager 启用或禁用其中某些模式。如需了解这会在运行期间给应用带来哪些影响,请参阅处理运行时变更。
夜间模式 night
notnight
night:夜间
notnight:白天
此项为 API 级别 8 中新增配置。

如果夜间模式停留在自动模式(默认),它有可能在应用生命周期中发生改变。在这种情况下,该模式会根据当天的时间进行调整。 可以使用 UiModeManager 启用或禁用此模式。如需了解这会在运行期间给应用带来哪些影响,请参阅处理运行时变更。
屏幕像素密度 (dpi) ldpi
mdpi
hdpi
xhdpi
xxhdpi
xxxhdpi
nodpi
tvdpi
anydpi
ldpi:低密度屏幕;约为 120dpi。
mdpi:中等密度(传统 HVGA)屏幕;约为 160dpi。
hdpi:高密度屏幕;约为 240dpi。
xhdpi:超高密度屏幕;约为 320dpi。此项为 API 级别 8 中新增配置
xxhdpi:超超高密度屏幕;约为 480dpi。此项为 API 级别 16 中新增配置
xxxhdpi:超超超高密度屏幕使用(仅限启动器图标,请参阅“支持多种屏幕”中的注释);约为 640dpi。 此项为 API 级别 18 中新增配置
nodpi:它可用于您不希望缩放以匹配设备密度的位图资源。
tvdpi:密度介于 mdpi 和 hdpi 之间的屏幕;约为 213dpi。它并不是“主要”密度组, 主要用于电视,而大多数应用都不需要它。对于大多数应用而言,提供 mdpi 和 hdpi 资源便已足够,系统将根据需要对其进行缩放。此项为 API 级别 13 中新增配置
anydpi:此限定符适合所有屏幕密度,其优先级高于其他限定符。 这对于矢量可绘制对象很有用。 此项为 API 级别 21 中新增配置
六个主要密度之间的缩放比为 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
notouch:设备没有触摸屏。
finger:设备有一个专供用户通过手指直接与其交互的触摸屏。
另请参阅 touchscreen 配置字段,该字段指示设备上的触摸屏类型。
键盘可用性 keysexposed
keyshidden
keyssoft
keysexposed:设备具有可用的键盘。如果设备启用了软键盘(不无可能),那么即使硬键盘没有展示给用户,哪怕设备没有硬键盘,也可以使用此限定符。 如果没有提供或已经禁用软键盘,则只有在显示硬键盘时才会使用此限定符。
keyshidden:设备具有可用的硬键盘,但它处于隐藏状态,且设备没有启用软键盘。
keyssoft:设备已经启用软键盘(无论是否可见)。
如果提供了 keysexposed 资源,但未提供 keyssoft 资源,那么只要系统已经启用软键盘,就会使用 keysexposed 资源,而不考虑键盘是否可见。

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

另请参阅配置字段 hardKeyboardHidden 和 keyboardHidden,这两个字段分别指示硬键盘的可见性和任何一种键盘(包括软键盘)的可见性。
主要文本输入法 nokeys
qwerty
12key
nokeys:设备没有用于文本输入的硬按键。
qwerty:设备具有标准硬键盘(无论是否对用户可见)。
12key:设备具有 12 键硬键盘(无论是否对用户可见)。
另请参阅 keyboard 配置字段,该字段指示可用的主要文本输入法。
导航键可用性 navexposed
navhidden
navexposed:导航键可供用户使用。
navhidden:导航键不可用(例如,位于密封盖子后面)。
如果用户显示导航键,它有可能在应用生命周期中发生改变。 如需了解这会在运行期间给应用带来哪些影响,请参阅处理运行时变更。

另请参阅 navigationHidden 配置字段,该字段指示导航键是否处于隐藏状态。
主要非触摸导航方法 nonav
dpad
trackball
wheel
nonav:除了使用触摸屏以外,设备没有其他导航设施。
dpad:设备具有用于导航的方向键。
trackball:设备具有用于导航的轨迹球。
wheel:设备具有用于导航的方向盘(不常见)。
另请参阅 navigation 配置字段,该字段指示可用的导航方法类型。
平台版本(API 级别) 示例:
v3
v4
v7
等等
设备支持的 API 级别。例如,v1 对应于 API 级别 1(带有 Android 1.0 或更高版本系统的设备),v4 对应于 API 级别 4(带有 Android 1.6 或更高版本系统的设备)。如需了解有关这些值的详细信息,请参阅 Android API 级别文档。

限定符的命名规则

文件名的格式为 drawable-port-hdpi 短横线进行连接,并且连接后面的文字严格按照上面段落的名称来,切严格遵守段落的顺序来,这个循序说白了就是优先级。比如。
错误:drawable-hdpi-port/
正确:drawable-port-hdpi/

创建别名资源–图片

例如一个图片资源 a.png,是默认资源。就在drawable文件夹下。 然后,当当前国家为亚太地区国家的时候,比如日本,韩国,的时候,都要使用 b.png,在美国,英国等一些国家使用c.png, 如果找不到资源,那就直接取 a.png。
但是,根据资源本地化的规则,你可能会建立很多个文件夹,叫 drawable-xxx-xxx, 里面要把 b.png拷贝进去或者 c.png拷贝到美国等一些国家去,再对他们的名字进行修改,都改成a.png。这样程序引用的时候,写getDrawable(R.drawable.a), 通过代码就能找到正确的文件了。。但是有对少个国家我们真的就有必要拷贝多少份吗???
其实是有简单的方法的。可以省下不少资源。我们直接把b.png, c.png放到默认路径drawable,然后当引用本地化文件的时候,用一种方式告知,此时应当用哪个文件。要做的方式就是,在drawable-xxx-xxx这类文件下,写一个名叫a.xml,在a.xml中进行描述,告知要取的是 b.png, 或者c.png。代码如下:
图片资源

<?xml version="1.0" encoding="utf-8"?>
<bitmap xmlns:android="http://schemas.android.com/apk/res/android"
    android:src="@drawable/b" />

layout文件
同样的,layout文件也可以被这样引用。使用的标签是merge 和 include。文件取名与默认文件夹对应的名称相同。

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

其余的简单文件也可以这样用,不过感觉也节省不了什么资源。

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <string name="hello">Hello</string>
    <string name="hi">@string/hello</string>
</resources>
<?xml version="1.0" encoding="utf-8"?>
<resources>
    <color name="red">#f00</color>
    <color name="highlight">@color/red</color>
</resources>

猜你喜欢

转载自blog.csdn.net/weixin_28774815/article/details/83006138