更多资源类型

本页面定义了以下可具体化的资源类型:

Bool
包含布尔值的 XML 资源。
颜色
包含颜色值(十六进制颜色)的 XML 资源。
尺寸
包含尺寸值(及度量单位)的 XML 资源。
ID
提供应用资源和组件的唯一标识符的 XML 资源。
整数
包含整数值的 XML 资源。
整数数组
提供整数数组的 XML 资源。
类型化数组
提供 TypedArray(可用于可绘制对象数组)的 XML 资源。

Bool

在 XML 中定义的布尔值。

注意:Bool 是使用 name 属性中提供的值(而不是 XML 文件的名称)引用的简单资源。因此,您可以在一个 XML 文件中将 Bool 资源与其他简单资源合并到一个 <resources> 元素下。

文件位置:
res/values/filename.xml
文件名可以任意设置。<bool> 元素的 name 用作资源 ID。
资源引用:
在 Java 中:R.bool.bool_name
在 XML 中:@[package:]bool/bool_name
语法:
<?xml version="1.0" encoding="utf-8"?>
<resources>
    <bool
        name="bool_name"
        >[true | false]</bool>
</resources>
元素:
<resources>
必需。这是根节点。

无属性。

<bool>
布尔值:truefalse

属性:

name
字符串。Bool 值的名称。此名称用作资源 ID。
示例:
保存在 res/values-small/bools.xml 的 XML 文件:
<?xml version="1.0" encoding="utf-8"?>
<resources>
    <bool name="screen_small">true</bool>
    <bool name="adjust_view_bounds">true</bool>
</resources>

以下应用代码会检索布尔值:

Kotlin

val screenIsSmall: Boolean = resources.getBoolean(R.bool.screen_small)

Java

Resources res = getResources();
boolean screenIsSmall = res.getBoolean(R.bool.screen_small);

以下布局 XML 会将该布尔值应用到属性:

<ImageView
    android:layout_height="fill_parent"
    android:layout_width="fill_parent"
    android:src="@drawable/logo"
    android:adjustViewBounds="@bool/adjust_view_bounds" />

颜色

在 XML 中定义的颜色值。 颜色使用 RGB 值和 Alpha 通道指定。您可以在接受十六进制颜色值的任何地方使用颜色资源。当 XML 中需要可绘制资源时,您也可以使用颜色资源,例如 android:drawable="@color/green"

