Skip to content
This repository was archived by the owner on Jun 27, 2026. It is now read-only.

develop.md

Latest commit

 

History

History
79 lines (59 loc) · 6.95 KB

develop.md

File metadata and controls

79 lines (59 loc) · 6.95 KB
Raw

[!ATTENTION|label:文档已过时] ⚠️此文档内容已过时，请转至新文档：xxxk.input.press。

:fa fa-code-fork: 开发指南

前往 :fa fa-github: 本项目仓库获取源代码。解压后可以得到三个一级目录：

  • 📂build：存放编译生成小小星空输入法安装包的脚本。

  • 📂data：编译小小星空输入法安装包所需的程序文件。具体的程序文件不在本仓库中，需要由原版小小输入法的安装包解包得到，详见下面的说明。

  • 📂home：各种魔改原版小小输入法的数据文件，以及星空系列方案的码表文件。包括但不限于：

    • 全拼输入方案（home/entry，home/mb/pinyin）：一个备用的本地全拼输入方案。按 u 可开启笔画模式。
    • 星空扩展码表（home/mb）：适合星空方案使用的一些扩展码表，例如 o 引导的特殊符号或命令、; 引导的特殊符号等。
    • 增强的英文词库（home/mb/english.txt）：来自 Github 的英文单词词库，比原版收词更多。
    • 脚本（home/tools）：一些 bat 和 vbs 脚本，可被码表调用，实现某些特殊任务。
    • 中文标点映射（home/bd.txt）：实现按 / 键输出 、 等功能。
    • 增强的笔画库（home/bihua.bin）：可供其他方案的笔画模式调用。数据来自 2018 年的汉典，比小小输入法原版内置的数据库收字更多。
    • 火星文之菊花文（home/crab.txt）：CtrlAltShiftH 开启，开启后输出的文字带有菊花特效。（小小星空已默认配置好，其他基于小小输入法的项目若想使用，需确保 yong.ini 中设置 crab=crab.txt，并在 [key]crab 设置开启热键）
    • 增强的软键盘（home/keyboard.ini）：参考小小论坛@qwer的帖子，对软键盘进行强化。
    • 键位映射（home/layout.txt）：仅仅写了一个配置文件模板，供感兴趣者参考，在此基础上修改，可以实现键位映射、并击等高级功能。默认未开启。（如要开启，需在 yong.ini 中设置 [IM]layout=layout.txt）
    • 定制菜单（home/menu.ini）：小小星空定制的输入法右键菜单。（小小星空已默认配置好，其他基于小小输入法的项目若要调用，可在 yong.ini 中设置 [IM]menu=menu.ini）
    • 网址屏蔽配置（home/urls.txt）：小小输入法默认会自动识别 http、ftp 等开头的编码并转入英文模式，可能会干扰一些中文输入方案的使用。该文件可以屏蔽这个功能。
    • 懒人的输入法配置（home/yong-win.ini 和 home/yong-android.ini）：输入法配置文件，定制了输入法的外观、热键、某些行为等。可以直接使用，也可以在此基础上，参考 yong.chm 进行个性化定制。
    • 编译脚本（yong_thxnder_gb18030.nsi）：NSIS 脚本文件，可以编译生成小小星空输入法安装包。已经添加了详细的注释，可供参考。

按照以下步骤，即可将本项目编译生成 Windows 或 Android 版小小星空输入法安装包：

** Windows **

  1. 部署 NSIS，下载依赖文件 EnumINI.nsh 到 NSIS 程序目录/Include 目录下。
  2. 下载原版小小输入法 Windows 版压缩包（如 yong-win-3.0.0.1.7z）并解压，将 yong 目录中的内容放到本仓库的 data/yong-win 目录下。
  3. 执行本仓库的 data/yong-win/yong-update.bat，更新小小输入法程序文件。
  4. 用 NSIS 编译本仓库的 build/win/xxxk.nsi 文件，即可得到小小星空的安装包。

** Android **

  1. 部署 jdk8 或更高版本。

  2. 下载 apktool，把 apktool.jar 和 apktool.bat 放到本仓库的 build/yong-android 目录下。

  3. 下载 uber-apk-signer，把 uber-apk-signer.jar 放到本仓库的 build/yong-android 目录下。

  4. 下载原版小小输入法 Android 版安装程序，把 yong.apk 放到本仓库的 build/yong-android 目录下。

  5. 运行本仓库的 build/yong-android/xxxk.bat，执行 [D] 选项，把 yong.apk 反编译得到 data/yong-android 目录。

  6. 运行本仓库的 build/yong-android/xxxk.bat，执行 [R] 选项，将有关资源文件写入 data/yong-android/assets 目录。

  7. 根据自己的需要，修改 data/yong-android 里的资源文件。例如：

    • res/drawable-hdpi|mdpi|xhdpi/app_icon.png 是程序图标，可替换。
    • assets/version.txt 表明当前安装包的名称和版本号。当满足以下条件之一时，assets 里的大部分文件会被释放到 /sdcard/yong 并替换原文件。① /sdcard/yong 不存在。② assets/version.txt 里的名称非空并且与 /sdcard/yong/version.txt 不同（会先删除 /sdcard/yong 再释放文件）。③ assets/version.txt 里的名称非空并且与 /sdcard/yong/version.txt 相同，且 assets/version.txt 的版本号大于 /sdcard/yong/version.txt 里的版本号。
    • assets/mb 码表。
    • assets/www 默认皮肤，一般包括 fonts 目录和 keyboard.css、keyboard.html，不会体现在程序目录中。如果安装完成后想添加皮肤，要把皮肤放到 /sdcard/.yong/android 目录。
    • assets/yong.ini 是初始配置文件。注意，小小安卓版不支持 entry。
    • assets/.yong 用户数据。注意，原版安装包永远不会释放该目录到 /sdcard/yong，小小星空通过修改反编译后的 smali 文件，改变了这一限制。

  8. 运行本仓库的 build/yong-android/xxxk.bat，执行 [C] 选项，进行重新编译。

  9. 运行本仓库的 build/yong-android/xxxk.bat，执行 [S] 选项，进行签名，得到 xxxk-signed.apk。

** Linux **

本项目暂不对 Linux 系统打包制作小小星空的自动安装包。

你可以前往:fa fa-github: 小小输入法项目仓库获取原版小小输入法 Linux 版的源代码。