VnKey

VnKey mang kiểu gõ Telex của Unikey lên Symbian. Chỉ cần gõ các phím chữ trên bàn phím QWERTY, chữ Việt có dấu hiện ra ngay trong Tin nhắn, trình duyệt, ứng dụng chat và mọi ô nhập chữ khác.

Tính năng

• Mọi ứng dụng. Một plugin nhỏ được máy nạp vào từng ứng dụng, cạnh bộ gõ có sẵn của máy (AknFep). Shift, tự viết hoa đầu câu và phím Fn vẫn hoạt động như cũ.
• Ctrl+Space chuyển qua lại giữa tiếng Việt và tiếng Anh. Dấu [V] hoặc [E] nằm ở thanh dưới cạnh đồng hồ và tự ẩn khi chơi game hay xem video toàn màn hình. Có thể đặt phím khác trong triggers.txt.
• Từ tiếng Anh vẫn là tiếng Anh. Với kiểm tra chính tả, từ không thể là tiếng Việt được trả lại đúng các phím đã gõ: tẽt → text, ưindow → window.
• Gõ tắt: ko → không, dc → được, vn → Việt Nam. Sửa trong macros.txt.
• Kiểu bỏ dấu: kiểu cũ (hòa, thúy, khỏe) hoặc kiểu mới (hoà, thuý, khoẻ).
• Tự chạy khi bật máy và tự bật lại Telex. Màn hình cài đặt bằng tiếng Việt (mặc định) hoặc tiếng Anh. Mọi chữ là Unicode dựng sẵn (NFC).

Gõ Telex

Phím	Chữ	Phím	Dấu
aa	â	s	sắc: á
aw	ă	f	huyền: à
ee	ê	r	hỏi: ả
oo	ô	x	ngã: ã
ow	ơ	j	nặng: ạ
uw, w	ư	z	xóa dấu
dd	đ

Dấu có thể gõ ở cuối từ (toans → toán, vietej → việt, nguoiwf → người), dấu tự dời chỗ khi từ dài thêm (hoafn → hoàn), gõ hai lần để bỏ (ass → as).

Cài đặt

Cần có:

• Nokia E72 (S60 3rd Edition Feature Pack 2, Symbian OS 9.3). VnKey được viết và chạy thử trên máy này. Các máy FP2 có bàn phím QWERTY khác có thể chạy được nhưng chưa được thử.
• Máy đã hack (vá InstallServer và Open4All): plugin được nạp vào mọi ứng dụng, và file tự ký chỉ làm được điều đó trên máy đã vá.

Các bước:

1. Tải vnkey-x.y.z.sisx ở Releases. Trên điện thoại, mở bản nhẹ của trang bằng trình duyệt của máy hoặc Opera Mini.
2. Cài đặt. Mọi thứ vào bộ nhớ máy (C:), nên VnKey vẫn chạy khi rút thẻ nhớ.
3. Mở VnKey, chọn Telex mọi ứng dụng: Bật.
4. Vào Tin nhắn, gõ Vieejt và dấu cách: được Việt.

GitHub chỉ nhận TLS 1.2, còn trình duyệt gốc của S60 chỉ có TLS 1.0. Muốn tải trực tiếp trên điện thoại thì cài bản vá TLS, hoặc tải bằng máy tính rồi chép sang điện thoại.

Cần biết

• Tắt: chọn Telex mọi ứng dụng: Tắt, trả lời Không, rồi khởi động lại máy. Tắt ngay lập tức có thể làm máy tự khởi động lại, nên khởi động lại là cách an toàn.
• Cập nhật hoặc gỡ cài đặt: tắt như trên và khởi động lại máy trước.
• Tắt khẩn cấp: tạo thư mục off trong E:\VnKey\ (hoặc C:\Data\VnKey\); plugin sẽ không đụng tới ứng dụng nào.
• Riêng tư: bản phát hành chỉ lưu nhật ký trên máy (E:\VnKey\vnkey.log) và không gửi gì đi đâu. Ô mật khẩu không bao giờ được ghi lại.

Build từ mã nguồn

Việc build chạy trong Docker image công khai minhkhoi4dev/s60v3-sdk-docker (SDK S60 3rd Edition FP2, GnuPoc, GCCE), trên Mac, Linux hoặc Windows (WSL):

bash symbian/test/run.sh             # kiểm thử bộ gõ Telex, bằng trình biên dịch của máy
bash symbian/group/docker-build.sh   # -> symbian/sis/vnkey.sisx
bash symbian/group/publish.sh        # mở file cho điện thoại tải qua Wi-Fi, từ máy này

Mỗi lần build trên máy, số build trong symbian/VERSION tăng 1. Bản build trên máy có thêm Tùy chọn > Gửi nhật ký để gửi nhật ký về publish.sh khi thử máy.

GitHub Actions (.github/workflows/build.yml) chạy kiểm thử và build mỗi lần push thay đổi trong symbian/. Đó là bản công khai (VNKEY_PUBLIC=1): không có Gửi nhật ký, nhật ký chỉ nằm trên máy. Phát hành một phiên bản: gắn tag v<VERSION> (ví dụ v0.1.11) rồi push; Actions tạo release kèm file .sisx và cập nhật trang giới thiệu (site/, .github/workflows/pages.yml).

Mã nguồn

Thư mục	Nội dung
symbian/src, symbian/inc	Ứng dụng VnKey, plugin vnkeyfep.dll, trình khởi động lúc bật máy, bộ gõ Telex (VnTelex.cpp)
symbian/data	Tài nguyên, chữ trên màn hình (vnkey_vi.loc, vnkey_en.loc)
symbian/group	File build (.mmp), script build và phát hành
symbian/test	Kiểm thử bộ gõ Telex, chạy bằng trình biên dịch của máy tính
site	Trang giới thiệu và bản nhẹ cho điện thoại (site/m/)
docs/TESTING.md	Các bước thử trên điện thoại
CLAUDE.md	Thiết kế, quy tắc Telex, ràng buộc của Symbian và tình trạng dự án

Code C++98 cho GCCE 3.4.3: không STL, không exception. Bộ gõ (TVnTelex) là logic thuần, build được cả cho điện thoại lẫn máy tính để kiểm thử.

---

Dự án cá nhân của Khoi Nguyen. Không liên quan đến Nokia, HMD Global hay dự án Unikey.