私のアプリは3(まもなく4)言語をサポートします。いくつかのロケールは非常に似ているため、アプリケーションでロケールを変更するオプションをユーザーに提供したいと思います。たとえば、イタリア人は英語よりスペイン語を好むかもしれません。
ユーザーがアプリケーションで使用可能なロケールの中から選択し、使用するロケールを変更する方法はありますか?基本クラスで実行するのは簡単なタスクであるため、各アクティビティのロケールを設定することは問題とは思いません。
configuration.locale
はAPI 24から非推奨になったため、この回答を引き続き探している人のために、以下を使用できます。
configuration.setLocale(locale);
このメソッドのminSkdVersionがAPI 17であることを考慮してください。
完全なサンプルコード:
@SuppressWarnings("deprecation")
private void setLocale(Locale locale){
SharedPrefUtils.saveLocale(locale); // optional - Helper method to save the selected language to SharedPreferences in case you might need to attach to activity context (you will need to code this)
Resources resources = getResources();
Configuration configuration = resources.getConfiguration();
DisplayMetrics displayMetrics = resources.getDisplayMetrics();
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.JELLY_BEAN_MR1){
configuration.setLocale(locale);
} else{
configuration.locale=locale;
}
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N){
getApplicationContext().createConfigurationContext(configuration);
} else {
resources.updateConfiguration(configuration,displayMetrics);
}
}
実行中のアクティビティでロケールを変更した場合、変更を有効にするには再起動する必要があることを忘れないでください。
2018年5月11日編集
@CookieMonsterの投稿からわかるように、上位のAPIバージョンではロケールの変更を維持するのに問題があるかもしれません。その場合、次のコードを基本アクティビティに追加して、アクティビティの作成ごとにコンテキストロケールを更新します。
@Override
protected void attachBaseContext(Context base) {
super.attachBaseContext(updateBaseContextLocale(base));
}
private Context updateBaseContextLocale(Context context) {
String language = SharedPrefUtils.getSavedLanguage(); // Helper method to get saved language from SharedPreferences
Locale locale = new Locale(language);
Locale.setDefault(locale);
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {
return updateResourcesLocale(context, locale);
}
return updateResourcesLocaleLegacy(context, locale);
}
@TargetApi(Build.VERSION_CODES.N)
private Context updateResourcesLocale(Context context, Locale locale) {
Configuration configuration = context.getResources().getConfiguration();
configuration.setLocale(locale);
return context.createConfigurationContext(configuration);
}
@SuppressWarnings("deprecation")
private Context updateResourcesLocaleLegacy(Context context, Locale locale) {
Resources resources = context.getResources();
Configuration configuration = resources.getConfiguration();
configuration.locale = locale;
resources.updateConfiguration(configuration, resources.getDisplayMetrics());
return context;
}
これを使用する場合は、setLocate(locale)
でロケールを設定するときに、言語をSharedPreferencesに保存することを忘れないでください
このヘルプ(onResumeで)を願っています:
Locale locale = new Locale("ru");
Locale.setDefault(locale);
Configuration config = getBaseContext().getResources().getConfiguration();
config.locale = locale;
getBaseContext().getResources().updateConfiguration(config,
getBaseContext().getResources().getDisplayMetrics());
この問題を解決する現在の方法に対する答えは完全ではないので、完全な解決策の指示を与えようとします。何かが足りない場合、または改善できる場合はコメントしてください。
まず、問題を解決したいライブラリがいくつかありますが、それらはすべて古くなっているように見えるか、いくつかの機能が欠落しています。
さらに、ライブラリを書くことは、この問題を解決するための良い/簡単な方法ではないかもしれないと思います。やらなければならないことは、完全に分離されたものを使うよりもむしろ既存のコードを変えることです。したがって、私は以下の指示を作成しました。
私のソリューションは主に https://github.com/gunhansancar/ChangeLanguageExample に基づいています(既に localhost によってリンクされています)。私が見つけた中で最高のコードです。いくつかのコメント:
updateViews()
を使用して、ロケールを変更した後、すべての文字列を手動で更新します(通常のgetString(id)
を使用)。これは以下に示すアプローチでは不要です。選択したロケールを保持する部分を切り離し、少し変更しました(以下に示すように、個別にそれを行いたい場合があります)。
ソリューションは、次の2つのステップで構成されます。
gunhansancarのLocaleHelper に基づいて、クラスLocaleHelper
を使用します。
ListPreference
を使用可能な言語でPreferenceFragment
に追加します(言語を後で追加する必要がある場合は維持する必要があります)import Android.annotation.TargetApi;
import Android.content.Context;
import Android.content.SharedPreferences;
import Android.content.res.Configuration;
import Android.content.res.Resources;
import Android.os.Build;
import Android.preference.PreferenceManager;
import Java.util.Locale;
import mypackage.SettingsFragment;
/**
* Manages setting of the app's locale.
*/
public class LocaleHelper {
public static Context onAttach(Context context) {
String locale = getPersistedLocale(context);
return setLocale(context, locale);
}
public static String getPersistedLocale(Context context) {
SharedPreferences preferences = PreferenceManager.getDefaultSharedPreferences(context);
return preferences.getString(SettingsFragment.KEY_PREF_LANGUAGE, "");
}
/**
* Set the app's locale to the one specified by the given String.
*
* @param context
* @param localeSpec a locale specification as used for Android resources (NOTE: does not
* support country and variant codes so far); the special string "system" sets
* the locale to the locale specified in system settings
* @return
*/
public static Context setLocale(Context context, String localeSpec) {
Locale locale;
if (localeSpec.equals("system")) {
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {
locale = Resources.getSystem().getConfiguration().getLocales().get(0);
} else {
//noinspection deprecation
locale = Resources.getSystem().getConfiguration().locale;
}
} else {
locale = new Locale(localeSpec);
}
Locale.setDefault(locale);
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {
return updateResources(context, locale);
} else {
return updateResourcesLegacy(context, locale);
}
}
@TargetApi(Build.VERSION_CODES.N)
private static Context updateResources(Context context, Locale locale) {
Configuration configuration = context.getResources().getConfiguration();
configuration.setLocale(locale);
configuration.setLayoutDirection(locale);
return context.createConfigurationContext(configuration);
}
@SuppressWarnings("deprecation")
private static Context updateResourcesLegacy(Context context, Locale locale) {
Resources resources = context.getResources();
Configuration configuration = resources.getConfiguration();
configuration.locale = locale;
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.JELLY_BEAN_MR1) {
configuration.setLayoutDirection(locale);
}
resources.updateConfiguration(configuration, resources.getDisplayMetrics());
return context;
}
}
次のようなSettingsFragment
を作成します。
import Android.content.SharedPreferences;
import Android.os.Bundle;
import Android.preference.PreferenceFragment;
import Android.preference.PreferenceManager;
import Android.view.LayoutInflater;
import Android.view.View;
import Android.view.ViewGroup;
import mypackage.LocaleHelper;
import mypackage.R;
/**
* Fragment containing the app's main settings.
*/
public class SettingsFragment extends PreferenceFragment implements SharedPreferences.OnSharedPreferenceChangeListener {
public static final String KEY_PREF_LANGUAGE = "pref_key_language";
public SettingsFragment() {
// Required empty public constructor
}
@Override
public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
addPreferencesFromResource(R.xml.preferences);
}
@Override
public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) {
View view = inflater.inflate(R.layout.fragment_settings, container, false);
return view;
}
@Override
public void onSharedPreferenceChanged(SharedPreferences sharedPreferences, String key) {
switch (key) {
case KEY_PREF_LANGUAGE:
LocaleHelper.setLocale(getContext(), PreferenceManager.getDefaultSharedPreferences(getContext()).getString(key, ""));
getActivity().recreate(); // necessary here because this Activity is currently running and thus a recreate() in onResume() would be too late
break;
}
}
@Override
public void onResume() {
super.onResume();
// documentation requires that a reference to the listener is kept as long as it may be called, which is the case as it can only be called from this Fragment
getPreferenceScreen().getSharedPreferences().registerOnSharedPreferenceChangeListener(this);
}
@Override
public void onPause() {
super.onPause();
getPreferenceScreen().getSharedPreferences().unregisterOnSharedPreferenceChangeListener(this);
}
}
次の方法で利用可能な翻訳を含むすべてのロケールをリストするリソースlocales.xml
を作成します( ロケールコードのリスト ):
<!-- Lists available locales used for setting the locale manually.
For now only language codes (locale codes without country and variant) are supported.
Has to be in sync with "settings_language_values" in strings.xml (the entries must correspond).
-->
<resources>
<string name="system_locale" translatable="false">system</string>
<string name="default_locale" translatable="false"></string>
<string-array name="locales">
<item>@string/system_locale</item> <!-- system setting -->
<item>@string/default_locale</item> <!-- default locale -->
<item>de</item>
</string-array>
</resources>
PreferenceScreen
では、次のセクションを使用して、ユーザーに使用可能な言語を選択させることができます。
<PreferenceScreen xmlns:Android="http://schemas.Android.com/apk/res/Android">
<PreferenceCategory
Android:title="@string/preferences_category_general">
<ListPreference
Android:key="pref_key_language"
Android:title="@string/preferences_language"
Android:dialogTitle="@string/preferences_language"
Android:entries="@array/settings_language_values"
Android:entryValues="@array/locales"
Android:defaultValue="@string/system_locale"
Android:summary="%s">
</ListPreference>
</PreferenceCategory>
</PreferenceScreen>
strings.xml
の次の文字列を使用します:
<string name="preferences_category_general">General</string>
<string name="preferences_language">Language</string>
<!-- NOTE: Has to correspond to array "locales" in locales.xml (elements in same orderwith) -->
<string-array name="settings_language_values">
<item>Default (System setting)</item>
<item>English</item>
<item>German</item>
</string-array>
次に、カスタムロケールセットを使用するように各アクティビティを設定します。これを達成する最も簡単な方法は、次のコード(すべてのアクティビティに共通の基本クラスを使用することです(重要なコードはattachBaseContext(Context base)
およびonResume()
にあります)):
import Android.content.Context;
import Android.content.Intent;
import Android.content.pm.PackageInfo;
import Android.content.pm.PackageManager;
import Android.os.Bundle;
import Android.support.annotation.Nullable;
import Android.support.v7.app.AppCompatActivity;
import Android.view.Menu;
import Android.view.MenuInflater;
import Android.view.MenuItem;
import mypackage.LocaleHelper;
import mypackage.R;
/**
* {@link AppCompatActivity} with main menu in the action bar. Automatically recreates
* the activity when the locale has changed.
*/
public class MenuAppCompatActivity extends AppCompatActivity {
private String initialLocale;
@Override
protected void onCreate(@Nullable Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
initialLocale = LocaleHelper.getPersistedLocale(this);
}
@Override
public boolean onCreateOptionsMenu(Menu menu) {
MenuInflater inflater = getMenuInflater();
inflater.inflate(R.menu.menu, menu);
return true;
}
@Override
public boolean onOptionsItemSelected(MenuItem item) {
switch (item.getItemId()) {
case R.id.menu_settings:
Intent intent = new Intent(this, SettingsActivity.class);
startActivity(intent);
return true;
default:
return super.onOptionsItemSelected(item);
}
}
@Override
protected void attachBaseContext(Context base) {
super.attachBaseContext(LocaleHelper.onAttach(base));
}
@Override
protected void onResume() {
super.onResume();
if (initialLocale != null && !initialLocale.equals(LocaleHelper.getPersistedLocale(this))) {
recreate();
}
}
}
それは何ですか
attachBaseContext(Context base)
をオーバーライドして、以前にLocaleHelper
で永続化されたロケールを使用しますアクティビティを再作成しても、ActionBarのタイトルは更新されません(既に確認されているように、 https://github.com/gunhansancar/ChangeLanguageExample/issues/1 )。
setTitle(R.string.mytitle)
メソッドにonCreate()
を含めるだけで実現できます。これにより、ユーザーはシステムのデフォルトロケールとアプリのデフォルトロケール(この場合は「英語」)を選択できます。
これまでのところ、言語コードのみがサポートされ、地域(国)とバリアントコード(fr-rCA
など)はサポートされていません。完全なロケール仕様をサポートするには、 Android-Languagesライブラリ のパーサーと同様のパーサーを使用できます(地域をサポートしていますが、バリアントコードはサポートしていません)。
Android OS N以降のデバイスでロケールをプログラムで設定する際に問題が発生しました。私にとっての解決策は、基本アクティビティでこのコードを書くことでした。
(基本アクティビティがない場合は、すべてのアクティビティでこれらの変更を行う必要があります)
@Override
protected void attachBaseContext(Context base) {
super.attachBaseContext(updateBaseContextLocale(base));
}
private Context updateBaseContextLocale(Context context) {
String language = SharedPref.getInstance().getSavedLanguage();
Locale locale = new Locale(language);
Locale.setDefault(locale);
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {
return updateResourcesLocale(context, locale);
}
return updateResourcesLocaleLegacy(context, locale);
}
@TargetApi(Build.VERSION_CODES.N)
private Context updateResourcesLocale(Context context, Locale locale) {
Configuration configuration = context.getResources().getConfiguration();
configuration.setLocale(locale);
return context.createConfigurationContext(configuration);
}
@SuppressWarnings("deprecation")
private Context updateResourcesLocaleLegacy(Context context, Locale locale) {
Resources resources = context.getResources();
Configuration configuration = resources.getConfiguration();
configuration.locale = locale;
resources.updateConfiguration(configuration, resources.getDisplayMetrics());
return context;
}
ここで呼び出すだけでは十分ではないことに注意してください
createConfigurationContext(configuration)
また、このメソッドが返すコンテキストを取得し、attachBaseContext
メソッドでこのコンテキストを設定する必要があります。
@SuppressWarnings("deprecation")
public static void forceLocale(Context context, String localeCode) {
String localeCodeLowerCase = localeCode.toLowerCase();
Resources resources = context.getApplicationContext().getResources();
Configuration overrideConfiguration = resources.getConfiguration();
Locale overrideLocale = new Locale(localeCodeLowerCase);
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.JELLY_BEAN_MR1) {
overrideConfiguration.setLocale(overrideLocale);
} else {
overrideConfiguration.locale = overrideLocale;
}
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {
context.getApplicationContext().createConfigurationContext(overrideConfiguration);
} else {
resources.updateConfiguration(overrideConfiguration, null);
}
}
特定のロケールを強制するには、このヘルパーメソッドを使用します。
2017年8月22日更新。より良い使用このアプローチ。
次のメソッドでヘルパークラスを追加します。
public class LanguageHelper {
public static final void setAppLocale(String language, Activity activity) {
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.JELLY_BEAN_MR1) {
Resources resources = activity.getResources();
Configuration configuration = resources.getConfiguration();
configuration.setLocale(new Locale(language));
activity.getApplicationContext().createConfigurationContext(configuration);
} else {
Locale locale = new Locale(language);
Locale.setDefault(locale);
Configuration config = activity.getResources().getConfiguration();
config.locale = locale;
activity.getResources().updateConfiguration(config,
activity.getResources().getDisplayMetrics());
}
}
}
スタートアップアクティビティでMainActivity.Java
のように呼び出します:
public void onCreate(Bundle savedInstanceState) {
...
LanguageHelper.setAppLocale("fa", this);
...
}
シンプルで簡単
Locale locale = new Locale("en", "US");
Resources res = getResources();
DisplayMetrics dm = res.getDisplayMetrics();
Configuration conf = res.getConfiguration();
conf.locale = locale;
res.updateConfiguration(conf, dm);
「en」は言語コード、「US」は国コードです。
/**
* Requests the system to update the list of system locales.
* Note that the system looks halted for a while during the Locale migration,
* so the caller need to take care of it.
*/
public static void updateLocales(LocaleList locales) {
try {
final IActivityManager am = ActivityManager.getService();
final Configuration config = am.getConfiguration();
config.setLocales(locales);
config.userSetLocale = true;
am.updatePersistentConfiguration(config);
} catch (RemoteException e) {
// Intentionally left blank
}
}
このコードをアクティビティに追加します
if (id==R.id.uz)
{
LocaleHelper.setLocale(MainActivity.this, mLanguageCode);
//It is required to recreate the activity to reflect the change in UI.
recreate();
return true;
}
if (id == R.id.ru) {
LocaleHelper.setLocale(MainActivity.this, mLanguageCode);
//It is required to recreate the activity to reflect the change in UI.
recreate();
}
API16からAPI28に有効このメソッドを次の場所に配置するだけです。
Context newContext = context;
Locale locale = new Locale(languageCode);
Locale.setDefault(locale);
Resources resources = context.getResources();
Configuration config = new Configuration(resources.getConfiguration());
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.JELLY_BEAN_MR1) {
config.setLocale(locale);
newContext = context.createConfigurationContext(config);
} else {
config.locale = locale;
resources.updateConfiguration(config, resources.getDisplayMetrics());
}
return newContext;
}
以下を使用して、すべてのアクティビティにこのコードを挿入します。
@Override
protected void attachBaseContext(Context base) {
super.attachBaseContext(localeUpdateResources(base, "<-- language code -->"));
}
または、新しいコンテキストが必要なフラグメント、アダプターなどでlocaleUpdateResourcesを呼び出します。
クレジット:Yaroslav Berezanskyi