该值始终以井号 (#) 字符开头,后跟以下某种格式的“透明度、红、绿、蓝”(Alpha-Red-Green-Blue) 信息:

  • #RGB
  • #ARGB
  • #RRGGBB
  • #AARRGGBB

注意:颜色是使用 name 属性中提供的值(而不是 XML 文件的名称)引用的简单资源。因此,您可以在一个 XML 文件中将颜色资源与其他简单资源合并到一个 <resources> 元素下。

文件位置:
res/values/colors.xml
文件名可以任意设置。<color> 元素的 name 用作资源 ID。
资源引用:
在 Java 中:R.color.color_name
在 XML 中:@[package:]color/color_name
语法:
<?xml version="1.0" encoding="utf-8"?>
<resources>
    <color
        name="color_name"
        >hex_color</color>
</resources>
元素:
<resources>
必需。这是根节点。

无属性。

<color>
以十六进制形式表示的颜色。

属性:

name
字符串。颜色的名称。此名称用作资源 ID。
示例:
保存在 res/values/colors.xml 的 XML 文件:
<?xml version="1.0" encoding="utf-8"?>
<resources>
   <color name="opaque_red">#f00</color>
   <color name="translucent_red">#80ff0000</color>
</resources>

以下应用代码会检索颜色资源:

Kotlin

val color: Int = resources.getColor(R.color.opaque_red)

Java

Resources res = getResources();
int color = res.getColor(R.color.opaque_red);

以下布局 XML 会将该颜色应用到属性:

<TextView
    android:layout_width="fill_parent"
    android:layout_height="wrap_content"
    android:textColor="@color/translucent_red"
    android:text="Hello"/>

尺寸

在 XML 中定义的尺寸值。尺寸由数字后跟度量单位来指定,例如 10px、2in 或 5sp。Android 支持以下度量单位:

dp
密度无关像素:基于屏幕物理密度的抽象单位。这些单位相对于 160 dpi(每英寸点数)屏幕确立,在该屏幕上 1 dp 大致等于 1 px。在更高密度的屏幕上运行时,用于绘制 1 dp 的像素数量会根据屏幕 dpi 按照适当的系数增加。

同样,在更低密度的屏幕上,用于绘制 1 dp 的像素数量会相应减少。dp 与像素的比率会随着屏幕密度的变化而变化,但不一定成正比。如要使布局中的视图尺寸根据不同的屏幕密度正确调整大小,一种解决办法就是使用 dp 单位(而不是 px 单位)。它可在不同设备上提供一致的界面元素大小。

sp
缩放无关像素 - 这和 dp 单位类似,但它也会根据用户的字体大小偏好设置进行缩放。建议您在指定字体大小时使用此单位,以便字体大小会根据屏幕密度和用户偏好设置进行调整。
pt
点:1/72 英寸,基于屏幕的物理尺寸,假设屏幕密度为 72 dpi。
px
像素:对应于屏幕上的实际像素数。我们建议不要使用此单位,因为不同设备的实际呈现效果可能不同。不同设备的每英寸像素数可能不同,而且屏幕上的总像素数也可能有差异。
mm
毫米:基于屏幕的物理尺寸。
in
英寸:基于屏幕的物理尺寸。

注意:尺寸是使用 name 属性中提供的值(而不是 XML 文件的名称)引用的简单资源。因此,您可以在一个 XML 文件中将尺寸资源与其他简单资源合并到一个 <resources> 元素下。

文件位置:
res/values/filename.xml
文件名可以任意设置。<dimen> 元素的 name 用作资源 ID。
资源引用:
在 Java 中:R.dimen.dimension_name
在 XML 中:@[package:]dimen/dimension_name
语法:
<?xml version="1.0" encoding="utf-8"?>
<resources>
    <dimen
        name="dimension_name"
        >dimension</dimen>
</resources>
元素:
<resources>
必需。这是根节点。

无属性。

<dimen>
定义一个尺寸,由浮点数后跟度量单位(dp、sp、pt、px、mm、in)表示。

属性:

name
字符串。尺寸的名称。此名称用作资源 ID。
示例:
保存在 res/values/dimens.xml 的 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>
</resources>

以下应用代码会检索尺寸:

Kotlin

val fontSize: Float = resources.getDimension(R.dimen.font_size)

Java

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

以下布局 XML 会将尺寸应用到属性:

<TextView
    android:layout_height="@dimen/textview_height"
    android:layout_width="@dimen/textview_width"
    android:textSize="@dimen/font_size"/>

ID

在 XML 中定义的唯一资源 ID。Android 开发者工具可使用您在 <item> 元素中提供的名称,在您项目的 R.java 类中创建唯一的整数,供您用作应用资源(例如,界面布局中的 View)的标识符,或创建唯一的整数,供您在应用代码中使用(例如,作为对话框的 ID 或结果代码)。

注意:ID 是使用 name 属性中提供的值(而不是 XML 文件的名称)引用的简单资源。因此,您可以在一个 XML 文件中将 ID 资源与其他简单资源合并到一个 <resources> 元素下。此外,ID 资源不会引用实际的资源项:它是一个唯一 ID,您可以将其附加到其他资源,或者在应用中作为唯一整数使用。

文件位置:
res/values/filename.xml
文件名可以任意设置。
资源引用:
在 Java 中:R.id.name
在 XML 中:@[package:]id/name
语法:
<?xml version="1.0" encoding="utf-8"?>
<resources>
    <item
        type="id"
        name="id_name" />
</resources>
元素:
<resources>
必需。这是根节点。

无属性。

<item>
定义唯一 ID。不设置值,只有属性。

属性:

type
必须为 "id"
name
字符串。ID 的唯一名称。
示例:

保存在 res/values/ids.xml 的 XML 文件:

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <item type="id" name="button_ok" />
    <item type="id" name="dialog_exit" />
</resources>

以下布局代码段会将 "button_ok" ID 用于 Button widget:

<Button android:id="@id/button_ok"
    style="@style/button_style" />

此处的 android:id 值不会在 ID 引用中包含加号,因为此 ID 已存在,如前面的 ids.xml 示例中所定义。如果使用加号以 android:id="@+id/name" 格式指定 XML 资源的 ID,则表示 "name" ID 尚不存在,系统会创建一个。

再比如,以下代码段使用 "dialog_exit" ID 作为对话框的唯一标识符:

Kotlin

showDialog(R.id.dialog_exit)

Java

showDialog(R.id.dialog_exit);

在同一应用中,在创建对话框时会比较 "dialog_exit" ID:

Kotlin

override fun onCreateDialog(id: Int): Dialog? {
    return when(id) {
        R.id.dialog_exit -> {
            ...
        }
        else -> {
            null
        }
    }
}

Java

protected Dialog onCreateDialog(int id) {
    Dialog dialog;
    switch(id) {
    case R.id.dialog_exit:
        ...
        break;
    default:
        dialog = null;
    }
    return dialog;
}

整数

在 XML 中定义的整数。

注意:整数是使用 name 属性中提供的值(而不是 XML 文件的名称)引用的简单资源。因此,您可以在一个 XML 文件中将整数资源与其他简单资源合并到一个 <resources> 元素下。

文件位置:
res/values/filename.xml
文件名可以任意设置。<integer> 元素的 name 用作资源 ID。
资源引用:
在 Java 中:R.integer.integer_name
在 XML 中:@[package:]integer/integer_name
语法:
<?xml version="1.0" encoding="utf-8"?>
<resources>
    <integer
        name="integer_name"
        >integer</integer>
</resources>
元素:
<resources>
必需。这是根节点。

无属性。

<integer>
一个整数。

属性:

name
字符串。该整数的名称。此名称用作资源 ID。
示例:

保存在 res/values/integers.xml 的 XML 文件:

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <integer name="max_speed">75</integer>
    <integer name="min_speed">5</integer>
</resources>

以下应用代码会检索整数:

Kotlin

val maxSpeed: Int = resources.getInteger(R.integer.max_speed)

Java

Resources res = getResources();
int maxSpeed = res.getInteger(R.integer.max_speed);

整数数组

在 XML 中定义的整数数组。

注意:整数数组是使用 name 属性中提供的值(而不是 XML 文件的名称)引用的简单资源。因此,您可以在一个 XML 文件中将整数数组资源与其他简单资源合并到一个 <resources> 元素下。

文件位置:
res/values/filename.xml
文件名可以任意设置。<integer-array> 元素的 name 用作资源 ID。
编译后的资源数据类型:
指向整数数组的资源指针。
资源引用:
在 Java 中:R.array.integer_array_name
在 XML 中:@[package:]array/integer_array_name
语法:
<?xml version="1.0" encoding="utf-8"?>
<resources>
    <integer-array
        name="integer_array_name">
        <item
            >integer</item>
    </integer-array>
</resources>
元素:
<resources>
必需。这是根节点。

无属性。

<integer-array>
定义一个整数数组。包含一个或多个 <item> 子元素。

属性:

android:name
字符串。数组的名称。此名称用作引用数组的资源 ID。
<item>
一个整数。该值可以是对另一个整数资源的引用。必须为 <integer-array> 元素的子项。

无属性。

示例:
保存在 res/values/integers.xml 的 XML 文件:
<?xml version="1.0" encoding="utf-8"?>
<resources>
    <integer-array name="bits">
        <item>4</item>
        <item>8</item>
        <item>16</item>
        <item>32</item>
    </integer-array>
</resources>

以下应用代码会检索整数数组:

Kotlin

val bits: IntArray = resources.getIntArray(R.array.bits)

Java

Resources res = getResources();
int[] bits = res.getIntArray(R.array.bits);

类型化数组

在 XML 中定义的 TypedArray。您可以使用这种资源创建其他资源(例如可绘制对象)的数组。此类数组不要求所含的资源具有相同的类型,因此您可以创建混合资源类型的数组,但必须知道数组中有哪些数据类型及其位置,以便可以使用 TypedArray 类的 get...() 方法正确获取每一项数据。

注意:类型化数组是使用 name 属性中提供的值(而不是 XML 文件的名称)引用的简单资源。因此,您可以在一个 XML 文件中将类型化数组资源与其他简单资源合并到一个 <resources> 元素下。

文件位置:
res/values/filename.xml
文件名可以任意设置。<array> 元素的 name 用作资源 ID。
编译后的资源数据类型:
指向 TypedArray 的资源指针。
资源引用:
在 Java 中:R.array.array_name
在 XML 中:@[package:]array/array_name
语法:
<?xml version="1.0" encoding="utf-8"?>
<resources>
    <array
        name="integer_array_name">
        <item>resource</item>
    </array>
</resources>
元素:
<resources>
必需。这是根节点。

无属性。

<array>
定义一个数组。包含一个或多个 <item> 子元素。

属性:

android:name
字符串。数组的名称。此名称用作引用数组的资源 ID。
<item>
通用资源。该值可以是对资源或简单数据类型的引用。必须为 <array> 元素的子项。

无属性。

示例:
保存在 res/values/arrays.xml 的 XML 文件:
<?xml version="1.0" encoding="utf-8"?>
<resources>
    <array name="icons">
        <item>@drawable/home</item>
        <item>@drawable/settings</item>
        <item>@drawable/logout</item>
    </array>
    <array name="colors">
        <item>#FFFF0000</item>
        <item>#FF00FF00</item>
        <item>#FF0000FF</item>
    </array>
</resources>

以下应用代码会检索每个数组,然后获取每个数组中的第一个条目:

Kotlin

val icons: TypedArray = resources.obtainTypedArray(R.array.icons)
val drawable: Drawable = icons.getDrawable(0)

val colors: TypedArray = resources.obtainTypedArray(R.array.colors)
val color: Int = colors.getColor(0,0)

Java

Resources res = getResources();
TypedArray icons = res.obtainTypedArray(R.array.icons);
Drawable drawable = icons.getDrawable(0);

TypedArray colors = res.obtainTypedArray(R.array.colors);
int color = colors.getColor(0,0);