安卓基础

Android Resource

2017-02-08  本文已影响821人  CP9

概述

对于Android中的应用资源，例如图像、字符串、布局、颜色等，最好是在res文件夹中定义，而不是在代码中定义，这样有利于你单独维护这些资源。此外，你还应该为特定设备提供备用资源，将它们分组到专门命名的资源目录中，当运行时，Android会根据当前配置使用适当的资源。例如，你可能需要根据屏幕尺寸提供不同的UI布局，或者根据语言设置提供不同的字符串。

res/目录内支持的资源目录

名称 文件 描述
属性动画 animator 定义property动画的XML文件
渐变动画 anim 定义tween动画的XML文件（属性动画也可以保存在此目录中，但是为了区分两种类型，属性动画首选animator目录）
颜色 color 用于定义颜色状态列表的XML文件。Color State List
图片 drawable 位图文件（.png、.9.png、.jpg、.gif）或编译为可绘制对象资源（位图文件、九宫格、状态列表、形状、动画可绘制对象、其他可绘制对象）子类型的XML文件。Drawable State List
布局 layout 定义UI布局的XML文件
mipmap mipmap 适用于不同像素密度的启动器图标的可绘制对象文件
菜单 menu 定义菜单或action bar的XML文件
raw raw 要以原始形式保存的任意文件，如果需要访问原始文件名和文件层次结构，则可以考虑将某些资源保存在assets目录下（而不是res/raw）
xml xml 可以在运行时通过调用Resources.getXML()读取的任意XML文件。各种XML配置文件（如可搜索配置）都必须保存在此处
值 values 定义strings、integers、colors等值的XML文件
颜色 res/values/colors.xml 定义例如文本颜色等颜色的XML文件
尺寸 res/values/dimens.xml 定义例如间距等尺寸的XML文件
字符串 res/values/strings.xml 定义例如标题文本等字符串的XML文件
样式 res/values/styles.xml 定义例如AppBar的颜色等样式的XML文件

注意：切勿将资源文件直接保存在res/目录内，将会导致编译错误。

提供备用资源文件来适配各种设备配置

配置限定符名称

