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>