Android Resource介绍和使用

1. 相关文件夹介绍

文件	取值方式
string.xml	getResource().getString(resourceId)或者getResource().getText(resourceId)
arrays.xml	getResource().getStringArray(resourceId)
colors.xml	getResource().getDarwable (resourceId)或者getResource().getColorourceId)
dimens.xml	getResource().getDimension(resourceId)
styles.xml	不需要取值

在Android项目文件夹里面，主要的资源文件是放在res文件夹里面的。assets文件夹是存放不进行编译加工的原生文件，即该文件夹里面的文件不会像xml，java文件被预编译，可以存放一些图片，html，js, css等文件。在后面会介绍如何读取assets文件夹的资源！

res文件夹里面的多个文件夹的各自介绍(来自网上的Android开发指南中文版内容)：

目录Directory	资源类型Resource Types
res/anim/	XML文件，它们被编译进逐帧动画（frame by frame animation）或补间动画(tweened animation)对象
res/drawable/	.png、.9.png、.jpg文件，它们被编译进以下的Drawable资源子类型中：要获得这种类型的一个资源，可以使用Resource.getDrawable(id) 位图文件 9-patches（可变尺寸的位图）为了获取资源类型，使用mContext.getResources().getDrawable(R.drawable.imageId) 注意：放在这里的图像资源可能会被aapt工具自动地进行无损压缩优化。比如，一个真彩色但并不需要256色的PNG可能会被转换为一个带调色板的8位PNG。这使得同等质量的图片占用更少的资源。所以我们得意识到这些放在该目录下的二进制图像在生成时可能会发生变化。如果你想读取一个图像位流并转换成一个位图(bitmap)，请把图像文件放在res/raw/目录下，这样可以避免被自动优化。
res/layout/	被编译为屏幕布局(或屏幕的一部分)的XML文件。参见布局声明(Declaring Layout)
res/values/	可以被编译成很多种类型的资源的XML文件。注意: 不像其他的res/文件夹，它可以保存任意数量的文件，这些文件保存了要创建资源的描述，而不是资源本身。XML元素类型控制这些资源应该放在R类的什么地方。尽管这个文件夹里的文件可以任意命名，不过下面使一些比较典型的文件（文件命名的惯例是将元素类型包含在该名称之中）： array.xml 定义数组 colors.xml 定义color drawable和颜色的字符串值(color string values)。使用Resource.getDrawable()和Resources.getColor()分别获得这些资源。 dimens.xml定义尺寸值(dimension value)。使用Resources.getDimension()获得这些资源。 strings.xml定义字符串(string)值。使用Resources.getString()或者Resources.getText()获取这些资源。getText()会保留在UI字符串上应用的丰富的文本样式。 styles.xml 定义样式(style)对象。
res/xml/	任意的XML文件，在运行时可以通过调用Resources.getXML()读取。
res/raw/	直接复制到设备中的任意文件。它们无需编译，添加到你的应用程序编译产生的压缩文件中。要使用这些资源，可以调用Resources.openRawResource()，参数是资源的ID，即R.raw.somefilename。

2.自动生成的R class

在项目文件夹的gen文件夹里面有个R.java，我们平常引用的资源主要引用这个类的变量。

注意：R类是自动生成的，并且它不能被手动修改。当资源发生变动时，它会自动修改。

3. 在代码中使用资源

下面是一个引用资源的语法：

R.resource_type.resource_name 或者 android.R.resource_type.resource_name

其中resource_type是R的子类，保存资源的一个特定类型。resource_name是在XML文件定义的资源的name属性，或者有其他文件类型为资源定义的文件名（不包含扩展名，这指的是drawable文件夹里面的icon.png类似的文件，name=icon）。 Android包含了很多标准资源，如屏幕样式和按钮背景。要在代码中引用这些资源，你必须使用android进行限定，如android.R.drawable.button_background。

下面是官方给出的一些在代码中使用已编译资源的正确和错误用法的例子：

// Load a background for the current screen from a drawable resource.
this.getWindow().setBackgroundDrawableResource(R.drawable.my_background_image);
// WRONG Sending a string resource reference into a
// method that expects a string.
this.getWindow().setTitle(R.string.main_title);
// RIGHT Need to get the title from the Resources wrapper.
this.getWindow().setTitle(Resources.getText(R.string.main_title));
// Load a custom layout for the current screen.
setContentView(R.layout.main_screen);
// Set a slide in animation for a ViewFlipper object.
mFlipper.setInAnimation(AnimationUtils.loadAnimation(this,
R.anim.hyperspace_in));
// Set the text on a TextView object.
TextView msgTextView = (TextView)findViewByID(R.id.msg);
msgTextView.setText(R.string.hello_message);

