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布局为：

[java] view

plaincopy

<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一样，调用了下面的语句：

    然后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函数注册分别如下：

[cpp] view

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 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()函数的问题上。