Android資源文件說明

一. Android資源文件簡介

 

 

1. Android應用資源的作用

 

(1) Android項目中文件分類

 

在Android工程中, 文件主要分為下面幾類 : 界面布局文件, Java src源文件, 資源文件;

-- 界面布局文件 : 在res/layout目錄下定義, 用於定義Android中界面的顯示樣式;

-- Java源碼文件 : Android程序的邏輯實現, 程序主體;

-- 資源文件 : 各種XML文件, 可以定義圖片等資源, 以及各種圖片, 音頻, 視頻, 3d模型等資源;

 

(2) 資源文件作用

 

魔法數值 : 在程序開發過程成, 需要用到很多常數, 如果在程序中直接使用這些數字, 給源碼閱讀和維護帶來很多麻煩, 在重構領域我們將這些數值成為 Magical Number;

 

改進魔法數值 : 為了改進魔法數值分散在程序各個地方, 可以專門定義存儲魔法數值的接口, 在這些接口中以常量的形式定義一系列的魔法數值, 這些常量名稱都是容易理解的, 如果邏輯復雜的數值可以使用注釋進行解析, 這樣能大大 提高程序的 可讀性 和 可維護性;

 

使用資源存放字符串,數字常量 : Android中可以將 字符串 數值 存放到資源文件中, res 目錄中可以定義 字符串資源(values/string.xml),顏色資源, 數組資源, 菜單資源等, 在Java代碼中可以直接獲取這些資源中的值;

 

2. Android中資源分類詳解

 

(1)Android資源分類

 

Android中的資源分為兩大類 : 可直接訪問的資源, 無法直接訪問的原生資源;

-- 直接訪問資源 : 這些資源可以使用 R. 進行訪問, 都保存在res目錄下, 在編譯的時候, 會自動生成R.java 資源索引文件;

-- 原生資源 : 這些資源存放在assets下, 不能使用 R類 進行訪問, 只能通過 AssetManager 以二進制流形式讀取資源;

(2) Android資源詳解

 

res目錄下資源詳解 : 

-- res/animator : 屬性動畫的XML文件目錄, 屬性動畫就是定義起始結束, 動做, 重復時間等參數齊全的動畫;

-- res/anim : 補間動畫的XML文件目錄, 補間動畫是只定義 起始 結束幀, 中間的動作由系統進行計算獲取動作過程;

-- res/color : 顏色列表的XML文件目錄;

-- res/drawable : 存放真實的位圖文件, 也可以存放Drawable對象及子類對象的XML文件;

-- res/layout : 界面布局文件目錄;

-- res/menu : 程序中使用的菜單文件目錄, 該文件下的XML文件可以應用與 選項菜單, 子菜單, 上下文菜單等;

-- res/raw : 存放原生資源, 與assets目錄作用相同, 可以通過調用openRawResource(int)方法獲取二進制輸入流, 與asstes相似, 使用AssetsManager訪問這些資源;

-- res/value : 存放 字符串. 整數, 顏色, 數組 信息的 XML文件的目錄, 這些XML文件資源的根元素是resource;

-- res/xml : 原生的XML文件, 可以使用 Resource.getXML()方法進行訪問;

 

res/value目錄XML文件<resource>子標簽解析 : 

-- string標簽 : 代表一個字符串;

-- integer標簽 : 代表一個整數值標簽;

-- bool標簽 : 代表一個boolean值;

-- color標簽 : 代表一個顏色值;

-- array標簽 : 代表數組;

-- string-array標簽 : 代表字符串數組;

-- int-array標簽 : 代表int數組;

-- style標簽 : 代表樣式;

-- dimen標簽 : 代表一個尺寸;

 

分類資源文件 : 如果將所有的資源放到一個XML文件中, 會增加維護難度, 這里將不通類型的資源放到不同的XML文件下;

-- arrays.xml : 存放數組資源;

-- colors.xml : 存放顏色資源;

-- dimens.xml : 存放尺寸值資源;

-- strings.xml : 存放字符串資源;

-- styles.xml : 存放樣式資源;

 

3. Android中資源的使用

 

(1) Java代碼訪問清單資源

 

在Java代碼中通過R類獲取資源語法 : 

  

[packageName.] R . resourceType . resourceName

-- pakegeName : R類所在的包名, 即權限定類型, R類可能來自兩個包, 一個是程序本身的清單文件, 一個是Android系統存在的清單文件;

-- resourceType : R類中代表的資源類型的名稱, R.string 字符串資源, R.integer 代表整數資源;

-- resourceName : 資源名稱, 這個資源名稱是對應類型子標簽的 name屬性的值;

 