配置 限定符值 说明
MCC和 MNC 示例：mcc310、mcc310-mnc004、mcc208-mnc00等等 <ul><li>移动国家代码（MCC），（可选），设备SIM卡中的移动网络代码（MNC）。</li><li>例如，mcc310是指美国的任一运营商，mcc310-mnc004是指美国的 Verizon 公司，mcc208-mnc00是指法国的 Orange 公司。</li><li>如果设备使用无线电链接（GSM手机），则MCC和MNC值来自SIM卡。</li><li>如果只需要根据语言指定，则改用“语言和区域”限定符。如果决定使用MCC和MNC限定符，请谨慎执行此操作饼测试限定符是否按预期工作</li></ul>
语言和区域 示例：en、fr、en-rUS、fr-rFR、fr-rCA等等 <ul><li>语言限定符命名：由两个字母组成的 ISO 639-1语言代码 +（可选）符号“-” + （可选）ISO 3166-1-alpha-2区域码，例如en和en-rUS</li><li>这些代码不区分大小写，r前缀用于区分区域码。不能单独指定区域</li><li>如果用户更改系统设置中的语言，它有可能在应用声明周期中发生改变。参阅处理运行时变更</li><li>针对其他语言本地化应用的完整指南，参阅本地化</li>
布局方向 ldrtl、ldltr <ul><li>应用的布局方向。ldrtl是指“布局方向从右到左”。ldltr是指“布局方向从左到右”，这是默认值。</li><li>它适用于布局、图片或值等任何资源</li> <br > <blockquote>注意：要为应用启用从右到左的布局功能，必须将 supportsRtl设置为“true”，并将 targetSdkVersion设置为17或更高版本</blockquote>
smallestWidth sw<N>dp <br > 例如：sw320dp、sw600dp等等 <ul><li>屏幕的基本尺寸，由可用屏幕区域的最小尺寸指定。具体来说，设备的smallestWidth是屏幕可用高度和宽度的最小尺寸。无论屏幕的当前方向如何，均可使用此限定符确保应用UI的可用宽度至少为<N>dp。</li><li>设备的smallestWidth将屏幕装饰元素和系统UI考虑在内。例如，如果设备的屏幕上有一些永久性 UI 元素占据沿 smallestWidth 轴的空间，则系统会声明 smallestWidth 小于实际屏幕尺寸，因为这些屏幕像素不适用于您的 UI。 因此，使用的值应该是布局所需要的实际最小尺寸（通常，无论屏幕的当前方向如何，此值都是布局支持的“最小宽度”）</li><li>应用为多个资源目录提供不同的smallestWidth限定符值时，系统会使用最接近（但未超出）设备smallestWidth的值。</li><li><a href="https://developer.android.com/guide/topics/manifest/supports-screens-element.html#requiresSmallest">android:requiresSmallestWidthDp</a>声明应用兼容的smallestWidth，<a href="https://developer.android.com/reference/android/content/res/Configuration.html#smallestScreenWidthDp">smallestScreenWidthDp</a>存放设备的smallestWidth值</li></ul>
可用宽度 w<N>dp <br > 例如：w720dp、w1024dp等等 指定资源使用的最小可用屏幕宽度，以dp为单位，由<N>值定义。在横向和纵向之间切换时，为了匹配当前实际宽度，此配置值也会随之发生变化。<a href="https://developer.android.com/reference/android/content/res/Configuration.html#screenWidthDp">android:screenWidthDp</a>存放当前屏幕宽度
可用高度 h<N>dp <br > 例如：h720dp、h1024dp等等 与可用宽度类似，<a href="https://developer.android.com/reference/android/content/res/Configuration.html#screenHeightDp">android:screenHeightDp</a>存放当前屏幕高度
屏幕尺寸 small、normal、large、xlarge <ul><li>small：尺寸类似于低密度 QVGA 屏幕的屏幕。小屏幕的最小布局尺寸约为 320x426 dp 单位。例如，QVGA 低密度屏幕和 VGA 高密度屏幕。</li><li>normal：尺寸类似于中等密度 HVGA 屏幕的屏幕。标准屏幕的最小布局尺寸约为 320x470 dp 单位。例如，WQVGA 低密度屏幕、HVGA 中等密度屏幕、WVGA 高密度屏幕。</li><li>large：尺寸类似于中等密度 VGA 屏幕的屏幕。 大屏幕的最小布局尺寸约为 480x640 dp 单位。 例如，VGA 和 WVGA 中等密度屏幕。</li>xlarge：明显大于传统中等密度 HVGA 屏幕的屏幕。超大屏幕的最小布局尺寸约为 720x960 dp 单位。在大多数情况下，屏幕超大的设备体积过大，不能放进口袋，最常见的是平板式设备。 API 级别 9 中的新增配置。<br ><br > <a href="https://developer.android.com/reference/android/content/res/Configuration.html#screenLayout">screenLayout</a>指示屏幕是小尺寸、标准尺寸还是大尺寸
屏幕纵横比 long、notlong long：宽屏，如 WQVGA、WVGA、FWVGA；notlong：非宽屏，如QVGA、HVGA和VGA，它完全基于屏幕的纵横比，而与屏幕方向无关。<a href="https://developer.android.com/reference/android/content/res/Configuration.html#screenLayout">screenLayout</a>指示屏幕是否为宽屏
圆形屏幕 round、notround round：圆形屏幕，例如圆形可穿戴式设备；notround：方形屏幕，例如手机或平板电脑。<a href="https://developer.android.com/reference/android/content/res/Configuration.html#isScreenRound()">isScreenRound()</a>方法指示屏幕是否为宽屏
屏幕方向 port、land port：设备处于纵向（垂直）；land：设备处于横向（水平）。如果用户旋转屏幕，它有可能在应用生命周期中发生改变。 如需了解这会在运行期间给应用带来哪些影响，请参阅处理运行时变更。orientation指示当前的设备方向
UI 模式 car、desk、television、appliance、watch car：设备正在车载手机座上显示；desk：设备正在桌面手机座上显示；television：设备正在电视上显示，为用户提供“十英尺”体验，其 UI 位于远离用户的大屏幕上，主要面向方向键或其他非指针式交互；appliance：设备用作不带显示屏的装置；watch：设备配有显示屏，戴在手腕上。如需了解应用在设备插入手机座或从中移除时的响应方式，请阅读确定并监控插接状态和类型。如果用户将设备放入手机座中，它有可能在应用生命周期中发生改变。 可以使用 UiModeManager启用或禁用其中某些模式。如需了解这会在运行期间给应用带来哪些影响，请参阅处理运行时变更。
夜间模式 night、notnight night：夜间；notnight：白天。如果夜间模式停留在自动模式（默认），它有可能在应用生命周期中发生改变。在这种情况下，该模式会根据当天的时间进行调整。 可以使用 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。<br ><br ><blockquote>注：使用密度限定符并不表示资源仅适用于该密度的屏幕。 如果没有为备用资源提供最符合当前设备配置的限定符，则系统可能使用其中最匹配的资源。</blockquote>
触摸屏类型 notouch、finger notouch：设备没有触摸屏；finger：设备有一个专供用户通过手指直接与其交互的触摸屏。touchscreen指示设备上的触摸屏类型。
键盘可用性 keysexposed、keyshidden、keyssoft <ul><li>keysexposed：设备具有可用的键盘。如果设备启用了软键盘（不无可能），那么即使硬键盘没有展示给用户，哪怕设备没有硬键盘，也可以使用此限定符。** 如果没有提供或已经禁用软键盘，则只有在显示硬键盘时才会使用此限定符。</li><li>keyshidden：设备具有可用的硬键盘，但它处于隐藏状态，且设备没有启用软键盘。</li><li>keyssoft：设备已经启用软键盘（无论是否可见）。</li> <br ><br > 如果提供了 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 级别文档。