查了SDK Doc，才明白为什么window.setTitle要先Resources.getText，原来setTitle的参数是CharSequence，Resources.getText(int)返回的是CharSequence；而其他setText的参数有的是CharSequence，有的是int（这就是Resources变量值）。

同时官方还给了两个使用系统资源的例子：

//在屏幕上显示标准应用程序的图标
public class MyActivity extends Activity {
public void onStart() {
requestScreenFeatures(FEATURE_BADGE_IMAGE);
super.onStart();
setBadgeResource(android.R.drawable.sym_def_app_icon);
}
}
//应用系统定义的标准"绿色背景"视觉处理
public class MyActivity extends Activity
public void onStart() {
super.onStart();
setTheme(android.R.style.Theme_Black);
}
}

4. xml文件内引用资源

1) 引用自定义的资源

android:text="@string/hello"

这里使用"@"前缀引入对一个资源的引用--在@[package:]type/name形式中后面的文本是资源的名称。在这种情况下，我们不需要指定包名，因为我们引用的是我们自己包中的资源。type是xml子节点名，name是xml属性名：

<?xml version="1.0" encoding="utf-8"?>
<resources>
<string name="hello">Hello World, HelloDemo!</string>
</resources>

2) 引用系统资源

android:textColor="@android:color/opaque_red" 指定package: android

3) 引用主题属性

另外一种资源值允许你引用当前主题中的属性的值。这个属性值只能在样式资源和XML属性中使用；它允许你通过将它们改变为当前主题提供的标准变化来改变UI元素的外观，而不是提供具体的值。

android:textColor="?android:textDisabledColor"

注意，这和资源引用非常类似，除了我们使用一个"?"前缀代替了"@"。当你使用这个标记时，你就提供了属性资源的名称，它将会在主题中被查找--因为资源工具知道需要的属性资源，所以你不需要显示声明这个类型(如果声明，其形式就是?android:attr/android:textDisabledColor)。除了使用这个资源的标识符来查询主题中的值代替原始的资源，其命名语法和"@"形式一致：?[namespace:]type/name，这里类型可选。

5. 替换资源（为了可替换的资源和配置）

个人理解这个替换资源主要用于适应多种规格的屏幕，以及国际化。对于这部分的内容，请参考http://androidappdocs.appspot.com/guide/topics/resources/resources-i18n.html，以后再研究！

6. Color Value

语法：

<color name="color_name">#color_value</color>

可以保存在res/values/colors.xml (文件名可以任意)。

xml引用：android:textColor="@color/color_name"

Java引用： int color = Resources.getColor(R.color.color_name)

其中#color_value有以下格式（A代表Alpha通道）：

#RGB

#ARGB

#RRGGBB

#AARRGGBB

xml示例(声明两个颜色，第一个不透明，第二个透明色)：

<?xml version="1.0" encoding="utf-8"?>
<resources>
<color name="opaque_red">#f00</color>
<color name="translucent_red">#80ff0000</color>
</resources>

7.Color Drawables

语法：

<drawable name="color_name">color_value</drawable>

可以保存在res/values/colors.xml。

xml引用：android:background="@drawable/color_name"

java引用：Drawable redDrawable = Resources.getDrawable(R.drawable.color_name)

color_name和上面的一样。个人认为，一般情况下使用color属性，当需要用到paintDrawable时才使用drawable属性。

xml示例：

<?xml version="1.0" encoding="utf-8"?>
<resources>
<drawable name="opaque_red">#f00</drawable>
<drawable name="translucent_red">#80ff0000</drawable>
</resources>

8. 图片

一般放在res/drawable/里面。官方提示png (preferred), jpg (acceptable), gif (discouraged)，看来一般使用png格式比较好！

xml引用 @[package:]drawable/some_file

java引用 R.drawable.some_file 引用是不带扩展名

9. dimension

语法：

<dimen name="dimen_name">dimen_value单位</dimen>

一般保存为res/values/dimen.xml。

度量单位：

