문제 해결
입력기 목록에 Ongeul이 보이지 않음
원인: macOS는 입력기 목록을 로그인 시점에 캐시합니다.
해결: 로그아웃 후 재로그인하세요. 설치 직후에는 반드시 이 과정이 필요합니다.
Gatekeeper가 .pkg 또는 앱 실행을 차단함
원인: Ongeul은 오픈소스 프로젝트로 Apple Developer 인증서로 서명되어 있지 않아, macOS Gatekeeper가 .pkg 설치 파일이나 앱 실행을 차단합니다.
해결:
- 경고 다이얼로그에서 완료 를 클릭합니다.
- 시스템 설정 → 개인 정보 보호 및 보안 으로 이동합니다.
- 하단 보안 섹션에서 차단 메시지를 확인하고 확인 없이 열기 를 클릭합니다.
자세한 내용은 설치 > 실행 권한을 참고하세요.
한글 조합이 되지 않음
다음 사항을 확인하세요:
- 현재 입력 모드가 한글 모드인지 확인합니다 (오른쪽 Command로 전환).
- 메뉴 막대의 아이콘이 한글 모드 아이콘으로 표시되는지 확인합니다.
- 해당 앱에 영문 잠금이 설정되어 있지 않은지 확인합니다.
Shift+Space 전환 시 공백이 입력됨
원인: iTerm2, JetBrains IDE(RustRover, IntelliJ, WebStorm 등) 등 일부 앱은 입력기의 키 처리 결과를 무시하여 Shift+Space 전환 시 공백 문자를 함께 삽입합니다.
해결: 손쉬운 사용(Accessibility) 권한이 부여되어 있는지 확인하세요. 이 권한이 부여되면 Ongeul이 시스템 레벨에서 Shift+Space를 가로채므로 모든 앱에서 공백 없이 전환됩니다.
- 시스템 설정 → 개인 정보 보호 및 보안 → 손쉬운 사용 을 엽니다.
- 목록에서 Ongeul 이 활성화되어 있는지 확인합니다.
손쉬운 사용 권한은 설치 시 자동으로 안내됩니다. 자세한 내용은 설치 > 손쉬운 사용 권한을 참고하세요.
디버그 로그 확인
문제를 진단하려면 콘솔에서 Ongeul의 로그를 확인할 수 있습니다.
log stream --predicate 'subsystem == "io.github.hiking90.inputmethod.Ongeul"'