Android Locale语言设置
- 一.系统设置
- 二.应用级设置
- (一)更新Locale
- 1.updateConfiguration
- 2.createConfigurationContext
- (二)获取Locale
- (三)Locale.getDefault()
- (四)WebView的坑
- 三.实践
Android系统支持多种语言的切换,可以是系统级别的,也可以是应用级别的。
一.系统设置
系统语言的设置在手机设置页面的语言中选中即可。
在应用中如果想要获取到系统当前语言Locale,可以用该方法。
val locale = if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {Resources.getSystem().configuration.locales[0]
} else {Resources.getSystem().configuration.locale
}
这里有一个API版本的区分,从N(24)开始,支持设置多个locale,不过一般用不到。
二.应用级设置
Android更新应用内的Locale,是通过context的resource更新的,而Application的resource和所有Activity的resource是不同的两个资源对象,也就是说所有Activity的resource共享一个对象(一份配置),Application的是单独的一份配置,这也就表示了我们使用这两种context获取或更新Locale时,会出现差异性:一个更新了一个没更新。
由于我们在获取Locale时,无法保证使用Application的context还是Activity的context,所以需要我们在更新Locale时,将两种context都更新。
(一)更新Locale
1.updateConfiguration
切换应用的Locale时,通过context设置新的Locale,不同API版本有不同的方法。
fun updLocale(context: Context,newLocale: Locale) {val config = context.resources.configurationif (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {config.setLocales(LocaleList(newLocale))} else {config.setLocale(newLocale)}context.resources.updateConfiguration(config, null)
}
可以看到,通过将新的Locale设置到context的resource. updateConfiguration方法即可实时更新Locale。
但是根据上面说的问题:假如我们使用Application的context更新Locale时,Activity的context不会同步更新,这就会导致我们在后续使用Activity的context.getString()时,使用的Locale还是之前的Locale,造成错误,反之也是一样。
所以通常我们可以在更新Locale时将两种context都更新。
updLocale(context,locale)
updLocale(context.applicationContext,locale)
2.createConfigurationContext
Android中还提供了一个createConfigurationContext方法来更新Locale,并且在API高级别中,废弃了updateConfiguration方法,我们来看看怎么用。
//Activity/Application
override fun attachBaseContext(newBase: Context) {super.attachBaseContext(newBase.createConfigurationContext(newBase.resources.configuration.apply {if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {this.setLocales(LocaleList(locale))} else {this.setLocale(locale)}}))
}
可以看到,该方法其实就是创建了一个Context的包装类,需要在Activity或者Application的attachBaseContext中进行拦截返回。
看到这可以发现,该方法虽然是推荐的API,但是有很大的缺陷:
- 无法实时更新Locale,因为attachBaseContext方法只会在Activity或Application初始化的时候调用一次,之后无法调用。
- API 21-API 25之间,在Activity上可能会失效。
所以实际操作中,感觉并不如updateConfiguration方法好用。
(二)获取Locale
更新Locale后,我们通过context拿到的Locale应该就是更新后的Locale了。
fun getLocale(context: Context) = if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {context.resources.configuration.locales[0]
} else {context.resources.configuration.locale
}
这里同理,context可能是Activity的,也可能是Application的,所以还是那句话,一定要保证上述更新Locale的正确方式。
(三)Locale.getDefault()
这个方法是获取JVM启动时默认的Locale,默认是和系统当前Locale一致,也可以通过Locale.setDefault()设置。
通常在我们手动切换了Locale后,最好通过Locale.setDefault()方法设置一下默认的locale,否则在使用Locale.getDefault()时可能会拿不到当前的Locale。
(四)WebView的坑
参考文章
这里有一个问题,从结果上来说,在Android N(24)开始,由于系统对于WebView的改变,会导致第一次new WebView(context)时,Locale被重置:
- 创建WebView的context无论是Activity的context还是Application的context都会有问题
- 如果第一次创建WebView前,context使用updateConfiguration更新过Locale,则context对应的Locale会重置为变更之前的Locale
- 如果第一次创建WebView前,context使用createConfigurationContext更新过Locale,则conteext对应的Locale不会改变
虽然第3点可以看出createConfigurationContext方法好处,但是鉴于该方法无法实时更新Locale的劣势,还是不太好用。
面对这种情况,我们可以在首次使用WebView后,再通过updateConfiguration方法设置一遍两个context的Locale即可。
三.实践
总结下来,我们想要比较好的实现应用内实时切换Locale,可以通过以下几步:
- 使用updateConfiguration方法更新Locale
- 更新时同时更新Activity的context和Application的context的Locale设置,比如写一个工具类方法收口
- 切换Locale后将新Locale保存到SharedPreference
- Application启动时和BaseActivity初始化(包括onConfigurationChanged())时,设置一遍Locale
- 首次创建WebView后,设置一遍Locale;此处可以尝试在应用初始化的某个时间点,调用
new WebView(context).destroy()
来初始化第一次WebView