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() {

             ...

             startPinyinDecoderServic e();

             ...

       }

函数startPinyinDecoderServic e（）检测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 PinyinDecoderServiceConn ection 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() {

       ....

};