resources的使用

在很多时候，我们需要访问android中的资源文件，这些资源文件主要分为两类，一种出于asset目录下，称为原生文件，这类文件在被打包成apk文件时是不会进行压缩的；另一类则是res下的文件，这类文件在打包成apk文件时，会进行小内存优化的哦。

 

      两种不同类型的文件，对应着不同的访问模式。我们先来看看asset文件的访问：

     android中有一个专门的类来处理应用对asset文件的访问，这个类就是AssetManager。其内有一个open()方法可以根据用户提供的文件名，返回一个InputStream对象供用户使用。

我们截图看下api中的方法：

这里我们可以看到open方法以及其他的相应方法，对于其中有一个参数accessMode，则指定了系统获取资源的模式。主要值有以下几种：

 

ACCESS_BUFFER ：加载文件到内存中，这种方式适合小文件的读取；

ACCESS_RANDOM:可以随意的向前或者向后的读取数据块

ACCESS_STRAMING:顺序的读取内容

ACCESS_UNKNOWN:当没有明确指定时，使用默认模式

这里我们一定要注意，open(String fileName)默认的使用ACCESS_STREAMING模式进行读取！！

那么我们如何获得一个AssetManager对象呢，在activity中我们可以通过以下的代码获取：

AssetManager assetManager = this.getResources().getAsset();

-----------------------------------------------------------------------------------

如何访问res目录下的文件呢？

我们再activity中可以通过如下方法进行访问，InputStream inputStream = Resources.openRawResource(int id);

api中是这样描述的：

最后，我们一定要注意，asset和res下的文件都是只能读不能写的哦。

android里的资源可以是一个文件(mp3,视频、音频)或者是一个值(一个对话框中的一个标题)，这些值被绑定到一个可执行的应用程序。 

这些文件和值被绑定到应用程序，你可以修改它们，但是不需要重新编译和重新部署应用程序。 

android是一个平台，一个框架，这个框架包含许多资源，string、color、bitmap、style等。android的AAPT会自动为这些文件建立一个ID,在程序中就可以以使用这些ID来引用这些resources，如果你想改某个值，只需要修改这些resource而不需要修改源代码。 


resources的使用  
resoureces就是res目录下的那些目录和文件，常用的有： 

res/drawable/ 用来存放图片文件 
res/layout/ 用来存放布局定义文件 
res/values/ 用来存放一些变量、参数等文件 

android允许你定义多个string xml文件 这些resource位于/res/value目录下，文件名是任意的 
这是一个普通的字符串资源文件 

Xml代码  

1. <?xml version="1.0" encoding="utf-8"?>  
2. <resources>  
3.     <string name="hello">Hello World, SendMessage!</string>  
4.     <string name="app_name">SMS</string>  
5. </resources>  

当这个文件被创建或修改了，eclipse的adt插件会自动更新你源代码中一个叫R.java的文件 
R.java 
在R.java的注释部分， 有这样一段话：“AUTO-GENERATE FILE. DO NOT MODIFY”，这个文件是自动生成的，不要修改。 
这个文件是在程序编译过程中由aapt(Android Asset Packaging Tool) 自动生成 
这个文件中的属性都是public static final的，所以可以直接在Java代码中引用，每个属性都代表一个资源，看起来就像为每个资源都定义了一个ID，然后通过这个ID来访问资源 
所有的资源文件都被编译进最后生成的二进制包中，这样能够带来很高的性能和效率 

string的定义非常简单 

Xml代码  

1. <string name="key">value</string>  

value可以只普通的字符串也可以是html代码，或者是包含单引号，双引号的字符串 

Xml代码  

1. <string name="quoted_string">"quoted'string"</string>  
2.    <string name="double_quoted_string">\"double quotes\"</string>  
3.    <string name="target_string">hello <b><i>android</i></b>,you are very younger!</string>  

在其他的android xml文件中引用含有html标记的值和引用普通的string一样 

Xml代码  

1. <TextView  android:text="@string/target_string"  
2.     android:id="@+id/text3"   
3.     android:layout_width="wrap_content"   
4.     android:layout_height="wrap_content"></TextView>  

在java程序中应用这些值可以这样 

Java代码  

1. this.getResources().getString(R.string.target_string);  

dimension resources 

android中定义的dimension单位有以下这些 
  px: pixel(像素) 
  in:inches(英寸) 
  mm:millimeter(毫米) 
  pt:point(点) 
  dp:density密度 
  sp:刻度 
定义dimension可定义string一样 

Xml代码  

1. <resources>  
2.   <dimen name="mysize_in_pixels">1px</dimen>  
3.   <dimen name="mysize_in_dp">1dp</dimen>  
4.   <dimen name="medium_size">100sp</dimen>  
5.   
6. </resources>  

你可以在style中或者定位android UI 中使用这些dimension资源 

如果在java中需要使用这些dimensions可以调用getResources方法 

Java代码  

1. this.getResources().getDimension(R.dimen.mysize_in_pixels);  

在ml文件中使用dimension 

Xml代码  

1. <TextView  android:text="@string/target_string"  
2.     android:id="@+id/text3"   
3.     android:layout_width="wrap_content"   
4.     android:textSize="@dimen/medium_size"   android:layout_height="wrap_content"></TextView>  

Image resource  

android会为每个放置在res/drawable目录下的图片文件生成ID，ID就是这个图片的文件名，如果一个图片的名是sample.gif那么就会在R.java文件中的drawable下生成 

Java代码  

1. public static final int sample=0x7f020001;  

android支持的图片格式有：gif,jpg,png 

在xml文件中使用image resource 

Xml代码  

1.       
2. <Button android:text="Button01"   
3.     android:id="@+id/Button01"   
4.     android:layout_width="wrap_content"   
5.     android:background="@drawable/sample"  
6.     android:layout_height="wrap_content"></Button>  

在java文件中通过调用getResources的getDrawable方法 

Java代码  

1. Drawable bitmap = this.getResources().getDrawable(R.drawable.sampe);  
2.         Button button = (Button)findViewById(R.id.Button01);  
3.        //给button设置一个背景图  
4.         button.setBackgroundDrawable(bitmap);  

在android中image是drawable资源的一种类型，android还支持其他的drawable 
它叫color-drawable,它本质上是一个彩色矩形 

它的定义如下 

Xml代码  

1. <resources>  
2.     <drawable name="red_rectangle">#f00</drawable>  
3.     <drawable name="blue_rectangle">#0000ff</drawable>  
4.     <drawable name="green_rectangle">#f0f0</drawable>  
5. </resources>  

Java中使用color-drawable 

Java代码  

1. // 取得drawable  
2. ColorDrawble redDrawable =   
3. (ColorDrawable)getResources().getDrawable(R.drawable.red_rectnagle);  
4. //设置textView的背景  
5. textView.setBackground(redDrawable);  

xml中使用color-drawable 

Xml代码  

1. <TextView android:layout_width="fill_parent"  
2.           android:layout_height="wrap_content"  
3.           android:textAlign="center"  
4.           android:background="@drawable/red_rectangle"/>  

 1. 相关文件夹介绍

     在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的比例会随着屏幕密度的变化而改变，不同设备有不同的显示效果。

 

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&apos;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 <b><i>so</i></b> 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 &lt;b>&amp;quot;%2$s&amp;quot;&lt;/b></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

    另外，官方还介绍了icon design的Guidelines http://androidappdocs.appspot.com/guide/practices/ui_guidelines/icon_design.html