学步园

译自[url]http://android-developers.blogspot.com/2009/04/creating-input-method.html[/url]
by Fly Fire  如需转载，请注明来源 [url]www.yddev.com[/url]

一.
1.创建一个新的输入法需要继承android.inputmethodservice.InputMethodService，这个类提供了一个输入法
的基本实现，例子可以参考sdk中的SoftKeyboard的代码。

2.输入法跟其他application或service一样会被打包成一个apk,在 AndroidManifest.xml，把它声明成一个
service.[code]<manifest xmlns:android="http://schemas.android.com/apk/res/android"
        package="com.example.fastinput">

    <application android:label="@string/app_label">

        <!-- Declares the input method service -->
        <service android:name="FastInputIME"
            android:label="@string/fast_input_label"
            android:permission="android.permission.BIND_INPUT_METHOD">
            <intent-filter>
                <action android:name="android.view.InputMethod" />
            </intent-filter>
            <meta-data android:name="android.view.im" android:resource="@xml/method" />
        </service>

        <!-- Optional activities. A good idea to have some user settings. -->
        <activity android:name="FastInputIMESettings" android:label="@string/fast_input_settings">
            <intent-filter>
                <action android:name="android.intent.action.MAIN"/>
            </intent-filter>
        </activity>
    </application>
</manifest>[/code]3.输入法的service生命周期如下
[img]https://docs.google.com/a/google.com/File?id=ad9xdxhtb4_043qn7phd_b[/img]

二.输入法界面元素

输入法有2个主要的界面元素，InputView与Candidates View。
InputView：是用户输入文字的地方，当输入法被显示的时候会调用InputMethodService.onCreateInputView()
，在这个函数里创建和返回你想在输入法窗口中显示的Input View.
Candidates View:是用来提供输入选择，在函数InputMethodService.onCreateCandidatesView()中创建，默认
为空。

三.设计不同的输入类型
  一个程序的文本框可能有不同的输入类型，比如字符，数字,url,email地址等，当你实现一种输入法的时候你
就需要知道不同输入方式的区别，输入法不会自动根据不同的输入类型来切换，所以你的输入法需要支持所有的
输入类型。至于输入数据的验证就交由应用程序去负责。

例如，Android中一个Latin输入法提供的字符与数字输入的界面：
[img]https://docs.google.com/a/google.com/File?id=ddvqp2ns_18g2nm5jhb_b[/img]

[img]https://docs.google.com/a/google.com/File?id=ddvqp2ns_17crk39fd9_b[/img]

调用InputMethodService.onStartInputView()的时候会传递一个 EditorInfo对象来判断输入类型。
例如使用(EditorInfo.inputType & EditorInfo.TYPE_CLASS_MASK)来判断是属于下面的哪种类型：
TYPE_CLASS_NUMBER
TYPE_CLASS_DATETIME
TYPE_CLASS_PHONE
TYPE_CLASS_TEXT

  密码输入：注意不要在你的界面中显示密码，除了提醒用户外也不要把密码保存起来。

四.把输入文本传送给应用程序
   1.可以发送一个key event来实现[code]InputConnection ic = getCurrentInputConnection();
long eventTime = SystemClock.uptimeMillis();
ic.sendKeyEvent(new KeyEvent(eventTime, eventTime,
    KeyEvent.ACTION_DOWN, keyEventCode, 0, 0, 0, 0,
    KeyEvent.FLAG_SOFT_KEYBOARD|KeyEvent.FLAG_KEEP_TOUCH_MODE));
ic.sendKeyEvent(new KeyEvent(SystemClock.uptimeMillis(), eventTime,
    KeyEvent.ACTION_UP, keyEventCode, 0, 0, 0, 0,
   
KeyEvent.FLAG_SOFT_KEYBOARD|KeyEvent.FLAG_KEEP_TOUCH_MODE));[/code]或者
[code]InputMethodService.sendDownUpKeyEvents(keyEventCode);[/code]建议对于一些
输入模式使用第一种方法，因为有些按键可能被过滤。

   2.通过编辑输入文本，主要使用以下方法。[code]getTextBeforeCursor()
getTextAfterCursor()
deleteSurroundingText()
commitText()[/code]比如，一个以Fell开头的文本，你想把它替换成Hello![code]InputConnection ic = getCurrentInputConnection();
ic.deleteSurroundingText(4, 0);
ic.commitText("Hello", 1);
ic.commitText("!", 1);[/code]五.联想输入
  如果你需要联想输入或者输入过程中动态预测输入的文本，你可以参考如下代码：[code]InputConnection ic = getCurrentInputConnection();
ic.setComposingText("Composi", 1);
...
ic.setComposingText("Composin", 1);
...
ic.commitText("Composing ", 1);[/code][img]https://docs.google.com/a/google.com/File?id=ddvqp2ns_0g2z84dg2_b[/img]

[img]https://docs.google.com/a/google.com/File?id=ddvqp2ns_1jnw696d3_b[/img]

[img]https://docs.google.com/a/google.com/File?id=ddvqp2ns_2crrwtbf7_b[/img]

六.拦截硬件按键消息
尽管输入法窗口没有foucs，但是它最先收到硬件的按键消息，如果需要处理这些硬件按键消息，你只需要
重写InputMethodService.onKeyDown() 与InputMethodService.onKeyUp()，如果你不想处理某个按键，记得调
用super.onKey* 。

七.其他注意点
   1.提供一个用户可以直接从当前输入法进行相关输入法设置的方式。
   2.提供一个用户可以切换不同输入法的方式。
   3.让输入法界面尽快的弹出，资源或者耗时长的操作可以稍后加载。
   4.当输入法窗口被隐藏的时候，大块的内存分配最好尽快释放
   5.确保输入法能包含最常用的字符。

八.例子：
可以参考LatinIME的例子:
[url=http://android.git.kernel.org/?p=platform/packages/inputmethods/LatinIME.git;a=tree]http://android.git.kernel.org/?p=platform/packages/inputmethods/LatinIME.git;a=tree[/url]
或者1.5 SDK也提供了一个SoftKeyboard的例子。

Terry
发表于 2009-4-25 03:21

这是1.5版核心的输入吗？挺不错的

fly_fire
发表于 2009-4-25 09:37

[quote]这是1.5版核心的输入吗？挺不错的
[size=2][color=#999999]Terry 发表于 2009-4-25 03:21[/color]
[url=http://yddev.com/bbs/redirect.php?goto=findpost&pid=96&ptid=63][img]http://yddev.com/bbs/images/common/back.gif[/img][/url][/size][/quote]

对，这是基于1.5的输入法框架创建新的输入法。。

yantao821015
发表于 2009-7-22 16:54

如何通过API去设置当前输入法呢？
我看了下setting的代码，他是用
Settings.Secure.putString(getContentResolver(),
            Settings.Secure.ENABLED_INPUT_METHODS, builder.toString());
但是，在SDK文档中明确指出，该设置只能读，不能写。郁闷了。。。
高人给指点一下

http://www.yddev.com/bbs/viewthread.php?tid=63

softkeyboard