Android实现多语言so easy
Android实现多语言so easy
#Android实现多语言so easy
微信公众号：CodingAndroid CSDN：http://blog.csdn.net/xinpengfei521 声明：本文由博主原创，如需转载请注明出处！
最近，我们公司的业务已经拓展到了中国香港，我们都知道中国香港使用的是繁体中文，因此，我们的APP要可以设置繁体语言，这不我们要紧跟国际的步伐，实现多语言，产品定给我们的需求主要以实现简体中文、繁体中文、英文三种语言切换即可，具体的业务逻辑是：当用户第一次进入APP时，App的语言跟随当前系统语言，当用户设置了某种语言之后就切换为用户设置的语言，不管系统之后设置成哪种语言，都不会影响用户设置的语言，如果用户一直没有设置语言选项，只要系统语言改变时，APP的语言也要跟随系统语言设置改变。
说明：本文以实现简体中文、繁体中文和英语为例进行简要讲解。
##1.实现思路
我们可以预先使用SharedPreference来保存一个语言类型的值，当用户第一次进入APP时，我们通过Key取出这个值，第一次肯定是取不到的，这时我们将App的语言设置为当前系统默认值即可；当用户通设置多语言时，我们将这个语言对应的值通过SharedPreference保存到本地即可，然后此时重启APP，设置为用户设置的语言即可，以后每次进入App时只需取出保存用户设置的语言设置即可，一般设置语言写在程序的入口 Application 的 onCreate() 方法里。
##2.自定义SharedPreference工具类
作用：用于保存当前设置语言的类型，此文以SharedPreference保存为例，当然使用数据库或者其他保存方式也是可以的。
/**
* Created by xpf on 2017/03/25 :)
* Function: sp存储的工具类
*/
public class SpUtil {
private static final String APP_SP = "app_sp";
private static final String TAG = SpUtil.class.getSimpleName();
private SpUtil() {
}
private static SpUtil instance = new SpUtil();
private static SharedPreferences mSp = null;
public static SpUtil getInstance() {
if (mSp == null) {
mSp = MyApplication.getContext().getSharedPreferences(APP_SP, Context.MODE_PRIVATE);
}
return instance;
}
/**
* 保存数据
*
* @param key 键
* @param value 值
*/
public void save(String key, Object value) {
if (value == null) {
Log.e(TAG, "value==null保存失败");
return;
}
if (value instanceof String) {
mSp.edit().putString(key, (String) value).commit();
} else if (value instanceof Boolean) {
mSp.edit().putBoolean(key, (Boolean) value).commit();
} else if (value instanceof Integer) {
mSp.edit().putInt(key, (Integer) value).commit();
}
}
/**
* 读取String类型数据
*
* @param key
* @param defValue
* @return
*/
public String getString(String key, String defValue) {
return mSp.getString(key, defValue);
}
/**
* 读取boolean类型数据
*
* @param key
* @param defValue
* @return
*/
public boolean getBoolean(String key, boolean defValue) {
return mSp.getBoolean(key, defValue);
}
/**
* 读取boolean类型数据
*
* @param key
* @param defValue
* @return
*/
public int getInt(String key, int defValue) {
return mSp.getInt(key, defValue);
}
/**
* 清除所有保存的数据(xxx.xml仍然存在，但是内部没有数据)
*/
public void clearAll() {
mSp.edit().clear().commit();
}
}
##3.自定义LocaleUtil工具类
作用：用于设置保存语言及获取当前语言，重启APP等操作
public class LocaleUtil {
/**
* 获取用户设置的Locale
*
* @return Locale
*/
public static Locale getUserLocale() {
int currentLanguage = SpUtil.getInstance().getInt("currentLanguage", 0);
Locale myLocale = Locale.SIMPLIFIED_CHINESE;
switch (currentLanguage) {
case 0:
myLocale = Locale.SIMPLIFIED_CHINESE;
break;
case 1:
myLocale = Locale.ENGLISH;
break;
case 2:
myLocale = Locale.TRADITIONAL_CHINESE;
break;
}
return myLocale;
}
/**
* 设置语言：如果之前有设置就遵循设置如果没设置过就跟随系统语言
*/
public static void changeAppLanguage(Context context) {
if (context == null) return;
Context appContext = context.getApplicationContext();
int currentLanguage = SpUtil.getInstance().getInt("currentLanguage", -1);
Locale myLocale;
// 0 简体中文 1 繁体中文 2 English
switch (currentLanguage) {
case 0:
myLocale = Locale.SIMPLIFIED_CHINESE;
break;
case 1:
myLocale = Locale.TRADITIONAL_CHINESE;
break;
case 2:
myLocale = Locale.ENGLISH;
break;
default:
myLocale = appContext.getResources().getConfiguration().locale;
}
// 本地语言设置
if (needUpdateLocale(appContext, myLocale)) {
updateLocale(appContext, myLocale);
}
}
/**
* 保存设置的语言
*
* @param currentLanguage index
*/
public static void changeAppLanguage(Context context, int currentLanguage) {
if (context == null) return;
Context appContext = context.getApplicationContext();
SpUtil.getInstance().save("currentLanguage", currentLanguage);
Locale myLocale = Locale.SIMPLIFIED_CHINESE;
// 0 简体中文 1 繁体中文 2 English
switch (currentLanguage) {
case 0:
myLocale = Locale.SIMPLIFIED_CHINESE;
break;
case 1:
myLocale = Locale.TRADITIONAL_CHINESE;
break;
case 2:
myLocale = Locale.ENGLISH;
break;
}
// 本地语言设置
if (LocaleUtil.needUpdateLocale(appContext, myLocale)) {
LocaleUtil.updateLocale(appContext, myLocale);
}
Toast.makeText(appContext, appContext.getString(R.string.set_success), Toast.LENGTH_SHORT).show();
restartApp(appContext);
}
/**
* 重启app生效
*
* @param context
*/
public static void restartApp(Context context) {
Intent intent = new Intent(context, MainActivity.class);
intent.setAction(Intent.ACTION_MAIN);
intent.addCategory(Intent.CATEGORY_LAUNCHER);
intent.setFlags(Intent.FLAG_ACTIVITY_CLEAR_TASK | Intent.FLAG_ACTIVITY_NEW_TASK);
context.startActivity(intent);
}
/**
* 获取当前的Locale
*
* @param context Context
* @return Locale
*/
public static Locale getCurrentLocale(Context context) {
Locale locale;
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) { //7.0有多语言设置获取顶部的语言
locale = context.getResources().getConfiguration().getLocales().get(0);
} else {
locale = context.getResources().getConfiguration().locale;
}
return locale;
}
/**
* 更新Locale
*
* @param context Context
* @param locale New User Locale
*/
public static void updateLocale(Context context, Locale locale) {
if (needUpdateLocale(context, locale)) {
Configuration configuration = context.getResources().getConfiguration();
if (Build.VERSION.SDK_INT >= 19) {
configuration.setLocale(locale);
} else {
configuration.locale = locale;
}
DisplayMetrics displayMetrics = context.getResources().getDisplayMetrics();
context.getResources().updateConfiguration(configuration, displayMetrics);
}
}
/**
* 判断需不需要更新
*
* @param context Context
* @param locale New User Locale
* @return true / false
*/
public static boolean needUpdateLocale(Context context, Locale locale) {
return locale != null && !getCurrentLocale(context).equals(locale);
}
/**
* 当系统语言发生改变的时候还是继续遵循用户设置的语言
*
* @param context
* @param newConfig
*/
public static void setLanguage(Context context, Configuration newConfig) {
if (context == null) return;
Context appContext = context.getApplicationContext();
int currentLanguage = SpUtil.getInstance().getInt("currentLanguage", -1);
Locale locale;
// 0 简体中文 1 繁体中文 2 English
switch (currentLanguage) {
case 0:
locale = Locale.SIMPLIFIED_CHINESE;
break;
case 1:
locale = Locale.TRADITIONAL_CHINESE;
break;
case 2:
locale = Locale.ENGLISH;
break;
default:
locale = appContext.getResources().getConfiguration().locale;
}
// 系统语言改变了应用保持之前设置的语言
if (locale != null) {
Locale.setDefault(locale);
Configuration configuration = new Configuration(newConfig);
if (Build.VERSION.SDK_INT >= 19) {
configuration.setLocale(locale);
} else {
configuration.locale = locale;
}
appContext.getResources().updateConfiguration(configuration, appContext.getResources().getDisplayMetrics());
}
}
}
###3.1Application中调用，用于初始化语言设置
@Override
public void onCreate() {
super.onCreate();
LocaleUtil.changeAppLanguage(this);
}
###3.2在Application中重写如下方法：用于当系统设置语言变化时进行语言设置
@Override
public void onConfigurationChanged(Configuration newConfig) {
super.onConfigurationChanged(newConfig);
Log.e("TAG", "onConfigurationChanged");
LocaleUtil.setLanguage(mContext, newConfig);
}
###3.3在多语言设置界面设置APP语言
当用户点击保存时传入当前语言对应的Index值即可，我这里使用的是保存一个Int类型的值，每一个Int类型的值对应一种语言的类型，当然你可以根据自己的实现保存为String类型也是可以的。
LocaleUtil.changeAppLanguage(mContext, currentLanguage);
##4.多国语言文件夹命名对应表如下：
本文只以简体中文、繁体中文和英语为例，要想实现更多语言设置，请参考下表：
国家 | Folder Name |
|---|---|
中文（中国） | 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 |
##5.常见的一些坑
- 设置英文语言时在有些手机上不起作用 在开发过程中我们试过在Redmi Note 4手机上设置英语语言不起作用，这是由于有些手机厂商的默认英语设置的是英式英语，而我们只使用了美式英语的缘故，此时处理方式为：①设置两种英语的设置选项，即美式英语和英式英语；②可将res的文件夹命名为values-en即可，不区分英式英语和美式英语即可；
- 在Android Studio3.0之前，如果有些strings没有对应到其他的语种，即有些字段没有翻译过来，打包时会 报警告，可以打成包，而3.0之后是不可以的，会打包失败，所以每个Strings必须对应一套完整的翻译！
##6.相关权限
<uses-permission android:name="android.permission.CHANGE_CONFIGURATION"/>
##7.更多探讨
在实现APP种切换语言时，试了试微信的多语言设置页面是在4级页面，当它设置完语言之后先是跳转到我 界面（一级页面），然后紧接着跳到设置界面（二级页面），貌似微信没有重启App，它只是管理保存了Activity任务栈，最后跳转到设置界面，而我的例子只是重启了App没有跳转回到设置界面，当然这要看具体的需求了，我个人感觉，设置完就没有必要再跳转回去了。
最后附上Demo: https://github.com/xinpengfei520/Multi-Language
如果你觉得不错可以帮我点个star,3Q~
本文首发于我的微信公众号，更多干货文章，请扫描二维码订阅哦：