限定符命名规则

创建别名资源

如果您想将某一资源用于多种设备配置（但是不想作为默认资源提供），则无需将同一资源放入多个备用资源目录中。 相反，您可以（在某些情况下）创建备用资源，充当保存在默认资源目录下的资源的别名。

注：并非所有资源都会提供相应机制让您创建指向其他资源的别名。 特别是，xml/
目录中的动画资源、菜单资源、原始资源以及其他未指定资源均不提供此功能。

例如，假设您有一个应用图标 icon.png，并且需要不同语言区域的独特版本。 但是，加拿大英语和加拿大法语这两种语言区域需要使用同一版本。 您可能会认为需要将相同的图像复制到加拿大英语和加拿大法语对应的资源目录中，但事实并非如此。 相反，您可以将用于二者的图像另存为 icon_ca.png（除 icon.png以外的任何名称），并将其放入默认 res/drawable/目录中。然后，在 res/drawable-en-rCA/和 res/drawable-fr-rCA/中创建 icon.xml文件，使用 <bitmap>元素引用 icon_ca.png资源。这样，您只需存储 PNG 文件的一个版本和两个指向该版本的小型 XML 文件。（XML 文件示例如下。）

可绘制对象

要创建指向现有可绘制对象的别名，请使用 <bitmap>元素。例如：

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

定义字符串资源

对于要在应用程序中显示的每一段文本（即按钮的标签或TextView的文本），应首先在res/values/strings.xml中定义文本。每条都有一个键（表示文本的id）和一个值（文本本身）。例如，如果我想要一个按钮显示“提交”，我可以在res/values/strings.xml添加以下字符串资源：

<?xml version="1.0" encoding="utf-8"?>
<resources> 
    <string name="hello">Hello!</string> 
    <string name="submit_label">Submit</string>
</resources>

如果将此文件另存为 icon.xml（例如，在备用资源目录中，另存为 res/drawable-en-rCA/
），则会编译到可作为 R.drawable.icon引用的资源中，但实际上它是 R.drawable.icon_ca资源（保存在 res/drawable/中）的别名。

