/OpenHeInput-MacOS

Full functional Chinese input method for Mac OS X using Objective C.

Primary LanguageObjective-C

OpenHeInput Project

'He' is Chinese word 和's PinYin(Sound), it means 'and' or 'with'.

'HeInput'('和码' in Chinese) is a name of famous Chinese input mathod.

OpenHeInput-MacOS is open source HeInput project for Mac OS X.

This project is based on Mac OS X 10.5 Input Method Kit Framework, started from Apple's NumberInput_IMKit_Sample: https://developer.apple.com/library/mac/samplecode/NumberInput_IMKit_Sample/Introduction/Intro.html

Now it is fully functional Chinese Input application, target to Mac OS X 10.9+, has features:

  1. Has 3 input modes: Chinese Simplified, Chines traditional, HeEngligh;
  2. Use main keyboard or number pad to input;
  3. Includes 21,000 Chinese words, 180,000 phrases.

Currently Apple does not allow third party Input method application in App Store, so if you want use HeInput in MacOS, you need make it youself by following steps in section "Compile and Install".

Application Structure

Created with XCode 7.2.1, using Objective C.

Workspace: HeMacOS-Workspace

Include 3 modules:

  1. Static Library: HeLibrary;
  2. Static Library: HeInputLibrary;
  3. Application: OpenHeInput.

The main parts of code are:

  1. HeInputController class, which is inherited from IMKInputController, handles key events, abtains candidates from data server, and sends selected words to client (application);
  2. Input_DataServer process key input and provide cadidates;
    1. HeInput_DataServer includes EngineCollection;
    2. EngineCollection includes HeMaEngine, PinYinEngine, HeEnglishEngine, etc;
    3. Each Engine access SQLite database;

Database Structure

Include a SQLite database: hema_db.sqlite, it includes tables:

create table HanZi
(
--_id INTEGER PRIMARY KEY,
HanZi text,
M1 numeric,
M2 numeric,
M3 numeric,
M4 numeric,
GBOrder numeric,
B5Order numeric
);

create table CiZu
(
--_id INTEGER PRIMARY KEY,
CiZu text,
M1 numeric,
M2 numeric,
M3 numeric,
M4 numeric,
HeMaOrder numeric,
JianFan numeric
);

create table English_Word
(
--_id INTEGER PRIMARY KEY,
word text,
HeMaOrder numeric
);

create table PinYin_Number
(
--_id INTEGER PRIMARY KEY,
PinYin text,
number numeric
);

create table PinYin_HanZi
(
--_id INTEGER PRIMARY KEY,
PinYin text,
HanZiString text
);

create table HanZi_PinYin
(
--_id INTEGER PRIMARY KEY,
HanZi text,
PinYin text,
ShengDiao numeric
);

Compile and Install

Aftet geting source from here, then:

  1. Run XCode, open HeMacOS-Workspace.xcworkspace;

  2. Select OpenHeInput project --> OpenHeInput target;

  3. Build;

  4. Select OpenHeInput-->Products-->OpenHeInput.app, right click to show in Finder,

  5. Copy OpenHeInput.app to /Library/Input Methods/ folder，then Log out, and Log in again；

  6. Open Mac OS X System Preferences;

  7. Select Keyboard --> Input Source;

  8. Click ' + ' Sign at bottom left;

  9. Select Simplified Chinese;

  10. Select one or more OpenHeInput methods: Chinese Simplified, Chinese Traditional, HeEnglish;

  11. Then click 'Add' button;

  12. Run an application which requires Chinese input;

  13. Select HeInput method by click language icon on screen's top right corner;

  14. Then type in Chinese.

How to use OpenHeInput application

  1. Shift + Space (or character): switch to English input;

  2. fn + Space: switch Chinese or PinYin, or HeEnglish input mode;

  3. 0(M) to display function menu, and select from menu;

  4. fn + character to switch input mode:

fn + j, s: switch to Chinese simplified mode;

fn + f, t: switch to Traditional Chinese mode;

fn + p: switch to PinYin mode;

fn + e: switch to HeEnglish mode;

fn + r: switch to reset mode;

fn + a: turn Off/On pinyin prompt.

More Information about HeInput

  1. http://www.hezi.net/He/UserGuide/zh-Hans/Set/BookCover.html

  2. http://www.hezi.net/He/UserGuide_Concise/zh-Hans/Set/HeChinese_Guide_Concise.htm

一、开源和码输入程序与数据库

苹果电脑上，和码输入程序是基于Mac OS X 10.5 引入的Input Method Kit Framework制作的，程序开始于学习 Apple's NumberInput_IMKit_Sample: https://developer.apple.com/library/mac/samplecode/NumberInput_IMKit_Sample/Introduction/Intro.html。

现在是一款完整的和码汉字字形输入软件，有以下输入功能：

1、有三种输入选择：简体汉字(Chinese Simplified)、繁体汉字(Chinese Traditional)，和码英文(HeEnglish)；
2、可用电脑大键盘，与数字小键盘输入；
3、包含21,000多个单字, 180,000多条词组。

和码输入软件还可以从AppStore下载： （等待审查）

二、程序编译与安装

Mac苹果电脑和码开源输入软件，是用XCode 7.2.1开发编译的。获取程序后，可用以下步骤编译与安装OpenHeInput：

1、用XCode打开HeMacOS-Workspace.xcworkspace;

2、选择OpenHeInput project --> OpenHeInput target;

3、编译Build;

4、OpenHeInput-->Products-->OpenHeInput.app, 鼠标右击-->Show in Finder,

5、将OpenHeInput.app文件，拷贝到Mac个人用户的 /Library/Input Methods/ 目录下，然后Log out（退出登录），再登录Log in；

6、打开Mac的System Preferences（系统设置）--> Keyboard（键盘）--> Input Source（输入程序）--> Chinese Simplified（简体汉字）；

7、选择HeInput Simplified（和码简体）, HeInput Traditional（和码繁体）, 或HeEnglish（和码英文）, 任选一种输入方式；

8、打开应用软件，在屏幕北方的输入法列表中，调用和码输入法，就可以用和码输入了。

目前，苹果系统不充许第三方输入软件发布到苹果软件店(AppStore)，使得想用和码输入软件朋友，就只好按上述步骤自己编译安装了。

三、Mac电脑上和码输入软件的使用方法

1、Shift + Space(Character): 切换到纯英文输入方式；

2、fn + Space: 切换到汉字或拼音输入方式，或和码英文输入方式；

3、输入码0(M)，软件显示功能目录，再选择目录项；

4、fn + 字母键进行输入方式转换，如：

fn + e: 转为HeEnglish输入模式(english)；

fn + j, s: 简体字输入(jianTi, simplified Chinese);

fn + f, t: 繁体字输入(fanTi, traditional Chinese);

fn + p: 拼音单字输入(拼音查码)(pinYin);

fn + r: 回复到初始设定(reset)；

fn + a: 开启或 关闭拼音提示(annotation)；

四、和码资料

有关和码汉字字形技术，和码输入法的学习资料，可查看：

1、和码线上书：http://www.hezi.net/He/UserGuide/zh-Hans/Set/BookCover.html

2、和码简明教程：http://www.hezi.net/He/UserGuide_Concise/zh-Hans/Set/HeChinese_Guide_Concise.htm

3、和码在Android/iPad/iPhone上的练习与输入软件：http://www.hezi.net/he/HTML/HeChinese_Download.html