替换OpenHarmony系统软键盘_kikakeyboard

时间：2025-05-10

OpenHarmony替换系统软键盘_kikakeyboard

想了解更多关于开源的内容，请访问：

51CTO 鸿蒙开发者社区

https://ost.51cto.com

前言

系统软键盘的替换通常是基于社区提供的kikaInput进行二次开发。目前，kikaInput已经根据不同的系统版本发布了多个相应的版本，用户在进行二次开发时可以根据自己的需求选择适合的版本进行修改。

kikakeyboard 适配PAD

效果

适配前	适配后
OpenHarmony替换系统软键盘_kikakeyboard -鸿蒙开发者社区	OpenHarmony替换系统软键盘_kikakeyboard -鸿蒙开发者社区

设备类型适配

PAD设备基本属于横向类型设备，也就是宽度大于高度，在3.2.3 release的版本上已经做了table类型的适配，但是IDE运行时因为应用无法直接安装，所以无法正确的判别设备的类型，会默认返回default类型设备，所以对于PAD的适配只需要修改程序中设置的设备类型即可。

index.ets

let deviceType = 'tablet'

软键盘高度问题

系统有虚拟操作栏，软键盘从底部弹出，所以底部有些会被虚拟软键盘遮挡。解决方案有两种：1、长按桌面，进行界面设置，开启手势操作，隐藏虚拟操作栏；2、修改软键盘弹窗的显示高度，操作步骤

KeyboardController

var keyHeightRate = 0.51;

说明：keyHeightRate是一个高度比例，0.51就表示占屏幕高度的51%，可以根据设备的实际情况进行调整。

安装

软键盘程序修改后需要重新安装到设备上，由于软键盘程序属于系统应用，并且有签名限制无法直接通过IDE的 run 安装。如何才能正常的安装上软键盘程序呢？

步骤1：修改签名配置

在IDE设置中查找OpenHarmony SDK的位置

步骤2：修改打包签名配置

在SDK的lib中中查找到UnsgnedReleasedProfileTemplate.json文件

替换以下关键信息

distribution-certificate：cer签名配置
bundle-name：应用包名
app-feature：应用级别-ohos_system_app：系统应用
allowed-acls：权限

步骤3：自动签名

步骤4：获取指纹信息

在DevEco Studio 中打开Log 界面，选择HiLog 过滤 “finger” 字符。

进入系统Shell命令行，设置Hilog 等级。

单击Run > Run ‘{模块名称}’ 运行工程中任意HAP包。在运行时会进行HAP包的安装，此时有可能安装不成功报错，是因为我们应用未正确配置导致，但此时我们目的为获取指纹信息，忽略错误。

查看DevEco Studio 的Log 界面，指纹信息已经被打印出来。

假设我们获取到的指纹信息：6828322A055D4DDFA07DCCC78586EA97B5D2AD7D8BD1B3CEFE00EF584904D728

以下步骤的前置条件：

设备通过USB连接PC
PC端已经配置了hdc的环境变量，这是确保脚本可以正常执行的必要条件

步骤5：备份软键盘程序和安装配置文件

执行下面的脚本会将当前设备上的软键盘程序kikaInput.hap和应用安装配置文件。

/com.example.kikakeyboard/kikaInput.hap
/app/install_list_capability.json

hdc file recv /system/app/com.example.kikakeyboard
hdc file recv /system/etc/app
pause

修改install_list_capability.json中的”bundleName”: “com.example.kikakeyboard”,对应的选项，将步骤4中获取到的指纹信息进行替换。

{
"bundleName": "com.example.kikakeyboard",
"singleton": true,
"runningResourcesApply": false,
"associatedWakeUp": false,
"app_signature" : ["6828322A055D4DDFA07DCCC78586EA97B5D2AD7D8BD1B3CEFE00EF584904D728"],
"allowCommonEvent": [],
"allowAppUsePrivilegeExtension": true
},

步骤6：删除设备中的软键盘应用包

执行如下脚本：

hdc shell mount -o remount,rw /
hdc shell rm -rf /system/app/com.example.kikakeyboard/kikaInput.hap
hdc shell reboot
pause

步骤7：替换软键盘应用程序

准备好二次开发并且添加签名的安装包：entry-default-signed.hap

准备好步骤5中修改好了安装配置文件：install_list_capability.json

执行下面脚本：

hdc shell mount -o remount,rw /
hdc file send install_list_capability.json /system/etc/app/install_list_capability.json
hdc file send entry-default-signed.hap /system/app/com.example.kikakeyboard/kikaInput.hap
hdc shell reboot
pause

执行后设备会自动重启，重启成功后就完成了系统软键盘安装包的替换。

备注：步骤6、7可以合并，这样可以减少一次设备重启，但是实践测试发现，步骤6删除旧的软键盘安装包后不重启，步骤7无法执行成功，所以这里进行分开执行。

为了方便执行步骤5~步骤7，相关的脚本已经添加在附件中，解压就可以使用。

文章相关附件可以点击下面的原文链接前往下载：

https://ost.51cto.com/resource/3105