(2) Java代碼訪問原生資源

 

Resource類 : Android資源訪問控制類, 該類提供了大量方法獲取實際資源, Resource通過 Context.getResource()方法獲得;

-- 獲取清單資源 : resource.getString(id), 根據id獲取實際資源;

-- 獲取原生資源 : resource.getassets(), 獲取AssetManager對象;

//獲取Resource資源, 這個方法在Activity中執行  
Resources resources = getResources();  
//獲取字符串資源  
String hello = resources.getString(R.string.hello_world);  
//獲取圖片資源  
Drawable luncher = resources.getDrawable(R.drawable.ic_launcher);  

 

(3) XML文件中使用資源

 

在XML文件中需要引用其它XML文件中的值, 語法格式為 : 

@ [packageName : ] resourceType / resourceName 

-- packageName : 資源類型所在的包, 如果被引用資源 與 本XML文件在同一個包下, 可以省略包名;

-- resourceType : 資源類型, 例如 layout, drawable, strings等;

-- resourceName : 資源名稱, 資源所在的XML文件中元素的 android:name 屬性, 或者 是無后綴的文件名, 例如圖片, 布局文件等;

 

示例 : 

-- 源文件 : 

<?xml version="1.0" encoding="utf-8"?>  
<resources>  
  
    <string name="app_name">ResourceTest</string>  
    <string name="action_settings">Settings</string>  
    <string name="hello_world">Hello world!</string>  
    <color name="red">#FF4000</color>  
  
</resources>  

-- 引用文件 :

<TextView  
        android:layout_width="wrap_content"  
        android:layout_height="wrap_content"  
        android:text="@string/hello_world"   
        android:textColor="@color/red"/>  

 

 

二. Android 字符串 顏色 尺寸資源

 

1. 字符串 顏色 尺寸資源文件簡介

 

(1) 幾種資源的目錄引用名稱

 

字符串資源 : 

-- 默認目錄 : /res/values/strings.xml ;

-- 引用方式 : R.string.xxx ;

 

顏色資源 : 

-- 默認目錄 : /res/values/colors.xml ;

-- 引用方式 : R.color.xxx ;

 

尺寸資源 : 

-- 默認目錄 : /res/values/dimens.xml ;

-- 引用方式 : R.dimens.xxx ;

 

(2) 顏色定義方式

 

三原色 : 白光 可以分解為 紅, 綠, 藍 三種顏色的光, 紅綠藍都是最大值的時候就是白色, 三種值相等, 但不是最大值是灰色, 如果其中一種或兩種值比較大, 就會產生各種顏色的彩色;

 

顏色表示 : 顏色通過 紅(red) 綠(green) 藍(blue) 三種顏色, 以及 透明度(alpha) 來表示的;

-- 顏色開頭 : 顏色值總是以 # 開頭;

-- 無透明度 : 如果沒有 alpha 值, 默認完全不透明;

 

顏色定義形式 : 

-- #RGB : 紅 綠 藍 三原色值, 每個值分16個等級, 最小為0, 最大為f;

-- #ARGB : 透明度 紅 綠 藍 值, 每個值分16個等級, 最小為0, 最大為f;

-- #RRGGBB : 紅 綠 藍 三原色值, 每個值分 256個等級, 最小為0, 最大為ff;

-- #AARRGGBB : 透明度 紅 綠 藍 值, 每個值分 256個等級, 最小為0, 最大為ff;

 

 

 

 

2. 字符串 顏色 尺寸 XML文件定義

 

(1) 字符串資源文件

 

字符串資源文件信息 : 

-- 資源位置 : /res/values 目錄下; 

-- 根元素 :  <resource>是根元素;

-- 子元素 : <string />;

-- name屬性 : 指定變量名稱; 

-- 標簽文本 : 標簽文本就是字符串信息;

 

示例 :  

<?xml version="1.0" encoding="utf-8"?>  
<resources>  
    <string name="app_name">ResourceTest</string>  
    <string name="action_settings">Settings</string>  
    <string name="hello_world">Hello world!</string>  
</resources>  

 

(2) 顏色資源文件

 

顏色資源文件信息 : 

-- 位置 : /res/values目錄;

-- 根元素 : <resource>;

-- 子元素 : <color>;

-- name屬性 : 顏色資源名稱;

-- 標簽文本 : 顏色值;

 

示例 :  

<?xml version="1.0" encoding="utf-8"?>  
<resources>  
    <color name = "red">#FF4000</color>  
    <color name = "black">#120A2A</color>  
    <color name = "green">#00FF00</color>  
    <color name = "yellow">#FFFF00</color>  
</resources>  

 

(3) 尺寸資源文件

 

