有关Android国际化的一点积累
流行好用的软件应该能够适用于不同地区的市场。下面记录一些在项目中国际化的应用，有关图片和文本资源的自适应。
Android采用XML资源文件来管理所有字符串消息，如果系统设置的Custom Locale，没有对应的本地化资源文件，那么程序就会取默认的res\values\strings.xml。在此我们默认的strings为英文，如下：
<?xml version="1.0" encoding="utf-8"?> <resources> <string name="app_name">L10NTest</string> <string name="action_settings">Settings</string> <string name="hello_world">Hello world!</string> <string name="I_love_you">I love you.</string> </resources>
我们添加有关中文的字符串资源，这需要为values目录添加中文的语言国家版本。values文件夹的命名方式为：values－语言代码－ｒ国家代码。
如果想要支持中文的话，则需要在res目录下添加values-zh-rCN。该文件夹中的strings如下：
<?xml version="1.0" encoding="utf-8"?> <resources> <string name="app_name">国际化测试</string> <string name="action_settings">设置</string> <string name="hello_world">世界，你好！</string> <string name="I_love_you">我爱你.</string> </resources>
如果希望应用的图片也能随语言环境改变，则需要为drawable目录添加其他的语言国家版本。drawable文件夹的命名方式为：drawable－语言代码－ｒ国家代码。同样支持中文的话需要在res目录下添加drawable-zh-rCN。
如果还需要为drawable目录按照分辨率提供文件夹，可以在其后追加分辨率后缀，如：drawable-zh-rCN-mdpi、drawable-en-rUS-xhdpi等等。
主Activity中没有写任何东西，下面是它的XML布局：
<LinearLayout 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:gravity="center" android:orientation="vertical" > <ImageView android:layout_width="wrap_content" android:layout_height="wrap_content" android:src="@drawable/country" tools:ignore="ContentDescription" /> <!-- tools:ignore="ContentDescription",屏蔽掉对View设置备注说明的提示 --> <TextView android:layout_width="wrap_content" android:layout_height="wrap_content" android:text="@string/hello_world" android:textSize="20sp" /> <TextView android:layout_width="wrap_content" android:layout_height="wrap_content" android:text="@string/I_love_you" android:textSize="20sp" /> </LinearLayout>
在android ADT 16.0以后的控件中，没有文本描述的view如果不加android:contentDescription="@string/……"的话就会有黄 色的下划线，提示“[Accessibility] Missing contentDescription attribute on image”。加“ tools:ignore="ContentDescription"“便是屏蔽掉该提示。这句代码不加也没什么影响，在界面上不会有其他效果，当然也可以写一些字符串数据做提示，方便他人阅读。或者直接写成：
<ImageView android:layout_width="wrap_content" android:layout_height="wrap_content" android:contentDescription="@null" android:src="@drawable/country" />
也可。
以下是应用的res结构：
我增加了”drawable-en-rUS“、”drawable-zh-rCN“和”values-zh-rCN“三个文件夹，其中前两个文件夹中放了名称都是”country“的图片，只是前者为美国国旗图片，后者为中国国旗图片。第三个文件夹中的strings文件上面已给出。
运行程序，如果设置系统的语言和输入为中文，效果图如下：
如果设置为英文，效果图如下：
我并没有增加有关英文的本地化资源文件，所以程序就会取res\values\下的strings.xml，当然也可以增加对应的文件夹为：values-en-rUS，其中放置相关文本资源。
如果是其他国家的语言环境，那文件夹该如何命名呢，以字符串资源为例，如下：
中文（中国）：values-zh-rCN
中文（台湾）：values-zh-rTW
中文（香港）：values-zh-rHK
英语（美国）：values-en-rUS
英语（英国）：values-en-rGB
英文（澳大利亚）：values-en-rAU
英文（加拿大）：values-en-rCA
英文（爱尔兰）：values-en-rIE
英文（印度）：values-en-rIN
英文（新西兰）：values-en-rNZ
英文（新加坡）：values-en-rSG
英文（南非）：values-en-rZA
阿拉伯文（埃及）：values-ar-rEG
阿拉伯文（以色列）：values-ar-rIL
保加利亚文: values-bg-rBG
加泰罗尼亚文：values-ca-rES
捷克文：values-cs-rCZ
丹麦文：values-da-rDK
德文（奥地利）：values-de-rAT
德文（瑞士）：values-de-rCH
德文（德国）：values-de-rDE
德文（列支敦士登）：values-de-rLI
希腊文：values-el-rGR
西班牙文（西班牙）：values-es-rES
西班牙文（美国）：values-es-rUS
芬兰文（芬兰）：values-fi-rFI
法文（比利时）：values-fr-rBE
法文（加拿大）：values-fr-rCA
法文（瑞士）：values-fr-rCH
法文（法国）：values-fr-rFR
希伯来文：values-iw-rIL
印地文：values-hi-rIN
克罗里亚文：values-hr-rHR
匈牙利文：values-hu-rHU
印度尼西亚文：values-in-rID
意大利文（瑞士）：values-it-rCH
意大利文（意大利）：values-it-rIT
日文：values-ja-rJP
韩文：values-ko-rKR
立陶宛文：valueslt-rLT
拉脱维亚文：values-lv-rLV
挪威博克马尔文：values-nb-rNO
荷兰文(比利时)：values-nl-BE
荷兰文（荷兰）：values-nl-rNL
波兰文：values-pl-rPL
葡萄牙文（巴西）：values-pt-rBR
葡萄牙文（葡萄牙）：values-pt-rPT
罗马尼亚文：values-ro-rRO
俄文：values-ru-rRU
斯洛伐克文：values-sk-rSK
斯洛文尼亚文：values-sl-rSI
塞尔维亚文：values-sr-rRS
瑞典文：values-sv-rSE
泰文：values-th-rTH
塔加洛语：values-tl-rPH
土耳其文：values--r-rTR
乌克兰文：values-uk-rUA
越南文：values-vi-rVN
事实上可以通过程序获取JAVA所有支持的语言和国家的，程序代码如下：
import java.util.Locale;
public class Test {
public static void main(String[] args) {
//调用Locale类的getAvailableLocales方法获取，该方法返回一个数组，其中包含JAVA支持的语言和国家
Locale[] localeList = Locale.getAvailableLocales();
//依次获取所支持的国家和语言
for (int i = 0; i < localeList.length; i++) {
System.out.println(localeList[i].getDisplayCountry() + "="
+ localeList[i].getCountry() + ""
+ localeList[i].getDisplayLanguage() + "="
+ localeList[i].getLanguage());
}
}
}
输出结果如下（有些国家可能会使用多种语言）：
马来西亚=MY马来文=ms 卡塔尔=QA阿拉伯文=ar 冰岛=IS冰岛文=is 芬兰=FI芬兰文=fi =波兰文=pl 马耳他=MT英文=en 瑞士=CH意大利文=it 比利时=BE荷兰文=nl 沙特阿拉伯=SA阿拉伯文=ar 伊拉克=IQ阿拉伯文=ar 波多黎哥=PR西班牙文=es 智利=CL西班牙文=es =芬兰文=fi 奥地利=AT德文=de =丹麦文=da 英国=GB英文=en 巴拿马=PA西班牙文=es =塞尔维亚文=sr 也门=YE阿拉伯文=ar 马其顿王国=MK马其顿文=mk =马其顿文=mk 加拿大=CA英文=en 越南=VN越南文=vi 荷兰=NL荷兰文=nl 美国=US西班牙文=es 中国=CN中文=zh 洪都拉斯=HN西班牙文=es 美国=US英文=en =法文=fr =泰文=th =阿拉伯文=ar 摩洛哥=MA阿拉伯文=ar =拉托维亚文(列托)=lv =德文=de 印度尼西亚=ID印度尼西亚文=in =克罗地亚文=hr 南非=ZA英文=en 韩国=KR朝鲜文=ko 突尼斯=TN阿拉伯文=ar =印度尼西亚文=in =日文=ja 塞尔维亚=RS塞尔维亚文=sr 白俄罗斯=BY白俄罗斯文=be 台湾地区=TW中文=zh 苏丹=SD阿拉伯文=ar =葡萄牙文=pt =冰岛文=is 日本=JP日文=ja 玻利维亚=BO西班牙文=es 阿尔及利亚=DZ阿拉伯文=ar =马来文=ms 阿根廷=AR西班牙文=es 阿拉伯联合酋长国=AE阿拉伯文=ar 加拿大=CA法文=fr =斯洛文尼亚文=sl =西班牙文=es 立陶宛=LT立陶宛文=lt 黑山=ME塞尔维亚文=sr 叙利亚=SY阿拉伯文=ar 俄罗斯=RU俄文=ru 比利时=BE法文=fr 西班牙=ES西班牙文=es =保加利亚文=bg 以色列=IL希伯来文=iw =瑞典文=sv =英文=en =希伯来文=iw 丹麦=DK丹麦文=da 哥斯达黎加=CR西班牙文=es 香港=HK中文=zh =中文=zh 西班牙=ES加泰罗尼亚文=ca 泰国=TH泰文=th 乌克兰=UA乌克兰文=uk 多米尼加共和国=DO西班牙文=es 委内瑞拉=VE西班牙文=es 波兰=PL波兰文=pl 利比亚=LY阿拉伯文=ar 约旦=JO阿拉伯文=ar =意大利文=it =乌克兰文=uk 匈牙利=HU匈牙利文=hu =爱尔兰文=ga 危地马拉=GT西班牙文=es 巴拉圭=PY西班牙文=es 保加利亚=BG保加利亚文=bg 克罗地亚=HR克罗地亚文=hr 波斯尼亚和黑山共和国=BA塞尔维亚文=sr 罗马尼亚=RO罗马尼亚文=ro 卢森堡=LU法文=fr =挪威文=no =立陶宛文=lt 新加坡=SG英文=en 厄瓜多尔=EC西班牙文=es 波斯尼亚和黑山共和国=BA塞尔维亚文=sr 尼加拉瓜=NI西班牙文=es =斯洛伐克文=sk =俄文=ru =马耳他文=mt 萨尔瓦多=SV西班牙文=es =荷兰文=nl 印度=IN印地文=hi =爱沙尼亚文=et 希腊=GR希腊文=el 斯洛文尼亚=SI斯洛文尼亚文=sl 意大利=IT意大利文=it 日本=JP日文=ja 卢森堡=LU德文=de 瑞士=CH法文=fr 马耳他=MT马耳他文=mt 巴林=BH阿拉伯文=ar =阿尔巴尼亚文=sq =越南文=vi 黑山=ME塞尔维亚文=sr 巴西=BR葡萄牙文=pt 挪威=NO挪威文=no =希腊文=el 瑞士=CH德文=de 新加坡=SG中文=zh 科威特=KW阿拉伯文=ar 埃及=EG阿拉伯文=ar 爱尔兰=IE爱尔兰文=ga 秘鲁=PE西班牙文=es 捷克共和国=CZ捷克文=cs 土耳其=TR土耳其文=tr =捷克文=cs 乌拉圭=UY西班牙文=es 爱尔兰=IE英文=en 印度=IN英文=en 阿曼=OM阿拉伯文=ar 塞尔维亚及黑山=CS塞尔维亚文=sr =加泰罗尼亚文=ca =白俄罗斯文=be =塞尔维亚文=sr =朝鲜文=ko 阿尔巴尼亚=AL阿尔巴尼亚文=sq 葡萄牙=PT葡萄牙文=pt 拉脱维亚=LV拉托维亚文(列托)=lv 塞尔维亚=RS塞尔维亚文=sr 斯洛伐克=SK斯洛伐克文=sk 墨西哥=MX西班牙文=es 澳大利亚=AU英文=en 挪威=NO挪威文=no 新西兰=NZ英文=en 瑞典=SE瑞典文=sv =罗马尼亚文=ro 黎巴嫩=LB阿拉伯文=ar 德国=DE德文=de 泰国=TH泰文=th =土耳其文=tr 哥伦比亚=CO西班牙文=es 菲律宾=PH英文=en 爱沙尼亚=EE爱沙尼亚文=et 塞浦路斯=CY希腊文=el =匈牙利文=hu 法国=FR法文=fr
在做项目时，我遇到这样一种情况，字符串资源需要JAVA代码来控制，而不是在XML文件中获取，下面提供该方法：
创建ConstantBase类来定义你需要的字符串，如下：
package com.example.l10ntest;
public class ConstantBase {
public String PUT_NAME;
public String SAY_LOVE;
public String NEXT;
public String Second_Page;
}
中英文的字符串类分别命名如下，中文：
package com.example.l10ntest;
public class ConstantCH extends ConstantBase {
public ConstantCH() {
//此处定义需要的中文字符串
PUT_NAME = "请输入你的名字。";
SAY_LOVE = "我爱你";
NEXT = "下一页";
Second_Page = "第二页";
}
}
英文：
package com.example.l10ntest;
public class ConstantEN extends ConstantBase {
public ConstantEN() {
// 此处定义需要的英文字符串
PUT_NAME = "Please put your name.";
SAY_LOVE = "I love you";
NEXT = "next";
Second_Page = "The second page";
}
}
我在新创建的Constant类中写了本地语言的判断方法，该类如下：
package com.example.l10ntest;
import java.util.Locale;
public class Constant {
public static ConstantBase string = produceConstant();
public static ConstantBase produceConstant() {
if (isLocalLanguageZH()) {
string = new ConstantCH();
} else {
string = new ConstantEN();
}
return string;
}
//判断本地语言是否是中文
public static boolean isLocalLanguageZH() {
if (Locale.getDefault().getLanguage().contains("zh")
&& Locale.getDefault().getCountry().contains("CN")) {
return true;
}
return false;
}
}
主类的XML文件做一下修改（暂时将ImageView屏蔽掉，后面增加了一个Button），如下：
<LinearLayout 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:gravity="center" android:orientation="vertical" > <!-- <ImageView android:layout_width="wrap_content" android:layout_height="wrap_content" android:contentDescription="@null" android:src="@drawable/country" /> --> <!-- tools:ignore="ContentDescription",屏蔽掉对View设置备注说明的提示 --> <TextView android:id="@+id/putName" android:layout_width="wrap_content" android:layout_height="wrap_content" android:text="@null" android:textSize="20sp" /> <TextView android:id="@+id/iloveyou" android:layout_width="wrap_content" android:layout_height="wrap_content" android:text="@null" android:textSize="20sp" /> <Button android:id="@+id/next" android:layout_width="wrap_content" android:layout_height="wrap_content" /> </LinearLayout>
在主类中，写如下代码：
((TextView) findViewById(R.id.putName)) .setText(Constant.string.PUT_NAME); ((TextView) findViewById(R.id.iloveyou)) .setText(Constant.string.SAY_LOVE);
这样便可以通过JAVA代码来控制字符串的获取了。但是发现一个问题，就是当程序切换到后台时，你将手机终端的语言修改，比如当前中文修改为英文，再从后台将该程序拉起时，显示的文本信息并不会随着变换，如果以前是中文，修改系统语言后还是中文，国际化似乎不生效。最后发现只有将该程序进程杀死，再次启动，国际化才会生效。但是每次切换一下终端语言就人为杀进程重启应用，显然是不合理的。
事实上当locale信息改变之后，系统会发广播消息Intent.ACTION_LOCALE_CHANGED，我们可以写接收该广播的代码，并做一些操作。
不妨多写几个Activity页面做测试，我写了两个，MainActivity经过修改的XML前面已经给出了，MainActivity如下：
package com.example.l10ntest;
import android.content.Intent;
import android.os.Bundle;
import android.view.View;
import android.view.View.OnClickListener;
import android.widget.Button;
import android.widget.TextView;
public class MainActivity extends BaseActivity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
((TextView) findViewById(R.id.putName))
.setText(Constant.string.PUT_NAME);
((TextView) findViewById(R.id.iloveyou))
.setText(Constant.string.SAY_LOVE);
Button btn = (Button) findViewById(R.id.next);
btn.setText(Constant.string.NEXT);
btn.setOnClickListener(new OnClickListener() {
@Override
public void onClick(View v) {
startActivity(new Intent(MainActivity.this,SecondActivity.class));
}
});
}
}
第二个Activity（SecondActivity）我没有写XML布局，代码如下：
package com.example.l10ntest;
import android.os.Bundle;
import android.view.Gravity;
import android.widget.TextView;
public class SecondActivity extends BaseActivity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
TextView textView = new TextView(this);
textView.setGravity(Gravity.CENTER);
textView.setText(Constant.string.Second_Page);
textView.setTextSize(30);
setContentView(textView);
}
}
事实上一个应用一般不会只有一个Activity的，我将两个Activity都继承了BaseActivity，在BaseActivity中对这两个Activity做统一管理，BaseActivity如下：
package com.example.l10ntest;
import android.app.Activity;
import android.os.Bundle;
public class BaseActivity extends Activity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
Utils.addToList(this);
}
}
只调用了Utils类里的一个方法，在Activity创建后，将它添加到List里面。Utils类代码如下：
package com.example.l10ntest;
import java.util.ArrayList;
import java.util.Iterator;
import android.app.Activity;
import android.util.Log;
public class Utils {
private static String TAG = "Utils";
// 创建存放Activity的集合
private static ArrayList<Activity> activityList = new ArrayList<Activity>();
public static void addToList(Activity activity) {
Log.i(TAG, "activity name:" + activity.getClass().getName());
activityList.add(activity);
}
public static void stopApp() {
Iterator<Activity> itr = activityList.iterator();
Activity a = null;
while (itr.hasNext()) {
a = itr.next();
a.finish();
}
Log.i(TAG, "stopApp end.");
System.exit(0);
}
}
这里面有两个方法，一个就是添加Activity做统一管理，第二个是停止程序的方法，先将List中的Activity依次杀死，再杀死进程退出程序。
下面就是比较重要的接收系统广播的类了，代码如下：
package com.example.l10ntest;
import android.content.BroadcastReceiver;
import android.content.Context;
import android.content.Intent;
public class AppExitReceiver extends BroadcastReceiver {
@Override
public void onReceive(Context context, Intent intent) {
if (intent == null || intent.getAction() == null)
return;
if (intent.getAction().equals(Intent.ACTION_LOCALE_CHANGED)) {
Utils.stopApp();
}
}
}
AndroidManifest.xml文件如下，配置了一个广播接收。
<?xml version="1.0" encoding="utf-8"?> <manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.example.l10ntest" android:versionCode="1" android:versionName="1.0" > <uses-sdk android:minSdkVersion="8" android:targetSdkVersion="17" /> <application android:allowBackup="true" android:icon="@drawable/ic_launcher" android:label="@string/app_name" android:theme="@style/AppTheme" > <activity android:name="com.example.l10ntest.MainActivity" android:label="@string/app_name" > <intent-filter> <action android:name="android.intent.action.MAIN" /> <category android:name="android.intent.category.LAUNCHER" /> </intent-filter> </activity> <activity android:name="com.example.l10ntest.SecondActivity" android:label="@string/app_name" > </activity> <receiver android:name="com.example.l10ntest.AppExitReceiver" > <intent-filter> <action android:name="android.intent.action.LOCALE_CHANGED" /> </intent-filter> </receiver> </application> </manifest>
整理一下思路：
写了两个Activity，这两个Activity都用到了文本资源，如“((TextView) findViewById(R.id.iloveyou)).setText(Constant.string.SAY_LOVE);”和“textView.setText(Constant.string.Second_Page);”MainActivity中增加了跳转到SecondActivity的按钮。两个Activity都继承了BaseActivity，当它们创建后，会通过BaseActivity中的“Utils.addToList(this)”将它们依次添加到Utils类中的activityList里。
在终端切换系统语言，发送Intent.ACTION_LOCALE_CHANGED广播后，我们创建AppExitReceiver类来接收该广播，并调用“Utils.stopApp()“来将创建的Activity依次关闭，并且退出应用程序，这样不管该程序从后台切回来还是点击该程序的图标，程序都会重新启动，显示的文本信息会随着系统语言的变换而变换。