feat: 发布4×4候选与Android手表应用内键盘组件
这个提交包含在：
sydxky 于
1 父节点
82aeeba816
当前提交
87aa966a51
86 个文件已更改
+2697
-2975
没有与搜索条件相匹配的文件
@@ -1,56 +1,85 @@
|
||||
# 蟹蟹输入 · RTOS适配改版
|
||||
|
||||
基于[CrabKeyboard / 蟹蟹输入](https://github.com/crabPangXie/crabKeyboard)的独立Glyphix RTOS改版，由herry适配。不是上游原版，不表示上游或设备厂商背书。
|
||||
|
||||
**MIT开源，允许商用、修改、再分发和闭源集成。** 请保留版权及许可全文；[LICENSE](./LICENSE) / [署名与第三方许可](./NOTICE.md)。Remix Icon图标另按Apache-2.0使用，厂商SDK/运行时不包含在本项目MIT授权中。
|
||||
|
||||
|
||||
|
||||
## 功能
|
||||
|
||||
- 浅色满屏键盘，适配圆屏466×466及方屏390×450。
|
||||
- 26键全拼/英文均为标准QWERTY，10/9/7三排；九宫拼音与14键双字母模式。
|
||||
- 14键采用`QW ER TY UI OP / AS DF GH JK L / ZX CV BN M`，参考公开布局，自研离线消歧，保留完整候选及连续输入。
|
||||
- 104,837组拼音/缩写索引、163,238候选项，四项分页，不作100项截断。
|
||||
- 英文大小写、数字、符号、Unicode光标与删除、可选本地学习、私密输入和本机草稿。
|
||||
- 原生`.ux`页面，可通过`router.push`接入其他Glyphix应用；系统级全局输入法注册需厂商支持。
|
||||
|
||||
## 下载与反馈
|
||||
|
||||
- [1.1.0发行版与两屏QuickApp完整包](https://git2.sydxky.cn/herry/crab-input-rtos/releases)
|
||||
- [已有问题与建议](https://git2.sydxky.cn/herry/crab-input-rtos/issues)
|
||||
- [免注册匿名提交问题与建议](https://git2.sydxky.cn/feedback/herry/crab-input-rtos)
|
||||
|
||||
Git2免登录浏览、克隆和下载，当前关闭注册，代码与版本由所有者维护。
|
||||
|
||||
```powershell
|
||||
git clone https://git2.sydxky.cn/herry/crab-input-rtos.git
|
||||
cd crab-input-rtos
|
||||
```
|
||||
|
||||
## 构建
|
||||
|
||||
准备Windows PowerShell 7、Node.js和Python 3。建议克隆到较短路径（例如`F:\Project\crab-input-rtos`），厂商图像工具在过长Windows路径可能失败。厂商Glyphix SDK不随仓库分发；自行取得适用授权后，将含`bin/gx.exe`与`share/`的完整SDK放在`temp/glyphix-v0.7.2-windows-x64/`。本版验证使用`gx v0.10.1 / 3ed38835`，需要`generic-watch-466x466-quickapp`和`generic-watch-390x450-quickapp`配置。
|
||||
|
||||
```powershell
|
||||
& .\com.sydxky.rtos.inputmethod\build.ps1
|
||||
```
|
||||
|
||||
脚本无损生成词库分片，执行40项引擎及29项UX脚本断言，然后构建普通/QuickApp四配置。QuickApp输出位于应用的`.glyphix-work/dist/`，每屏必须保留完整`bundle.pkg`、`icon.png`、`manifest.json`，不是APK/HAP。
|
||||
|
||||
## 原生模拟器复现
|
||||
|
||||
`com.sydxky.rtos.imefixture/`是本仓库附带的最小离线验收页，只用于实际前后台切换，不包含其他内部应用。先构建并启动一次圆屏参考页，获得厂商launcher/global资源，然后退出该模拟器：
|
||||
|
||||
```powershell
|
||||
& .\com.sydxky.rtos.imefixture\build.ps1
|
||||
Push-Location .\com.sydxky.rtos.imefixture
|
||||
& ..\temp\glyphix-v0.7.2-windows-x64\bin\gx.exe emulate -d generic-watch-466x466
|
||||
Pop-Location
|
||||
python .\com.sydxky.rtos.inputmethod\tests\native.py --work work/native --output work/evidence
|
||||
python .\com.sydxky.rtos.inputmethod\tests\visual.py --work work/visual --output work/evidence/visual
|
||||
```
|
||||
|
||||
视觉脚本需要Pillow。运行时保持8192 KiB内存，不接管其他占用Inspector 14201的进程。1.1.0原产品四配置84项原生操作、84项操作后布局、44个视觉状态均通过，见[验收记录](./com.sydxky.rtos.inputmethod/VALIDATION_1.1.0.md)。公开仓库使用最小参考页，已重新完成独立源码四配置构建、84/84原生操作、84/84布局和44/44视觉状态，见[公开树验收](./docs/PUBLIC_RELEASE_1.1.0.md)。
|
||||
|
||||
真机安装、目标固件性能/续航和商店审核尚未验收。详细接入、词库与14键说明见[应用文档](./com.sydxky.rtos.inputmethod/README.md)和[14键算法](./com.sydxky.rtos.inputmethod/KEYBOARD_14.md)。
|
||||
# 蟹蟹输入 · RTOS / Android 手表适配改版
|
||||
|
||||
为小屏手表准备的离线输入组件：大按键、浅色界面、完整候选、圆屏安全布局。基于 [CrabKeyboard / 蟹蟹输入](https://github.com/crabPangXie/crabKeyboard) 的词库，由 herry 重写 Glyphix RTOS 与原生 Android 适配；本项目为独立改版，保留原作者及第三方署名。
|
||||
|
||||
**MIT 开源，允许商用、修改、再分发和闭源集成。** 使用时请保留 [LICENSE](LICENSE) 和 [第三方许可](NOTICE.md)。厂商 SDK、运行时与设备固件不包含在本项目授权中。
|
||||
|
||||
|
||||
|
||||
## 1.2.0 带来了什么
|
||||
|
||||
- 完整候选采用 **4×4 网格，单字 16 项一页**；词组占用更多列，长词增加行高，显示完整文字；展开页不显示拼音。
|
||||
- 标准 **QWERTY 26 键**，排列为 `qwertyuiop / asdfghjkl / zxcvbnm`；同时提供九宫和 14 键双字母模式。
|
||||
- 14 键为 `QW ER TY UI OP / AS DF GH JK L / ZX CV BN M`，参考公开布局，自行实现离线消歧和连续输入；[算法说明](com.sydxky.rtos.inputmethod/KEYBOARD_14.md)。
|
||||
- 保留全部 **104,837 组拼音/缩写索引、163,238 个候选项**。按页浏览全部结果，支持分段选词及剩余编码继续输入。
|
||||
- 英文、数字、符号、光标移动及 Unicode 删除。圆屏每行按安全宽度排布，避免四角按钮被裁切。
|
||||
- 新增 **Android 应用内键盘 AAR**、演示 APK、独立宿主示例。接入后点击输入框自动弹出，由组件直接回填宿主输入框。
|
||||
|
||||
## 选择适合的平台
|
||||
|
||||
| 平台 | 接入与产物 | 已完成的验证 |
|
||||
| --- | --- | --- |
|
||||
| Glyphix RTOS | 原生 `.ux` 页面；圆屏 466×466、方屏 390×450 两屏 QuickApp 完整 ZIP | 普通/QuickApp 四配置构建；84 项原生操作、84 项布局、48 个视觉状态 |
|
||||
| Android 8.1 / API 27+ | 原生 AAR；演示 APK；独立 `host/` 示例 | OWW261 Android 11 真机 8 项交互测试，系统默认输入法保持不变 |
|
||||
|
||||
Android 版本作为**应用内公开组件**，由每个应用自行接入；组件不注册系统输入法。RTOS 页面也需宿主接入，系统级注册依赖厂商支持。
|
||||
|
||||
完全离线，输入功能无需账号。Android 组件不申请网络/外部存储/悬浮窗权限，不保存输入内容；RTOS 端的可选本地学习、私密模式及草稿说明见 [隐私说明](com.sydxky.rtos.inputmethod/PRIVACY.md)。
|
||||
|
||||
## 下载、源码与反馈
|
||||
|
||||
- [v1.2.0 发行包与更新说明](https://git2.sydxky.cn/sydxky/crab-input-rtos/releases/tag/v1.2.0)：AAR、演示 APK、两屏 RTOS QuickApp、验收截图及 SHA-256。
|
||||
- [Android 接入文档](android/README.md) · [RTOS 接入文档](com.sydxky.rtos.inputmethod/README.md)
|
||||
- [实际界面截图](docs/SCREENSHOTS.md) · [RTOS 验收](com.sydxky.rtos.inputmethod/VALIDATION_1.2.0.md) · [Android 真机验收](android/VALIDATION_1.2.0.md)
|
||||
- [已有问题](https://git2.sydxky.cn/sydxky/crab-input-rtos/issues) · [免注册提交问题与建议](https://git2.sydxky.cn/feedback/sydxky/crab-input-rtos)
|
||||
|
||||
Git2 免登录浏览、克隆和下载；当前关闭注册，代码和版本由所有者维护。
|
||||
|
||||
```sh
|
||||
git clone https://git2.sydxky.cn/sydxky/crab-input-rtos.git
|
||||
```
|
||||
|
||||
## Android 开发
|
||||
|
||||
准备 JDK 17、Android SDK compile 37、Python 3；SDK 与签名私钥不随源码分发。
|
||||
|
||||
```powershell
|
||||
cd android
|
||||
python scripts/build-dictionary.py
|
||||
.\gradlew.bat :keyboard:testDebugUnitTest :keyboard:lintRelease :keyboard:assembleRelease :app:assembleDebug :host:assembleDebug
|
||||
```
|
||||
|
||||
生成的 `keyboard/build/outputs/aar/keyboard-release.aar` 可直接放入宿主 `app/libs/`。在 Activity 的 UI 线程使用：
|
||||
|
||||
```java
|
||||
import com.sydxky.crabinput.CrabKeyboard;
|
||||
|
||||
CrabKeyboard.Binding keyboard = CrabKeyboard.attach(this, editText);
|
||||
// 有自己的监听器时，在相应事件中调用 keyboard.show()。
|
||||
// 绑定自动跟随 Activity 生命周期，也可显式 keyboard.close()。
|
||||
```
|
||||
|
||||
源码不包含生成的 SQLite，构建脚本从本仓库 RTOS 原始词库无损生成。正式演示 APK 签名由开发者自己的受保护配置提供；AAR 无需应用签名。
|
||||
|
||||
## RTOS 开发
|
||||
|
||||
准备 Windows PowerShell 7、Node.js、Python 3，以及合法取得的 Glyphix SDK。验证版本为 `gx v0.10.1 / 3ed38835`。将包含 `bin/gx.exe` 和 `share/` 的完整 SDK 放在 `temp/glyphix-v0.7.2-windows-x64/`：
|
||||
|
||||
```powershell
|
||||
& .\com.sydxky.rtos.inputmethod\build.ps1
|
||||
```
|
||||
|
||||
脚本生成词库分片，执行 44 项引擎、32 项 UX 断言，并构建普通/QuickApp 四配置。每屏 QuickApp 都须保留 `bundle.pkg`、`icon.png`、`manifest.json` 三个文件。
|
||||
|
||||
复现原生验收时先构建最小参考页并启动一次圆屏模拟器，获得厂商 launcher/global 资源后退出；不要同时占用 Inspector 14201：
|
||||
|
||||
```powershell
|
||||
& .\com.sydxky.rtos.imefixture\build.ps1
|
||||
Push-Location .\com.sydxky.rtos.imefixture
|
||||
& ..\temp\glyphix-v0.7.2-windows-x64\bin\gx.exe emulate -d generic-watch-466x466
|
||||
Pop-Location
|
||||
python .\com.sydxky.rtos.inputmethod\tests\native.py --work work/native --output work/evidence
|
||||
python .\com.sydxky.rtos.inputmethod\tests\visual.py --work work/visual --output work/evidence/visual
|
||||
```
|
||||
|
||||
视觉脚本依赖 Pillow。RTOS 运行时内存配置保持 8192 KiB。本版本完成模拟器、Android 真机组件及提交包验收；RTOS 真机、长期性能/续航和商店审核尚未验收。
|
||||
在新工单中引用
屏蔽一个用户