v0.13.1 — 최소 동작 예제 + 매뉴얼 처음부터 따라하기·참고 자료
문서·예제 릴리스입니다. IME 동작 변경은 없습니다.
처음 IME를 만드는 사람이 시작할 수 있게 하는 데 초점을 맞췄습니다.
새로 추가
examples/minimal-tip/ — 동작하는 최소 TSF IME
minimal.c 약 200줄 + minimal.def 6줄. Windows 언어 목록에 뜨고 a 키를 먹어 ㄱ을 넣는 것이 전부입니다. x64·x86 모두 빌드를 확인했습니다.
IME는 "키를 받아 글자를 넣는 프로그램"이 아니라 OS가 로드하는 COM 서버입니다. 그래서 글자를 넣기 전에 관문이 셋입니다.
① COM 서버가 되어야 → DllGetClassObject 로 객체를 내줄 수 있어야
② IME로 등록되어야 → 언어 목록에 떠야 고를 수 있음
③ 키를 받아야 → 키 싱크를 붙여야 키가 옴
④ 그제서야 글자를 넣음 → 편집 세션 안에서만
하나라도 빠지면 오류 메시지 없이 아무 일도 안 일어납니다. 그 침묵이 처음 하는 사람을 가장 괴롭히므로, 최소 예제로 세 관문을 먼저 통과시키게 했습니다.
매뉴얼 §0.5 「처음부터 따라하기」
빌드 → 등록 → 확인 → 입력 → 제거를 단계별로 안내하고, 단계마다 실패 증상표를 붙였습니다.
| 증상 | 원인 |
|---|---|
| "모듈을 로드할 수 없습니다" | 비트수 불일치 |
| "진입점을 찾을 수 없습니다" | .def 누락 |
| 성공했는데 목록에 안 뜸 | 카테고리 등록 누락 |
최소 예제가 조합 미리보기를 일부러 안 하는 이유(§8 CUAS의 벽)도 밝혀, §8을 먼저 읽도록 유도합니다.
매뉴얼 부록 B 「참고 자료」
공식 문서 39개 링크를 제목과 함께 정리했습니다. TSF 전반 · 인터페이스 21종 · 개념 · COM · IMM32 · 한글 유니코드 코드표 · 도구.
인터페이스마다 "어디에 쓰는지 + 몇 절"을 달아 본문과 이었고, ITfComposition은 CUAS에서 죽는다거나 ITfCompositionSink가 NULL이면 실패한다는 식으로 실기에서 얻은 주의를 링크 옆에 붙였습니다. 전 링크 접속(HTTP 200)을 확인했습니다.
검증
- 본체 x64·x86 빌드 무경고
- 예제 x64·x86 빌드 무경고
- 릴리스 DLL에 진단 로그 문자열 0건
- 매뉴얼 링크 39/39 접속 확인