# hos_next_ime

**Repository Path**: dguru/hos_next_ime

## Basic Information

- **Project Name**: hos_next_ime
- **Description**: 为解决鸿蒙NEXT Beta版开发中模拟器中没有输入法的问题，实现了一个简单中英文输入法。
- **Primary Language**: TypeScript
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 16
- **Forks**: 2
- **Created**: 2024-07-02
- **Last Updated**: 2025-08-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: HarmonyOS, IME

## README

# HarmonyOS NEXT 中文拼音输入法(26键软键盘)

#### 介绍
为解决鸿蒙NEXT Beta版开发中模拟器中没有输入法的问题，实现了一个中文拼音输入法(含英文输入)。


#### 软件架构
采用HarmonyOS NEXT API 12Beta1 中 IME Kit 实现定制输入法。


#### 安装教程

1.  Git 下载项目到 DevEco Studio Next Deveopler Beta1 v5.0.3.403 IDE中；
2.  在 IDE 中开启 HarmonyOS 手机模拟器；
3.  在 IDE 中指定设备为模拟器，直接构建项目并运行在模拟器上；
4.  项目 build-profile.json5 需要自行配置。


#### 使用说明

1.  安装完成后在模拟器上进入系统设置 > 系统 > 输入法；勾选 "IME for HOS NEXT Emulator";
2.  回到安装的应用界面，有文本输入框用于输入法测试，点击输入框即可触发软键盘弹出，进行输入;
3.  在其它需要测试的应用中，点击文本输入类组件即可弹出软键盘进行输入。


#### 实现原理简述
* 基本框架按API 12 IME Kit指南文档的示例搭建；

* 主要修改代码文件：

    1. KeyboardKeyData.ts：输入按键字符数据集；

    2. KeyboardUI.ets：替换原示例中 ets/InputMehotdExtensionAbility/pages/Index.ets 实现软键盘布局及输入逻辑，由KeyboardController.ts 加载；

    3. ets/pages/Index.ets：IDE默认HelloWorld 样板代码，添加TextInput组件作为输入法测试应用界面；


#### 参与贡献

1.  Fork 本仓库
2.  新建 Feat_xxx 分支
3.  提交代码
4.  新建 Pull Request