Android的语言设立

Android的语言设置

原始出处为http://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界面。

 

 这两天在调查Android系统Setting程序中对于语言设置这块的内容。具体位置有以下两处：

                1）、设置显示语言：Settings -> Language & keyboard -> Select language 

                2）、设置输入语言：Settings -> Language & keyboard -> Android keyboard [settings] -> Input languages

 

        这两处都是使用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()函数的问题上。