Android实现多语言so easy

 

微信公众号:CodingAndroid
CSDN:http://blog.csdn.net/xinpengfei521
声明:本文由CodingAndroid原创,未经授权,不可随意转载!

      最近,我们公司的业务已经拓展到了香港,我们都知道香港使用的是繁体中文,因此,我们的APP要可以设置繁体语言,这不我们要紧跟国际的步伐,实现多语言,产品定给我们的需求主要以实现简体中文、繁体中文、英文三种语言切换即可,具体的业务逻辑是:当用户第一次进入APP时,App的语言跟随当前系统语言,当用户设置了某种语言之后就切换为用户设置的语言,不管系统之后设置成哪种语言,都不会影响用户设置的语言,如果用户一直没有设置语言选项,只要系统语言改变时,APP的语言也要跟随系统语言设置改变。

      说明:本文以实现简体中文、繁体中文和英语为例进行简要讲解。

1.实现思路

      我们可以预先使用SharedPreference来保存一个语言类型的值,当用户第一次进入APP时,我们通过Key取出这个值,第一次肯定是取不到的,这时我们将App的语言设置为当前系统默认值即可;当用户通设置多语言时,我们将这个语言对应的值通过SharedPreference保存到本地即可,然后此时重启APP,设置为用户设置的语言即可,以后每次进入App时只需取出保存用户设置的语言设置即可,一般设置语言写在程序的入口 ApplicationonCreate() 方法里。

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~

若在使用过程中遇到什么问题,或有好提议,欢迎在公众号“CodingAndroid”中提出
这里写图片描述

posted @ 2017-12-03 23:03 IT大飞说 阅读(...) 评论(...) 编辑 收藏