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; } } }
效果图 :