px(象素): 屏幕实际的象素，常说的分辨率1024*768pixels，就是横向1024px, 纵向768px，不同设备显示效果相同。

in(英寸): 屏幕的物理尺寸, 每英寸等于2.54厘米。

mm(毫米): 屏幕的物理尺寸。

pt(点) : 屏幕的物理尺寸。1/72英寸。

dp/dip : 与密度无关的象素，一种基于屏幕密度的抽象单位。在每英寸160点的显示器上，1dp = 1px。但dp和px的比例会随着屏幕密度的变化而改变，不同设备有不同的显示效果。设置宽度或者高度等属性时，推荐使用dp(dip)作为单位

sp : 与刻度无关的象素，主要用于字体显示best for textsize，作为和文字相关大小单位。

XML: android:textSize="@dimen/some_name"
Java: float dimen = Resources.getDimen(R.dimen.some_name)

xml示例：

<?xml version="1.0" encoding="utf-8"?>
<resources>
<dimen name="one_pixel">1px</dimen>
<dimen name="double_density">2dp</dimen>
<dimen name="sixteen_sp">16sp</dimen>
</resources>

10. string

下面是官方给出的正确/错误的例子:

//不使用转义符则需要用双引号包住整个string
<string name="good_example">"This'll work"</string>
//使用转义符
<string name="good_example_2">This\'ll also work</string>
//错误
<string name="bad_example">This won't work!</string>
//错误不可使用html转义字符
<string name="bad_example_2">XML encodings won't work either!</string>

对于带格式的string，例如在字符串中某些文字设置颜色，可以使用html标签。对于这类型的string，需要进行某些处理，在xml里面不可以被其他资源引用。官方给了一个例子来对比普通string和带格式string的使用：

<?xml version="1.0" encoding="utf-8"?>
<resources>
<string name="simple_welcome_message">Welcome!</string>
<string name="styled_welcome_message">We are so glad to see you.</string>
</resources>

Xml代码

<TextView
android:layout_width="fill_parent"
android:layout_height="wrap_content"
android:textAlign="center"
android:text="@string/simple_welcome_message"/>

Java代码

// Assign a styled string resource to a TextView on the current screen.
CharSequence str = getString(R.string.styled_welcome_message);
TextView tv = (TextView)findViewByID(R.id.text);
tv.setText(str);

另外对于带风格/格式的string的处理，就麻烦一点点。官方给了一个例子：

<?xml version="1.0" encoding="utf-8"?>
<resources>
<string name="search_results_resultsTextFormat">%1$d results for &quot;%2$s&quot;</string>
</resources>

这里的%1$d是个十进制数字，%2$s是字符串。当我们把某个字符串赋值给%2$s之前，需要用htmlEncode(String)函数处理那个字符串：

//title是我们想赋值给%2$s的字符串
String escapedTitle = TextUtil.htmlEncode(title);

然后用String.format() 来实现赋值，接着用fromHtml(String) 得到格式化后的string：

String resultsTextFormat = getContext().getResources().getString(R.string.search_results_resultsTextFormat);
String resultsText = String.format(resultsTextFormat, count, escapedTitle);
CharSequence styledResults = Html.fromHtml(resultsText);

11. assets文件夹资源的访问

assets文件夹里面的文件都是保持原始的文件格式，需要用AssetManager以字节流的形式读取文件。

1. 先在Activity里面调用getAssets()来获取AssetManager引用。

2. 再用AssetManager的open(String fileName, int accessMode)方法则指定读取的文件以及访问模式就能得到输入流InputStream。

3. 然后就是用已经open file 的inputStream读取文件，读取完成后记得inputStream.close()。

4.调用AssetManager.close()关闭AssetManager。

至于style and theme，Layout，动画Animation，Menu则查看本博客的其他文章。附上官方的相应介绍网址http://androidappdocs.appspot.com/guide/topics/resources/available-resources.html