布局

要创建指向现有布局的别名，请使用包装在 <merge>中的 <include>元素。例如：

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

如果将此文件另存为 main.xml，则会编译到可作为 R.layout.main引用的资源中，但实际上它是 R.layout.main_ltr 资源的别名。

利用资源提供最佳设备兼容性

要使应用支持多种设备配置，则务必为应用使用的每种资源类型提供默认资源。

这条规则有一个例外：如果应用的 minSdkVersion
 为 4 或更高版本，则在提供带屏幕密度限定符的备用可绘制对象资源时，不**需要默认可绘制对象资源。 即使没有默认可绘制对象资源，Android 也可以从备用屏幕密度中找到最佳匹配项并根据需要缩放位图。 但是，为了在所有类型的设备上提供最佳体验，您应该为所有三种类型的密度提供备用可绘制对象。

Android 如何查找最佳匹配资源

当您请求要为其提供备用资源的资源时，Android 会根据当前的设备配置选择要在运行时使用的备用资源。为演示 Android 如何选择备用资源，假设以下可绘制对象目录分别包含相同图像的不同版本：

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 中选择可绘制对象。

系统使用以下逻辑决定要使用的资源：

  1. 淘汰与设备配置冲突的资源文件。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/
未被淘汰，因为此时每个屏幕密度均视为匹配。如需了解详细信息，请参阅支持多种屏幕文档。

  1. 选择列表（表 2）中（下一个）优先级最高的限定符。（先从 MCC 开始，然后下移。）

  2. 是否有资源目录包括此限定符？

    • 若无，请返回到第 2 步，看看下一个限定符。（在该示例中，除非达到语言限定符，否则答案始终为“否”。）
    • 若有，请继续执行第 4 步。

  3. 淘汰不含此限定符的资源目录。在该示例中，系统会淘汰所有不含语言限定符的目录。
    drawable/
    drawable-en/
    drawable-en-port/
    drawable-en-notouch-12key/
    drawable-port-ldpi/
    drawable-port-notouch-12key/

例外：如果涉及的限定符是屏幕像素密度，则 Android 会选择最接近设备屏幕密度的选项。通常，Android 倾向于缩小大型原始图像，而不是放大小型原始图像。请参阅支持多种屏幕。

  1. 返回并重复第 2 步、第 3 步和第 4 步，直到只剩下一个目录为止。在此示例中，屏幕方向是下一个判断是否匹配的限定符。因此，未指定屏幕方向的资源被淘汰：
    drawable-en/
    drawable-en-port/
    drawable-en-notouch-12key/
    剩下的目录是 drawable-en-port 。

尽管对所请求的每个资源均执行此程序，但是系统仍会对某些方面做进一步优化。 例如，系统一旦知道设备配置，即会淘汰可能永远无法匹配的备用资源。 比如说，如果配置语言是英语（“en”），则系统绝不会将语言限定符设置为非英语的任何资源目录包含在选中的资源池中（不过，仍会将不带语言限定符的资源目录包含在该池中）。

注：限定符的优先顺序（表 2 中）比与设备完全匹配的限定符数量更加重要。**例如，在上面的第 4 步中，列表剩下的最后选项包括三个与设备完全匹配的限定符（方向、触摸屏类型和输入法），而 drawable-en
只有一个匹配参数（语言）。但是，语言的优先顺序高于其他两个限定符，因此drawable-port-notouch-12key
被淘汰。

定义和访问资源

你还可以创建符合Android国际化标准的XML文件（），以便于在不同国家或设备之间更改此值。除此之外，我们还可以通过使用CDATA来转义字符串来存储更复杂的字符串（带有html或特殊字符），例如：

<?xml version="1.0" encoding="utf-8"?>
<resources> 
      <string name="feedback_label"> 
              <![CDATA[ Please <a href="http://highlight.com">let us know</a> 
              if you have feedback on this or if you would like to log in with another identity service. Thanks! This is a longer string! ]]> 
      </string>
</resources>

访问资源