尺寸資源信息 : 

-- 位置 : /res/values目錄;

-- 根元素 : <resource>;

-- 子元素 : <dimen>;

-- name屬性 : 尺寸名稱;

-- 標簽文本 : 尺寸值;

 

示例 :  

<resources>  
    <!-- Default screen margins, per the Android Design guidelines. -->  
    <dimen name="activity_horizontal_margin">16dp</dimen>  
    <dimen name="activity_vertical_margin">16dp</dimen>  
</resources>  

3. 使用字符串 顏色 尺寸資源

 

(1) 使用示例

 

顏色資源 :  

<?xml version="1.0" encoding="utf-8"?>  
<resources>  
    <color name = "red">#FF4000</color>  
    <color name = "black">#120A2A</color>  
    <color name = "green">#00FF00</color>  
    <color name = "yellow">#FFFF00</color>  
</resources>  

尺寸資源 : 

 

<resources>  
    <!-- Default screen margins, per the Android Design guidelines. -->  
    <dimen name="activity_horizontal_margin">16dp</dimen>  
    <dimen name="activity_vertical_margin">16dp</dimen>  
</resources>

字符串資源 : 

  

<?xml version="1.0" encoding="utf-8"?>  
<resources>  
    <string name="app_name">ResourceTest</string>  
    <string name="action_settings">Settings</string>  
    <string name="hello_world">Hello world!</string>  
</resources>  

 

布局文件 : 在這個文件中調用上面三個資源文件內容;

<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"  
    xmlns:tools="http://schemas.android.com/tools"  
    android:layout_width="match_parent"  
    android:layout_height="match_parent"  
    android:paddingBottom="@dimen/activity_vertical_margin"  
    android:paddingLeft="@dimen/activity_horizontal_margin"  
    android:paddingRight="@dimen/activity_horizontal_margin"  
    android:paddingTop="@dimen/activity_vertical_margin"  
    tools:context=".MainActivity" >  
  
    <TextView   
        android:layout_width="wrap_content"  
        android:layout_height="wrap_content"  
        android:text="@string/hello_world"  
        android:textColor="@color/green" />  
  
</RelativeLayout>  

 

效果圖 : 

 

三. 整數 布爾值 資源文件

 

1. 整數資源

 

整型資源 : 

-- XML文件常用路徑 : /res/values/integer.xml;

-- 根標簽 : <resource> ;

-- 子元素 : <integer> ;

整型資源調用 : 

-- XML中調用 : @ [packageName] : integer / integerName ;

-- Java中調用 : [packageName . ]R.integer.integerName ;

 

示例 : /res/values/integer.xml ;

<?xml version="1.0" encoding="utf-8"?>  
<resources>  
    <integer name = "size_1">10</integer>  
    <integer name = "size_2">20</integer>  
</resources>  

Java代碼 : 

  

package shuliang.han.resourcetest;  
  
import android.app.Activity;  
import android.content.res.Resources;  
import android.os.Bundle;  
  
public class MainActivity extends Activity {  
  
    @Override  
    protected void onCreate(Bundle savedInstanceState) {  
        super.onCreate(savedInstanceState);  
        setContentView(R.layout.activity_main);  
          
        //獲取Resource資源, 這個方法在Activity中執行  
        Resources resources = getResources();  
        int size_1 = resources.getInteger(R.integer.size_1);  
        System.out.println(size_1);  
    }  
}  

 

2. 布爾資源

 

布爾資源信息 : 

-- 常用文件 : /res/values/bool.xml 文件;

-- 跟標簽 : <resource>;

-- 子標簽 : <bool> ;

 

布爾資源調用 : 

-- XML文件中調用 :  @ [packageName :] bool / boolName ;

-- Java代碼中調用 : [packageName . ]R.bool.boolName ;

 

示例 : 

<?xml version="1.0" encoding="utf-8"?>  
<resources>  
    <bool name = "is_true">true</bool>  
    <bool name = "is_false">false</bool>  
</resources> 

Java代碼 : 

 

package shuliang.han.resourcetest;  
  
import android.app.Activity;  
import android.content.res.Resources;  
import android.os.Bundle;  
  
public class MainActivity extends Activity {  
  
    @Override  
    protected void onCreate(Bundle savedInstanceState) {  
        super.onCreate(savedInstanceState);  
        setContentView(R.layout.activity_main);  
          
        //獲取Resource資源, 這個方法在Activity中執行  
        Resources resources = getResources();  
        boolean is_true = resources.getBoolean(R.bool.is_true);  
        System.out.println(is_true);  
    }  
}  

 

四. 數組資源

 

 

1. 數組資源簡介

 