android的资源是您在代码中使用到的并且在编译时被打包进您的应用程序的附加文件。Android支持多种不同的文件，包括XML、PNG和JPEG文件。XML文件的格式决定于其描述的内容。这些文件将描述文件支持的类型、语法或格式。处于加载效率的考虑，资源被从代码中分离出来，而且XML文件被编译进二进制代码中。字符串，类似的会被压缩存储为更经济的格式。处于这样或那样的原因，Android平台中会存在很多不同的资源和资源定义文件。
Android资源系统保存所有与代码无关资源的存根。您可以使用Resources类访问您应用程序的资源；
与应用程序相关联的资源实例可以通过Context.getResources()得到。
一、创建资源
Android支持字符串，位图和许多其他类型的资源。每一种资源定义文件的语法和格式及保存的位置取决于其依赖的对象。
    通常，您可以通过三种文件创建资源：XML文件（除位图和原生文件外），位图文件（作为图片）和原生文件（所有其他的类型，比如声音文件）。
    事实上，这里有两种不同类型的XML文件，一种是作为资源被编译进应用程序，另一种是关于资源的描述，被aapt使用。
    您可以在您项目res/目录下的适当子目录下创建和存储资源文件。Android使用资源编译器访问资源所在的子目录和格式化的文件。
    下面的表格列出了每一种资源的文件类型
    res/anim目录
        XML文件编译为桢序列动画或者自动动画对象。
    res/drawable目录
        .png，9.png，.jpg文件被编译为Drawable资源子类型：
        使用Resources.getDrawable(id)可以获得资源类型
* 位图文件：png,jpg等普通图片文件
* 9-patchs（可变位图文件）：9.png文件
   *selector
    它主要定义控件在下pressed，selected，focused及平常情况下的属性
     更详细参见《selector的使用》
    res/layout目录
        资源编译为屏幕布局器.
    res/values目录
        XML 文件可以被编译为多种资源
        注意：不像其他res下的目录，这个目录可以包含多个资源描述文件。XML文件元素类型控制着这些资源被R类放置在何处。
        这些文件可以自定义名称。这里有一些约定俗成的文件。
        * arrays.xml 定义数组。
            参见附示例1
        * colors.xml 定义可绘制对象的颜色和字符串的颜色。使用Resources.getDrawable()和Resources.getColor()都可以获得这些资源。
            参见附示例2
        * dimens.xml 定义尺度。使用Resources.getDimension()可以获得这些资源
            参见附示例3
        * strings.xml 定义字符串（使用Resources.getString()或者更适合的Resources.getText()方法获得这些资源。
        Resources.getText()方法将保留所有用于描述用户界面样式的描述符，保持复杂文本的原貌。
            参见附示例4
        * styles.xml 定义样式对象。
            styles就是属性集合。
            更详细参见《styles的使用》
        *attrs.xml 定义控件对象的属性。
         更详细参见《自定义控件属性(attr.xml,TypedArray)》
        *themes.xml
   详细参见《风格和主题(style,themes)》
    res/xml目录
        自定义的XML文件。这些文件将在运行时编译近应用程序，并且使用Resources.getXML()方法可以在运行时获取。
    res/raw
        自定义的原生资源，将被直接拷贝入设备。这些文件将不被压缩近您的应用程序。
        使用带有ID参数的Resources.getRawResource()方法可以获得这些资源，比如R.raw.somefilename。

    资源被最终编译进APK文件。Android创建包装类R，您可以用他找回资源。R包含一些与资源所在目录同名的子类

很多资源都允许您定义颜色。Android接受web风格的颜色定义-一组十六进制的颜色值，按照以下序列排列：#RGB，#ARGB，#RRGGBB，#AARRGGBB。
 *所有的颜色都支持ALPHA通道，头两位十六进制数字指定透明度。0在ALPHA通道中表示全透明，默认值是不透明。
 在编译时，Android生成名为R的类。R包含您应用程序所用到的所有资源的索引。这个类包含一些与res下子目录同名的子类。
这些子类包含每一个您在资源文件中定义的资源的标识。这些资源标识可以在您的代码中引用。
 注意：R类是自动生成的，并且它不能被手动修改。当资源发生变动时，它会自动修改。
以下是一个生成的R类的示例：
 package com.android.samples;
 public final class R {
 public static final class string {
 public static final int greeting=0x0204000e;
 public static final int start_button_text=0x02040001;
 public static final int submit_button_text=0x02040008;
 public static final int main_screen_title=0x0204000a;
 };
 public static final class layout {
 public static final int start_screen=0x02070000;
 public static final int new_user_pane=0x02070001;
 public static final int select_user_list=0x02070002;

 };
 public static final class drawable {
 public static final int company_logo=0x02020005;
 public static final int smiling_cat=0x02020006;
 public static final int yellow_fade_background=0x02020007;
 public static final int stretch_button_1=0x02020008;

 };
 };

