Devel/resources-i18n
From Android中文网
[编辑] 资源和国际化
资源是外部文件（即非源代码文件），它们被你的代码使用，并且在编译时被编译到你的应用程序中。Android支持很多不同类型的资源文件，包括XML、PNG和JPEG文件。XML文件会由于其所描述的内容不同而形式不同。该文档描述了所有支持的文件类型及每种类型的语法或格式。
资源从源代码中被抽取出来，基于效率考虑，XML文件被编译成二进制、可以快速加载的形式。字符串，同样被压缩为一种更富效率的存储形式。由于这些原因，在Android平台中我们就有了这些不同的资源类型。
该文档主要包含以下几个部分：
目录 |
这是一个技术意味浓厚的文档，它和资源参考一起发布，它们包含了有关资源的很多信息。在使用Android的过程中并不需要把这个文档烂熟于胸，但是当你需要它时你应该知道来这里寻找信息。
[编辑] 资源
这个话题包含了与之相应的术语列表，和一系列在代码中使用资源的实例。关于Android支持的所有资源类型的完整指南，参见资源。
Android资源系统了解应用程序中所有非代码的资源。你可以使用Resource类访问你的程序中的资源；与你的应用程序关联的Resource实例一般可以通过Context.getResource()获得。
一个应用程序的资源在编译时被编译器编译到应用程序的二进制文件中。要使用一个资源，你必须把安装源文件树中的正确位置，并且编译到你的应用程序中。作为编译过程的一部分，每个资源的标记都会被生成，在你的源代码中可以使用这些标记——允许编译器验证你的应用程序代码是否和你定义的资源相匹配。
本部分的其余内容将作为一个在应用程序中如何使用资源的指南。
[编辑] 创建资源
Android支持字符串、位图以及其他很多种类型的资源。每一种资源的语法、格式以及存放的位置，都会根据其类型的不同而不同。通常，你创建的资源一般来自于三种文件：XML文件（除位图和raw之外的任何文件）、位图文件（图像）以及Raw文件（除前面以外的其他东西，如声音文件，等等）。事实上，XML文件也有两种不同的类型：被原封不动地编译进包内的文件和被aapt用来产生资源的文件。这里有一个每种资源类型的列表，包括文件格式、文件描述以及XML文件类型的细节。
你可以在你的项目中的res/目录的适当的子目录中创建和保存资源文件。Android有一个资源编译器（aapt），它依照资源所在的子目录及其格式对其进行编译。这里有一个每种资源的文件类型的列表，关于每种类型的描述、语法、格式以及其包含文件的格式或语法见资源参考。
| 目录 | 资源类型 | |
|---|---|---|
| res/anim/ | XML文件，它们被编译进frame by frame animation或者tweened animationa对象 | |
| res/drawable/ | .png、.9.png、.jpg文件，它们被编译进以下的Drawable资源子类型中：
要获得这种类型的一个资源，可以使用Resource.getDrawable(id) | |
| res/layout/ | 被编译为屏幕布局（或屏幕的一部分）的XML文件。参见布局（layout） | |
| res/values/ | 可以被编译成很多种类型的资源的XML文件。
尽管这个文件夹里的文件可以任意命名，不过下面使一些比较典型的文件（文件命名的惯例是将元素类型包含在该名称之中）：
| |
| res/xml/ | 任意的XML文件，在运行时可以通过调用Resources.getXML()读取。 | |
| res/raw/ | 直接复制到设备中的任意文件。它们无需编译，添加到你的应用程序编译产生的压缩文件中。要使用这些资源，可以调用Resources.openRawResource()，参数是资源的ID，即R.raw.somefilename。 |
资源被编进最终的APK文件中。Android创建了一个封装类，叫做R，在代码中你可以使用它来引用这些资源。R包含了根据资源文件的路径和名称命名的子类。
全局资源说明（Global Resource Notes）
- 一些资源允许你定义颜色值。Android接受的颜色值可以使用多种web样式的形式--以下几种包含十六进制常数的形式：#RGB、#ARGB、#RRGGBB、#AARRGGBB。
- 所有颜色值支持设置透明度（alpha channel value），前两位的十六进制数指定了透明了。0在透明度值是全透明。默认值是不透明。
[编辑] 使用资源
这一部分描述如何使用你创建的资源。它包含以下主题：
- 代码中使用资源——如何在你的代码中调用资源进行实例化。
- 从其他资源中引用资源——你可以从其他资源中引用资源。这就使得你可以重用资源中公共资源值。
- 支持针对交替配置的交替资源——你可以根据主机硬件的语言或显示配置指定加载不同的资源。
在编译时，Android产生一个名为R的类，它包含了你的程序中所有资源的资源标识符。这个类包含了一些子类，每一个子类针对一种Android支持的资源类型，或者你提供的一个资源文件。每一个类都包含了已编译资源的一个或多个资源标识符，你可以在代码中使用它们来加载资源。下面是一个小的资源文件，包含了字符串、布局（屏幕或屏幕的一部分）和图像资源。
| 注意：R类是一个自动产生的文件，并没有设计为可以手动编辑。当资源更新时，它会根据需要重新产生。 |
| package com.google.android.samples;
public final class R {
}; |
[编辑] 在代码中使用资源
在代码中使用资源，只是要知道所有资源ID和你的被编译的资源是什么类型。下面是一个引用资源的语法：
R.resource_type.resource_name
或者
android.R.resource_type.resource_name
其中resource_type是R的子类，保存资源的一个特定类型。resource_name时在XML文件定义的资源的name属性，或者有其他文件类型为资源定义的文件名（不包含扩展名）。每一种资源类型都会根据其类型加为一个特定的R子类；要了解R的哪一个子类是关于你的资源类型的，请参考资源参考（resource reference）文档。被你的应用程序编译的资源可以不加包名引用（就像R.resource_type.resource_name这样简单）。Android包含了很多标准资源，如屏幕样式和按钮背景。要在代码中引用这些资源，你必须使用android进行限定，如android.R.drawable.button_background。
这里有一些还算不错的在代码中使用已编译资源的例子。
|
[编辑] 引用资源
在属性（或资源）中提供的值也可以作为资源的引用。这种情况经常使用在布局文件中，以提供字符串（因此它们可以被本地化<将UI上的字符串放在一个单独的文件中，在做国际化时只需要将它们翻译成相应的语言版本，然后应用程序根据locale信息加载相应的字符串文件——译者注>）和图像（它们存在于另外的文件中），虽然引用可以是任何资源类型，包括颜色和整数。
例如，如果我们有颜色资源（color resources），我们可以编写一个布局文件，将文本的颜色设为那些资源中包含的值：
| <?xml version="1.0" encoding="utf-8"?>
<EditText id="text" xmlns:android="http://schemas.android.com/apk/res/android"
|
注意，这里使用“@”前缀引入对一个资源的引用——在@[package:]type/name形式中后面的文本是资源的名称。在这种情况下，我们不需要指定包名，因为我们引用的是我们自己包中的资源。要引用系统资源，你应该这样写：
| <?xml version="1.0" encoding="utf-8"?>
<EditText id="text" xmlns:android="http://schemas.android.com/apk/res/android"
|
另外一个例子，你应该一直使用资源引用。当在布局文件中提供字符串时，你就可以将它们本地化。
| <?xml version="1.0" encoding="utf-8"?>
<EditText id="text" xmlns:android="http://schemas.android.com/apk/res/android"
|
这种技巧还可以用来创建资源之间的引用。例如，我们可以创建新的drawable资源作为已存在资源的别名。
| <?xml version="1.0" encoding="utf-8"?>
<resources>
</resources> |
[编辑] 引用主题属性
另外一种资源值允许你引用当前主题中的属性的值。这个属性值只能在样式资源和XML属性中使用；它允许你通过将它们改变为当前主题提供的标准变化来改变UI元素的外观，而不是提供具体的值。
如例中所示，我们在布局资源中使用这个特性将文本颜色设定为标准颜色的一种，这些标准的颜色都是定义在基本系统主题中。
| <?xml version="1.0" encoding="utf-8"?>
<EditText id="text" xmlns:android="http://schemas.android.com/apk/res/android"
|
注意，这和资源引用非常类似，除了我们使用一个“?”前缀代替了“@”。当你使用这个标记时，你就提供了属性资源的名称，它将会在主题中被查找——因为资源工具知道需要的属性资源，所以你不需要显示声明这个类型（如果声明，其形式就是?android:attr/android:textDisabledColor）。
除了使用这个资源的标识符来查询主题中的值代替原始的资源，在这里关于该类型的name语法：?[namespace:]typpe/name和“@”形式一样，也是可选。
[编辑] 使用系统资源
在系统中的包含了很多应用程序可以使用的资源。所有的这些资源都在“android.R”类下定义。例如，使用下面的代码你可以在屏幕上显示标准应用程序的图标：
public class MyActivity extends Activity {
} |
以相似的方式，下面的代码将对你的屏幕应用系统定义的标准“绿色背景”视觉处理。
public class MyActivity extends Activity
} |
[编辑] 支持对替换（Alternate）语言和配置的替换资源
你可以根据UI语言或者设备上的硬件配置，为你的产品提供不同的资源。注意，尽管你可以包含不同的字符串、布局和其他资源，然而SDK没有方法供你指定加载哪一个替换资源。Android检测关于硬件和未知的适当配置，然后适当加载。用户可以使用设备上的设置面板选择替换语言设置。
为了包含替换资源，需要创建平行的资源文件夹，而文件夹的名字后面要使用限定符表示它要应用的配置（语言、屏幕方向等等）。例如，下面的工程包含了字符串资源，一个用于英语，而另外一个用于法语：
MyApp/
|
Android支持几种类型的限定符，每一个都有不同的值。把它们连接在资源文件夹名称的后面，使用短横线隔开。你可以为每一个文件夹名称添加多个限定符，但是它们必须按照这里列出的顺序排列。例如，一个包含drawable资源的文件夹，对于一个完整详细的配置，可能看起来像：
MyApp/
|
更典型的是，你只需指定一些特定的要定义资源的配置选项。你可以放弃完整列表中的任何值，但同时要保证剩下的值仍然保持列表中的顺序。
MyApp/
|
| Qualifier | Values |
[编辑] 资源参考
资源参考（Resource Reference）文档提供了各种资源类型的详细列表，以及在Java代码中或者从其他引用如何使用它们。
