Android的語言設置
https://blog.csdn.net/seker_xinjian/archive/2011/03/30/6288957.aspx. 以避免版權糾紛!
本文中涉及的代碼所對應的Android Source版本為2.3.3,代號Gingerbread.
這兩天在調查Android係統Setting程序中對於語言設置這塊的內容。具體位置有以下兩處:
1)、設置顯示語言:Settings -> Language & keyboard -> Select language
2)、設置輸入語言:Settings -> Language & keyboard -> Android keyboard [settings] -> Input languages
Settings工程中,Settings -> Language & keyboard界麵所對應的Java代碼和Preference布局如下:
<android_root>/packages/apps/Settings/src/com/android/settings/LanguageSettings.java
<android_root>/packages/apps/Settings/res/xml/language_settings.xml
1、Settings -> Language & keyboard -> Select language
在<android_root>/packages/apps/Settings/res/xml/language_settings.xml中,該模塊的Preference布局為:
- <PreferenceScreen
- android:key="phone_language"
- android:title="@string/phone_language">
- <intent android:action="android.intent.action.MAIN"
- android:targetPackage="com.android.settings"
- android:targetClass="com.android.settings.LocalePicker"/>
- </PreferenceScreen>
所以,當用戶點擊“Settings -> Language & keyboard -> Select language”時,將啟動“com.android.settings.LocalePicker”的Activity。其對應的源代碼為:
<android_root>/packages/apps/Settings/src/com/android/settings/LocalePicker.java
LocalePicker Activity繼承自ListActivity。在它的onCreate()回調中,調用了下麵一條語句:
String[] locales = getAssets().getLocales();
LocalePicker Activity將取得的locale字符串進行了一些處理,然後創建了ArrayAdapter<Loc> adapter,並綁定到ListActivity的ListView上。當用戶點擊ListView上的Item時,再將選中的locale信息設置到Android係統中。
- @Override
- protected void onListItemClick(ListView l, View v, int position, long id) {
- try {
- IActivityManager am = ActivityManagerNative.getDefault();
- Configuration config = am.getConfiguration();
- Loc loc = mLocales[position];
- config.locale = loc.locale;
- // indicate this isn't some passing default - the user wants this remembered
- config.userSetLocale = true;
- am.updateConfiguration(config);
- // Trigger the dirty bit for the Settings Provider.
- BackupManager.dataChanged("com.android.providers.settings");
- } catch (RemoteException e) {
- // Intentionally left blank
- }
- finish();
- }
2、Settings -> Language & keyboard -> Android keyboard [settings] -> Input languages
在<android_root>/packages/apps/Settings/res/xml/language_settings.xml中,找不到輸入法相關的布局內容。但是,可以在<android_root>/packages/apps/Settings/src/com/android/settings/LanguageSettings.java中找到一個onCreateIMM()函數,它在onCreate()回調中被調用。它的作用就是通過InputMethodManager類的getInputMethodList() API獲得當前係統已安裝的輸入法列表,然後逐個地動態生成Preference布局,追加加到設置界麵上。
事實上,Gingerbread默認的有三種輸入法:英文,中文,日文。對應的工程代碼路徑為:
<android_root>/packages/inputmethods/LatinIME/
<android_root>/packages/inputmethods/OpenWnn/
<android_root>/packages/inputmethods/PinyinIME/
通過Log,可以發現,當點擊 Android keyboard [settings] 菜單項時,將會啟動一個Activity:com.android.inputmethod.latin/com.android.inputmethod.latin.LatinIMESettings。因此可以斷定<android_root>/packages/inputmethods/LatinIME/就是我們要找的Android keyboard [settings]輸入法的源代碼工程。
通過<android_root>/packages/inputmethods/LatinIME/java/AndroidManifest.xml,可以找到這個Activity和布局是:
<android_root>/packages/inputmethods/LatinIME/java/src/com/android/inputmethod/latin/LatinIMESettings.java
<android_root>/packages/inputmethods/LatinIME/java/res/xml/prefs.xml
最後綜合可以判定Settings -> Language & keyboard -> Android keyboard [settings] -> Input languages對應的代碼是:
<android_root>/packages/inputmethods/LatinIME/java/src/.../latin/InputLanguageSelection.java
InputLanguageSelection繼承自PreferenceActivity,它有一個getUniqueLocales()函數,在這個函數中,它如同<android_root>/packages/apps/Settings/src/com/android/settings/LocalePicker.java一樣,調用了下麵的語句:
String[] locales = getAssets().getLocales();
然後InputLanguageSelection Activity將取得的locale字符串進行了一些處理,然後循環最終的Locale列表,逐個的為每種語言動態生成CheckBoxPreference加載到InputLanguageSelection的畫麵上。當用戶選中語言,退出InputLanguageSelection Activity時,這些選中的語言就會被保存到SharedPreferences中去。
到此,可以看到以上這兩處的做法都是使用Activity的getAssets()方法取得AssetManager的實例,然後調用AssetManager的getLocales()函數取得係統所支持的語言。然後經過自己的一些過濾辦法,最終顯示在UI界麵。
然而,對於AssetManager究竟是如何取得係統所支持的語言的呢?這需要追究AssetManager更底層的實現了。本文主要是追蹤用AssetManager類的getLocales() API的底層實現。
1)、Java Framework層
AssetManager類的代碼路徑為:
<android_root>/frameworks/base/core/java/android/content/res/AssetManager.java
它的getLocales() API定義如下:
- /**
- * Get the locales that this asset manager contains data for.
- */
- public native final String[] getLocales();
可見這個API雖然定義在Java Framework層,但是它的實現是有Native層的代碼實現的。
2)、JNI層
JNI層的代碼路徑為:
<android_root>/frameworks/base/core/jni/android_util_AssetManager.cpp
函數定義, JNINativeMethod 定義,JNI函數注冊分別如下:
- static jobjectArray android_content_AssetManager_getLocales(JNIEnv* env, jobject clazz);
- { "getLocales", "()[Ljava/lang/String;", (void*) android_content_AssetManager_getLocales },
- AndroidRuntime::registerNativeMethods(env, "android/content/res/AssetManager", gAssetManagerMethods, NELEM(gAssetManagerMethods));
從android_content_AssetManager_getLocales()函數的定義中看出 獲取係統係統所支持的語言的功能是由AssetManager類來實現的
3)、Native lib層
AssetManager類的代碼路徑如下:
<android_root>/frameworks/base/include/utils/AssetManager.h
<android_root>/frameworks/base/libs/utils/AssetManager.cpp
函數聲明和定義如下:
- /**
- * Get the known locales for this asset manager object.
- */
- void getLocales(Vector<String8>* locales) const;
- void AssetManager::getLocales(Vector<String8>* locales) const
- {
- ResTable* res = mResources;
- if (res != NULL) {
- res->getLocales(locales);
- }
- }
可見,真正的實現部分由更底層的ResTable類來實現的。
ResTable類的代碼路徑如下:
<android_root>/frameworks/base/include/utils/ResourceTypes.h
<android_root>/frameworks/base/libs/utils/ResourceTypes.cpp
相關的函數有四個:
- void getLocales(Vector<String8>* locales) const;
- void getConfigurations(Vector<ResTable_config>* configs) const;
- // 這兩個函數從一個Vector<PackageGroup*>的數據結構中解析出係統支持的語言的code。
- status_t parsePackage(const ResTable_package* const pkg, const Header* const header);
- status_t add(const void* data, size_t size, void* cookie, Asset* asset, bool copyData=false);
- // 這兩個函數初始化好Vector<PackageGroup*>的數據結構。
到此,已經可以看到了AssetManager.java類在底層是如何一步步的實現的。但是最終我們的問題的落在了ResTable類何時被初始化,何時調用它的add()函數的問題上。
最後更新:2017-04-03 12:55:41