二、在代码中使用资源
 在代码中使用资源需要知道完整的资源ID和您的资源对象类型。下面是资源引用语法：
 R.resource_type.resource_name (引用当前应用程序的资源）或者 android.R.resource_type.resource_name（引用android系统的资源）
 resource_type是R类中保存制定类型资源的子类。resource_name是定义在XML文件中的资源名或者被其他文件类型所定义的资源文件名（无扩展名）每一类型的资源都依据其类型，被添加入某一指定的R子类；
 引用当前应用程序可以不带包名（比如R.resource_type.resource_name）。
 Android包含一个标准资源的序号，比如屏幕的样式和按钮的背景。引用这些资源，您必须使用带android的语法，比如android.R.drawable.button_background。
 示例1：
 // Load a background for the current screen from a drawable resource.
 this.getWindow().setBackgroundDrawableResource(R.drawable.my_background_image);

 // WRONG Sending a string resource reference into a
 // method that expects a string.
 this.getWindow().setTitle(R.string.main_title);

 // RIGHT Need to get the title from the Resources wrapper.取字符串
 this.getWindow().setTitle(Resources.getText(R.string.main_title));

 // Load a custom layout for the current screen.
 setContentView(R.layout.main_screen);

 // Set a slide in animation for a ViewFlipper object.
 mFlipper.setInAnimation(AnimationUtils.loadAnimation(this,

 R.anim.hyperspace_in));

 // Set the text on a TextView object.
 TextView msgTextView = (TextView)findViewByID(R.id.msg);
 msgTextView.setText(R.string.hello_message);
三、引用资源
 一个属性值（或资源）同样可以引用资源。这种用法常在资源布局器文件中用于文字和图片（定义在其他文件中）。
 这种方法可以引用任何资源，包括颜色和整数。
 比如，如果我们有一个颜色资源，我们可以写一个布局器文件，在其中指定文本颜色和尺寸。
 示例2：
 <?xml version="1.0" encoding="utf-8"?>
 <EditText id="text"
 xmlns:android="http://schemas.android.com/apk/res/android"
 android:layout_width="fill_parent" android:layout_height="fill_parent"
 android:textColor="@color/opaque_red"
 android:text="Hello, World!" />
 注意：“@”前缀声明这是一个资源引用—随后的文本是以@[package:]type/name形式提供的资源名。在这个例子中我们不需要指明特定的包，因为我们在我们自己的包中引用。
四、引用系统资源
 引用一个系统资源时，就是@android:type/name的形式。比如示例3.
 示例3:
 <?xml version="1.0" encoding="utf-8"?>
 <EditText id="text"
 xmlns:android="http://schemas.android.com/apk/res/android"
 android:layout_width="fill_parent" android:layout_height="fill_parent"
 android:textColor="@android:color/opaque_red"
 android:text="Hello, World!" />
五、使用系统资源
 许多包含于系统之中的资源是能被应用程序所访问的。所有的资源被定义在android.R类中。
 比如，您可以使用一下代码在屏幕上显示标准应用程序的ICON
 示例5:
 public class MyActivity extends Activity
 {
 public void onStart()
 {
 requestScreenFeatures(FEATURE_BADGE_IMAGE);

 super.onStart();

 setBadgeResource(android.R.drawable.sym_def_app_icon);
 }
 }
 类似的，下面的代码会更改您的系统主题
 示例6:
 public class MyActivity extends Activity
 {
 public void onStart()
 {
 super.onStart();

 setTheme(android.R.style.Theme_Black);
 }
 }

六、附件
附示例1:
 arrays.xml
 <?xml version="1.0" encoding="utf-8"?>
 <resources>
 <string-array name="twarr_indexlist">
 
 
 <item>A</item>
 <item>B</item>
 <item>C</item>
 </string-array>
 <string-array name="arr_indexlist_clock">
 <item>+13</item>
 <item>+12</item>
 <item>+11</item>
 </string-array>
 </resources>
附示例2:
 colors.xml
 <?xml version="1.0" encoding="utf-8"?>
 <resources>
 <color name="transparent_color">#00000000</color>
 </resources>
附示例3:
 dimens.xml
 <?xml version="1.0" encoding="utf-8"?>
 <resources>
 <dimen name="test_textsize_default">28sp</dimen>
 <dimen name="test_itemheight_default">63dp</dimen>
 </resources>
附示例4:
 strings.xml
 <?xml