通过引用资源ID来访问该资源。所有资源ID都在项目的R类定义，后者由aapt工具自动生成。

编译应用时，aapt会生成R类，其中包含res/目录中所有资源的资源ID。

资源ID始终由以下部分组成：

在布局XML文件中引用

使用@符号来访问资源

<Button 
        android:layout_width="match_parent" 
        android:layout_height="wrap_content" 
        android:text="@string/submit_label" />

在Java文件中引用

使用getResources.getString或·getString·方法来访问资源


String submitText = getResources().getString(R.string.submit_label)

其他资源例如图片、颜色等和字符串的引用类似。

定义颜色资源

<?xml version="1.0" encoding="utf-8"?>
<resources> 
<color name="white">#FFFFFF</color> 
<color name="yellow">#FFFF00</color> 
<color name="fuchsia">#FF00FF</color></resources>

在Java文件中引用颜色资源

// getResources().getColor() is now deprecated
// Resources res = getResources();
// int color = res.getColor(R.color.yellow); 
// Use ContextCompatResources instead of getColor()

int color = ContextCompat.getColor(context, R.color.yellow);

注意：访问颜色资源的最新方式（从API 24开始），需要提供Context以解析任何自定义主题属性。更多有关颜色资源

在XML文件中引用颜色资源

与字符串资源类似，都是使用@符号来访问资源

定义尺寸资源

<?xml version="1.0" encoding="utf-8"?>
<resources> 
<dimen name="textview_height">25dp</dimen>
<dimen name="textview_width">150dp</dimen>
<dimen name="ball_radius">30dp</dimen>
<dimen name="font_size">16sp</dimen>

在Java文件中引用尺寸资源

Resources res = getResources();
float fontSize = res.getDimension(R.dimen.font_size);

在XML文件中引用尺寸资源

与字符串资源类似，都是使用@符号来访问资源

动态资源检索

在某些情况下，你可能希望使用键名称而不是通过资源ID来动态检索资源。例如，假设我想单独根据键名检索“submit_label”字符串。可以通过在Activity中使用getIdentifier()方法来实现：

public String getStringValue(String key) { 
            // Retrieve the resource id String 
            packageName = getBaseContext().getPackageName(); 
            Resources resources = getBaseContext().getResources(); 
            int stringId = resources.getIdentifier(key, "string", packageName); 
            if (stringId == 0) {
             return null; 
            }
            // Return the string value based on the res id 
            return resources.getString(stringId);
}

类似地，也可以对其他类型的资源检索。例如，动态检索ID：

// getViewById("tvTest");
public String getStringValue(String key) { 
            // Retrieve the resource id
            String packageName = getBaseContext().getPackageName(); 
            Resources resources = getBaseContext().getResources();
            int viewId = resources.getIdentifier(id, "id", packageName);
            if (viewId == 0) {
             return null; 
            }
            // Return the string value based on the res id
            return findViewById(viewId);
}

提供备用资源

几乎每个应用都应提供备用资源以支持特定的设备配置。例如，对于不同的屏幕密度和语言，你应分别包括备用可绘制对象资源和备用字符串资源。在运行时，Android会检测当前设备配置并为应用加载合适的资源。

我们在res中以[resource]-[qualifiers]的形式创建一个新目录。例如，为多个屏幕密度提供所有图像

Android的限定符

配置 示例 描述
语言 en,fr 在设备上选择的语言
屏幕大小 sw480dp,sw600dp 屏幕高度或宽度的最小值
屏幕方向 port,land 屏幕是横屏还是竖屏
屏幕密度 hdpi,xhdpi 屏幕密度通常用于图像
平台版本 v7,v11,v21 平台版本通常用于样式

你可以为单个资源集指定多个限定符，以段划线分隔。例如，drawable-en-sw600dp-land适用于选择了英语环境且横屏的平板。注意，如果对资源目录使用多个限定符，则必须按照上表列出的顺序将它们添加到目录名称。参考官方文档

创建替代资源

alternate layout

最佳布局实践

确保你的应用程序能否完美适配

上一篇下一篇

猜你喜欢

热点阅读