DKST macOS용 한글입력기 v2.6.2 안정화 버젼

v2.6.2 안정화 버젼을 릴리즈합니다.

• 단기간 내 해결이 어려운 selectedRange 관련 문제를 우회하기 위해, 앱 번들 ID가 com.apple.*을 제외한 모든 항목은 밑줄 조합 방식(Marked Text)으로 입력됩니다.
  이는 입력기가 처음 입력창을 마주했을 때 직접 입력이 가능한지 확인하는 단계인데, 현재 상황은 다음과 같습니다.

🔍 핵심 문제점 정리

간단히 말하면,
일부 문제를 일으키는 입력창과 처음 만나면 3 ~ 6초간 기다린다 vs 일부 문제를 일으키는 창마다 앱번들 ID를 추가한다.
같은 상황에 놓여 있기 때문입니다.

현재 밑줄 조합 방식과 직접입력 이 둘을 냉온탕으로 오가는 언어는 한글이 유일하기 때문에, 딱히 참고할 문서는 없이 수십가지 우회책, 해결책을 시도해보았지만 아직까지는 소득이 없습니다.

따라서 이번 2.6.2 안정화는 selectedRange를 제거하고, 터미널을 제외하고 직접입력이 확실한 애플앱만 우선순위로 직접입력,
그 외 앱들은 밑줄 조합 방식으로 입력하는 방식으로 릴리즈합니다.

사실 인라인 직접 입력은 제 욕심이기도 합니다.

현재 애플 생태계상 마크드텍스트 입력이 상당 부분에서 더 안정적이거든요.....

설치는 터미널 여시고

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/DINKIssTyle/DINKIssTyle-IME-macOS/main/install.sh)"

입력 입니다!

그래도 Apple 앱들에서 인라인 직접 입력을 제공하는 서드파티 한글입력기는 DKST 입력기가 유일하네요 ㅎㅎ

🚀 Release Notes: Core Engine Refactoring

이번 리팩토링은 macOS 입력 프레임워크(IMK)의 비공개 API와 Apple Native IME(KIM)의 동작 패턴을 심층 분석하여, 기존의 하드코딩 기반 정책을 런타임 동적 쿼리 및 원자적(Atomic) 처리 구조로 전환하는 데 초점을 맞췄습니다.

🛠 주요 개선 사항 (Phase 1 ~ 3)

1. 런타임 동적 정책 쿼리 및 기본값 최적화

• textDocument 동적 감지: IMKInputController 내부의 비공개 객체인 textDocument에 showsComposingTextAsMarkedText 속성을 직접 쿼리합니다.

• XPC 블로킹 제거: 입력 필드 전환 시 3~6초의 프리징을 유발하던 selectedRange 호출을 정책 결정 단계에서 제거했습니다.

• 안전한 기본값: 미식별 앱의 기본값을 Marked Text(인라인) 모드로 설정하여, 포토샵 등 특정 앱에서 발생하던 글자 파편화 현상을 해결하고 성능을 확보했습니다.

2. 직접 입력(Direct Input) 안정성 및 즉시 마이그레이션

• 실시간 실패 감지: 직접 입력 중 커서 위치 불일치가 감지되면 다음 입력까지 기다리지 않고, 현재 조합 중인 글자를 즉시 마크드 텍스트로 전환하여 다시 렌더링합니다.

• 인라인 불일치 검증: setMarkedText: 호출 직후 클라이언트의 markedRange를 검증하여, 일부 앱이 조합창 설정을 무시할 경우 발생하던 받침 누락을 방지합니다.

3. 원자적(Atomic) 입력 처리 (Space-Commit 이슈 해결)

• 통합 삽입 로직: 스페이스바 입력 시 "조합 중인 한글 + 공백"을 하나의 insertText: 호출로 묶어 처리합니다.

• 효과: 마크드 텍스트 모드에서 스페이스 입력 시 확정된 글자가 사라지거나 공백만 남는 현상을 근본적으로 해결했습니다.

4. 상태 관리 및 방어적 코드 강화

• NSNotFound 위임: replacementRange 계산 시 수동 범위를 지정하는 대신 NSNotFound를 사용하여 IMK 프레임워크가 표준 방식으로 기존 조합을 대체하도록 유도했습니다.

• 이벤트 필터링: KeyDown 이외의 예기치 않은 이벤트 발생 시 버퍼를 자동 초기화하고, Ctrl+A/E 등 제어 문자 입력 시 후보창을 닫고 조합을 즉시 커밋합니다.

📊 기술적 변화 요약

영역

변경 전

변경 후

정책 결정

번들 ID 하드코딩 및 수동 관리

textDocument 동적 쿼리 및 안전한 기본값

성능 (Lag)

필드 전환 시 selectedRange XPC 렉 발생

XPC 호출 제거 및 실시간 실패 감지 구조

공백 처리

한글 확정과 공백 삽입의 2단계 분리

원자적(Atomic) 통합 삽입 및 이벤트 소비

상태 관리

수동 setMarkedText:@"" 호출 남발

프레임워크 표준 위임 및 자동 관리

💡 기대 효과

• 입력 안정성: 포토샵, 일러스트레이터, GIMP 에서의 안정성이 macOS 기본 입력기 수준으로 향상되었습니다.

• 반응성 개선: 필드 전환 및 첫 입력 시 발생하던 간헐적인 프리징 현상이 해소되었습니다.

• 표준 준수: Apple KIM(Korean Input Method)의 내부 동작 메커니즘을 분석하여 시스템 호환성을 높였습니다.