Kika输入法应用
介绍
本示例使用inputMethodEngine实现一个轻量级输入法应用kikaInput,支持在运行OpenHarmony OS的智能终端上。
效果预览
| 主键盘 | 菜单 | 编辑 | 预上屏 |
|---|---|---|---|
![]() |
![]() |
![]() |
![]() |
使用说明
1.使用hdc shell aa start ability -a InputMethod -b cn.openharmony.inputmethodchoosedialog命令拉起切换输入法弹窗,点击kikainput切换输入法到当前应用。
2.点击应用中的编辑框,拉起输入法键盘。
3.点击键盘可以在编辑框中输入内容,点击回退键可以删除文本。
4.点击左上角的键盘图标可以进入二级菜单,当前只有编辑菜单。
5.点击编辑可以进入编辑状态,点击方向键可以移动光标。
6.编辑状态点击选择按钮,进入选择状态,点击方向键可以选中文本。
预上屏应用使用说明 1.安装应用,首页点击kikainput切换输入法到当前应用; 2.文本框中输入预上屏触发字符'hel',触发输入法预上屏; 3.点击输入法的回车键,确认预上屏内容'hello world'替换文本框中的'hel'; 注:上屏的内容后继续输入字符a,hello world被替换,就是没有确认上屏,否则呈现内容是hello worlda的话就是内容已经确认预上屏。
工程目录
KikaInput
├── AppScope
│ └── app.json5 //APP信息配置文件
├── entry/src/main //应用首页
│ ├── ets
│ │ ├── Application
│ │ ├── common
│ │ │ ├── StyleConfiguration.ets //适配不同设备下的键盘布局
│ │ ├── components //输入法软键盘自定义组件
│ │ ├── entryability //应用入口
│ │ │ ├── EntryAbility.ets //应用入口Ability
│ │ ├── pages
│ │ │ ├── Index.ets //输入法主页
│ │ │ ├── PrivatePreview.ets //预上屏主页
│ │ ├── model
│ │ │ ├── HardKeyUtils.ets //外接键盘KeyCode数据
│ │ │ ├── KeyboardController.ets //输入法键盘控制
│ │ │ ├── KeyboardKeyData.ets //输入法键盘数据
│ │ ├── ServiceExtAbility
│ │ │ ├── ServiceExtAbility.ets //输入法Ability
│ └── module.json5
具体实现
- 该示例分为两个模块:
- 键盘布局
- 在Index中完成键盘的总体布局。在components中自定不同的按键组件。
- 源码链接:Index.ets,components
- 参考接口:ArkTs声明式开发范式
- 输入法控制
- 使用@ohos.request中API 10接口agent.create创建上传任务,调用@ohos.request中的Task相关接口实现上传任务的创建、取消、进度加载,前台任务只支持单文件下载,后台任务支持多文件下载。使用@ohos.file.fs完成指定路径的创建和查询已下载的文件。
- 源码链接:KeyboardController.ets
- 参考接口:@ohos.inputMethodEngine
- 键盘布局
相关权限
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED
ohos.permission.START_ABILITIES_FROM_BACKGROUND
依赖
不涉及。
约束与限制
1.本示例仅支持标准系统上运行。
2.本示例适配API12版本SDK,SDK版本号(API Version 12 Release),镜像版本号(5.0.0.25及以后版本)。
3.本示例需要使用DevEco Studio 版本号(4.1 Release)及以上版本才可编译运行。
5.本示例需要使用@ohos.application.InputMethodExtensionAbility系统权限的系统接口。使用Full SDK时需要手动从镜像站点获取,并在DevEco Studio中替换,具体操作可参考替换指南。
6.如果安装本示例报错为error:install sign info inconsistent,则有可能是应用已安装在系统中,此时需要卸载安装的应用,并替换安装,具体命令如下:
hdc uninstall com.samples.kikainputmethod
hdc install ./kikaInputMethod.hap
hdc shell aa start ability -a InputMethod -b cn.openharmony.inputmethodchoosedialog
在拉起的输入法弹窗中,点击kikainput切换输入法到当前应用。
下载
如需单独下载本工程,执行如下命令:
git init
git config core.sparsecheckout true
echo code/Solutions/InputMethod/KikaInputMethod/ > .git/info/sparse-checkout
git remote add origin https://gitee.com/openharmony/applications_app_samples.git
git pull origin master