資源數組文件 : 通常將數組定義在 /res/values/arrays.xml文件中;

-- 根標簽 : <resources> ;

-- 子標簽 : <array>, <string-array>, <integer-array>; 

 

資源數組類型 :  數組的資源的跟標簽都是 <resources>, 不同類型的數組的子元素不同;

-- 普通類型數組 : 使用<array>作為子元素標簽;

-- 字符串數組 : 使用<string-array>作為子元素標簽;

-- 整數數組 : 使用<integer-array>作為子元素標簽;

 

XML文件中調用數組資源 : @ [packageName :] array/arrayName ;

 

Java文件中調用數組資源 : [packageName . ]R.array.arrayName ;

-- 獲取實際普通數組 : TypeArray obtainTypedArray(int id), 根據普通數組資源名稱獲取實際普通數組, TypeArray類提供了getXxx(int index)方法獲取指定索引的元素;

-- 獲取字符串數組 : String[] getStringArray(int id), 根據字符串數組資源名稱獲取字符串數組;

-- 獲取整數數組 : int[] getIntArray(int id), 根據整數數組資源名稱獲取實際的整數數組;

2. 實際案例

 

數組資源文件 : 

<?xml version="1.0" encoding="utf-8"?>  
<resources>  
    <array name = "color_array">  
        <item>@color/black</item>  
        <item>@color/green</item>  
        <item>@color/red</item>  
        <item>@color/yellow</item>  
    </array>  
      
    <string-array name = "string_array">  
        <item>三星</item>  
        <item>小米</item>  
        <item>蘋果</item>  
    </string-array>  
      
    <integer-array name = "integer_array">  
        <item>1</item>  
        <item>2</item>  
        <item>3</item>  
        <item>4</item>  
    </integer-array>  
</resources>  

布局文件 : 

  

<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"  
    xmlns:tools="http://schemas.android.com/tools"  
    android:layout_width="match_parent"  
    android:layout_height="match_parent"  
    android:paddingBottom="@dimen/activity_vertical_margin"  
    android:paddingLeft="@dimen/activity_horizontal_margin"  
    android:paddingRight="@dimen/activity_horizontal_margin"  
    android:paddingTop="@dimen/activity_vertical_margin"  
    tools:context=".MainActivity" >  
  
    <ListView   
        android:id="@+id/lv"  
        android:layout_width="fill_parent"  
        android:layout_height="wrap_content"/>  
  
</RelativeLayout>  

Java代碼 : 

  

package shuliang.han.resourcetest;  
  
import android.app.Activity;  
import android.content.res.Resources;  
import android.content.res.TypedArray;  
import android.os.Bundle;  
import android.view.View;  
import android.view.ViewGroup;  
import android.widget.BaseAdapter;  
import android.widget.ListView;  
import android.widget.TextView;  
  
public class MainActivity extends Activity {  
  
    private String[] array_string;  
    private int[] array_int;  
    private TypedArray colors;  
    private ListView listView;  
    private Resources res;  
      
    @Override  
    protected void onCreate(Bundle savedInstanceState) {  
        super.onCreate(savedInstanceState);  
        setContentView(R.layout.activity_main);  
          
        //獲取resource對象  
        res = getResources();  
        //獲取字符串資源  
        array_string = res.getStringArray(R.array.string_array);  
        //獲取整數數組資源  
        array_int = res.getIntArray(R.array.integer_array);  
        //獲取顏色資源  
        colors = res.obtainTypedArray(R.array.color_array);  
          
        listView = (ListView) findViewById(R.id.lv);  
        listView.setAdapter(new MyBaseAdapter());  
          
    }  
      
    /* 
     * ListView適配器 
     */  
    class MyBaseAdapter extends BaseAdapter{  
  
        @Override  
        public int getCount() {  
            return array_string.length;  
        }  
  
        @Override  
        public Object getItem(int position) {  
            return array_string[position];  
        }  
  
        @Override  
        public long getItemId(int position) {  
            return position;  
        }  
  
        @Override  
        public View getView(int position, View convertView, ViewGroup parent) {  
            //創建TextView, 並設置寬高  
            TextView textView = new TextView(getApplicationContext());  
            textView.setHeight((int) res.getDimension(R.dimen.tv_height));  
            textView.setWidth((int) res.getDimension(R.dimen.tv_width));  
              
            //為TextView設置文本  
            textView.setText(array_int[position] + ". " + array_string[position]);  
            //設置TextView的背景 字體  
            textView.setBackgroundDrawable(colors.getDrawable(position));  
            textView.setTextSize(20);  
            return textView;  
        }  
    }  
}  

效果圖 :