문제 해결

입력기 목록에 Ongeul이 보이지 않음

원인: macOS는 입력기 목록을 로그인 시점에 캐시합니다.

해결: 로그아웃 후 재로그인하세요. 설치 직후에는 반드시 이 과정이 필요합니다.

Gatekeeper가 .pkg 또는 앱 실행을 차단함

원인: 0.3.x 이하는 Developer ID 서명과 공증이 없어 macOS Gatekeeper가 차단합니다.

해결: 0.4.0 이상으로 업데이트하세요. 0.4.0부터는 서명·공증되어 경고 없이 설치됩니다. 자세한 내용은 설치 > 서명과 공증을 참고하세요.

0.4.0 이상인데도 차단된다면 다운로드가 손상됐을 수 있습니다. 릴리스 노트의 SHA-256과 shasum -a 256 Ongeul-<버전>.pkg 결과를 비교해 보세요.

업데이트 후 손쉬운 사용 권한이 풀림

원인: 0.4.1 이하의 설치 패키지는 업데이트할 때마다 손쉬운 사용 권한을 초기화합니다. 또한 macOS는 손쉬운 사용·입력 모니터링 권한을 앱의 코드 서명에 묶어 관리하므로, 0.3.x 이하에서 올라오면 ad-hoc 서명에서 Developer ID 서명으로 바뀌어 기존 부여가 무효화됩니다.

해결: 설치 > 손쉬운 사용 권한 절차대로 다시 부여하세요. 0.4.2 설치 패키지부터는 같은 Developer ID로 서명된 버전에서 업데이트하면 권한이 유지됩니다.

한/영 전환 시 커서 옆에 한/A가 표시되지 않음

원인: 온글 (영어) 입력 소스가 추가되어 있지 않습니다. 시스템 언어가 영어이면 **Ongeul (English)**로 표시됩니다.

해결: 설치 > 입력기 등록 절차대로 **온글 (영어)**를 추가하세요.

한글 조합이 되지 않음

다음 사항을 확인하세요:

  1. 현재 입력 모드가 한글 모드인지 확인합니다 (오른쪽 Command로 전환).
  2. 메뉴 막대의 아이콘이 한글 모드 아이콘으로 표시되는지 확인합니다.
  3. 해당 앱에 영문 잠금이 설정되어 있지 않은지 확인합니다.

Shift+Space 전환 시 공백이 입력됨

원인: iTerm2, JetBrains IDE(RustRover, IntelliJ, WebStorm 등) 등 일부 앱은 입력기의 키 처리 결과를 무시하여 Shift+Space 전환 시 공백 문자를 함께 삽입합니다.

해결: 손쉬운 사용(Accessibility) 권한이 부여되어 있는지 확인하세요. 이 권한이 부여되면 Ongeul이 시스템 레벨에서 Shift+Space를 가로채므로 모든 앱에서 공백 없이 전환됩니다.

  1. 시스템 설정 → 개인 정보 보호 및 보안 → 손쉬운 사용 을 엽니다.
  2. 목록에서 Ongeul 이 활성화되어 있는지 확인합니다.

손쉬운 사용 권한은 설치 시 자동으로 안내됩니다. 자세한 내용은 설치 > 손쉬운 사용 권한을 참고하세요.

CapsLock 전환이 느리거나 무시됨

원인: macOS의 CapsLock 지연 기능이 활성화되어 있으면 CapsLock을 빠르게 누를 때 입력이 무시될 수 있습니다.

해결: 시스템 설정 → 키보드에서 CapsLock 지연을 비활성화하세요. 자세한 내용은 CapsLock > 사전 설정을 참고하세요.

특정 앱에서 한글 대신 영문이 입력됨

원인: 일부 앱(웹 폼, 문서 편집기 등)은 텍스트 필드에 포커스가 없는 상태에서 키를 누르면 자동으로 입력 필드를 생성하면서 영문 문자를 삽입할 수 있습니다.

해결: Ongeul은 이 상황을 자동으로 감지하여 보정합니다. 영문 문자를 삭제하고 한글로 재입력하는 과정이 자동으로 진행됩니다. 이 기능은 손쉬운 사용(Accessibility) 권한이 필요합니다. 만약 보정이 작동하지 않는다면 권한이 활성화되어 있는지 확인하세요.

디버그 로그 확인

문제를 진단하려면 콘솔에서 Ongeul의 로그를 확인할 수 있습니다.

log stream --predicate 'subsystem == "io.github.hiking90.inputmethod.Ongeul"'