Skip to content

Most visited

Recently visited

navigation

支持不同语言

在任何情况下,从您的应用代码中提取 UI 字符串并将其存放在外部文件中都是个好办法。Android 在每个 Android 项目中都提供一个资源目录,从而简化了这一过程。

如果您是使用 Android SDK 工具创建的项目(请阅读创建 Android 项目),工具会在项目的顶层创建一个 res/ 目录。此 res/ 目录中包含用于存放各类资源的子目录。此外,还包含几个默认文件(如 res/values/strings.xml),用于存放您的字符串值。

创建语言区域目录和字符串文件

如需添加对更多语言的支持,请在 内创建额外的 valuesres/ 目录,并在目录名称末尾加上连字符和 ISO 语言代码。例如,values-es/ 目录包含的简单资源用于语言代码为“es”的语言区域。Android 根据运行时设备的语言区域设置加载相应的资源。如需了解详细信息,请参阅提供备用资源

一旦您决定了为哪些语言提供支持,便可创建资源子目录和字符串资源文件。 例如:

MyProject/
    res/
       values/
           strings.xml
       values-es/
           strings.xml
       values-fr/
           strings.xml

将各个语言区域的字符串值添加到相应文件中。

在运行时,Android 系统会根据当前为用户设备设置的语言区域使用相应的字符串资源集。

例如,以下是一些面向不同语言的不同字符串资源文件。

英语(默认语言区域),/values/strings.xml

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <string name="title">My Application</string>
    <string name="hello_world">Hello World!</string>
</resources>

西班牙语,/values-es/strings.xml

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <string name="title">Mi Aplicación</string>
    <string name="hello_world">Hola Mundo!</string>
</resources>

法语,/values-fr/strings.xml

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <string name="title">Mon Application</string>
    <string name="hello_world">Bonjour le monde !</string>
</resources>

:您可以在任何资源类型上使用语言区域限定符(或任何配置限定符),例如,您可以提供本地化版本的可绘制位图。 如需了解详细信息,请参阅本地化

使用字符串资源

您可以使用由 <string> 元素的 name 属性定义的资源名称在您的源代码和其他 XML 文件中引用您的字符串资源。

在您的源代码中,可以使用语法 R.string.<string_name> 引用字符串资源。有许多方法都接受以这种方式引用的字符串资源。

例如:

// Get a string resource from your app's Resources
String hello = getResources().getString(R.string.hello_world);

// Or supply a string resource to a method that requires a string
TextView textView = new TextView(this);
textView.setText(R.string.hello_world);

在其他 XML 文件中,只要 XML 属性接受字符串值,您就可以使用语法 @string/<string_name> 引用字符串资源。

例如:

<TextView
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:text="@string/hello_world" />
This site uses cookies to store your preferences for site-specific language and display options.

Get the latest Android developer news and tips that will help you find success on Google Play.

* Required Fields

Hooray!

Browse this site in ?

You requested a page in , but your language preference for this site is .

Would you like to change your language preference and browse this site in ? If you want to change your language preference later, use the language menu at the bottom of each page.

This class requires API level or higher

This doc is hidden because your selected API level for the documentation is . You can change the documentation API level with the selector above the left navigation.

For more information about specifying the API level your app requires, read Supporting Different Platform Versions.

Take a short survey?
Help us improve the Android developer experience.
(Sep 2017 survey)