Android PinyinIME 源码笔记 -- 附A.1 输入法的启动

转自：http://blog.sina.com.cn/funyoung

在Android官方Blog介绍了Android平台输入法的生命周期，如下图

（图片来自http://android-developers.blogspot.com/search/label/Input%20methods）

当一个可编辑的文本框获得焦点时，系统就会启动当前输入法，首先调用当前输入法的onCreate()函数。

Android系统的输入法通常都派生自基类android.inputmethodservice.InputMethodService，基类InputMethodService定义了Android输入法的公共API集合，其中onCreate就是其中的一个API函数。各个具体的输入法实现根据需要重载实现这些API的全部或者一部分。

Android SDK提供了一个最简单的输入法示例，SoftKeyboard ，这个示例可以在SDK安装目录下samples/plaform-X下找到（其中X为SDK的API level数，如cupcake为3，donut为4，froyo为8）。SoftKeyboard 的onCreate()函数代码如下：

    @Override public void onCreate() {

        super.onCreate();

        mWordSeparators = getResources().getString(R.string.word_separators);

    }

除了简单调用父类的同名函数外，从资源文件中读出单词分隔符的串并保存在成员变量里。每个输入法在被创建时要进行的初始化不尽相同。如Android源代码树在packags/inputmethods子目录下还有其它具体的输入法实例。（参考文档http://android.git.kernel.org/?p=platform/packages/inputmethods/LatinIME.git;a=tree）可以把Android源码取到本地计算机，还可以在线浏览另一个输入法实例LatinIME的onCreate()函数，它要做的工作就复杂得多：创建键盘，读取系统信息，注册系统铃声变化的监听器等等。

回来PinyinIME（也在Android源码的packags/inputmethods下）的onCreate()函数，省略掉与LatinIME类似的代码。

    @Override

    public void onCreate() {

        ...

        startPinyinDecoderService();

        ...

    }

函数startPinyinDecoderService（）检测PinyinDecoderService服务如果未运行，则通过系统函数bindService（）来启动它。bindService的第2个参数对象有2个成员函数会在PinyinDecoderService服务启动过程中被调用：

onServiceConnected()    -- PinyinDecoderService建立，PinyinDecoderService.onBind()返回的binder对象作为函数的第2个参数传入。

onServiceDisconnected() -- PinyinDecoderService结束。

关于bindService()的第2个参数以及其在进程间调用的作用可参见http://developer.android.com/guide/developing/tools/aidl.html，在PinyinIME中，它是ServiceConnection接口的一个实现，onServiceDisconnected（）什么都不用做，onServiceConnected()在PinyinDecoderService建立时被调用，远程service进程的binder对象作为函数的第2个参数传入。输入法作为客户端进程，需要借助以下辅助函数把传入的binder对象转化成可用的接口：

IPinyinDecoderService.Stub.asInterface（）

PinyinIME输入法把转化后的接口对象保存在类DecodingInfo对象mDecInfo的mIPinyinDecoderService成员，以供其后的调用：

    public class PinyinDecoderServiceConnection implements ServiceConnection {

        public void onServiceConnected(ComponentName name, IBinder service) {

            mDecInfo.mIPinyinDecoderService = IPinyinDecoderService.Stub

                    .asInterface(service);

        }

        ....

    }

mDecInfo.mIPinyinDecoderService的声明如下：

    public class DecodingInfo {

        ......

        

        private IPinyinDecoderService mIPinyinDecoderService;

        ......

    }

现在再来看在输入法（客户端进程）调用bindService时，服务端进程启动的详细过程：

因为第1个参数Intent对象的类名在调用前被设成PinyinDecoderService.class，所以系统进程响应bindService时，如果服务未运行时首先调用PinyinDecoderService的onCreate()

    @Override

    public void onCreate() {

        super.onCreate();

        mUsr_dict_file = getFileStreamPath("usr_dict.dat").getPath();

        ......

        initPinyinEngine();

    }

接下来调用PinyinDecoderService的onBind()函数，并把返回的binder对象传给前面说过的ServiceConnection.onServiceConnected():

    @Override

    public IBinder onBind(Intent intent) {

        return mBinder;

    }

辅助的初始化函数initPinyinEngine（）首先打算系统静态字典资源文件res/raw/dict_pinyin.dat，然后把用户字典名写到一个byte数组里，最后把静态字典文件信息与用户字典名作为参数，调用本地c/c++函数nativeImOpenDecoderFd（）。

onBind函数返回的binder对象，就是

private final IPinyinDecoderService.Stub mBinder = new IPinyinDecoderService.Stub() {

    ....

};