프로젝트 소개

유인 입력기(vChewing) macOS 버전은 macOS 플랫폼용으로 개발된 무료 서드파티 네이티브 간체 중국어·번체 중국어 주음/병음 입력기로, 순수 Swift 언어로 작성되었습니다. 프로젝트 홈페이지와 최신 정보는 vchewing.github.io에서 확인할 수 있으며, 코드와 릴리스 버전은 Gitee 저장소를 기준으로 합니다. 주요 기능 - 지원하는 주음 배열과 입력용 병음 종류가 매우 많으며, 자체 개발한 '철한(鐵恨)' 주음 병격 엔진이 이를 지원합니다. - 병음 병격 모드를 제공하여 양손의 성모·운모 분담이 명확합니다. 또한 광병(狂拼) 모드가 있어 병음 타자 모드를 활성화하면 즈넝광병/서우거우병음의 타자 경험을 이어받을 수 있습니다. - 중국 대륙 심사음과 호환되어 타이완·펑후·진먼·마쭈 심사음에 익숙하지 않은 사용자도 정상적으로 사용할 수 있으며, 그 반대도 마찬가지입니다. - 기본 어휘집에는 전 세계 보급을 저해하는 내용이 포함되어 있지 않습니다. 간체·번체 중국어 말뭉치가 서로 분리되어 있어 번체·간체 변환 오류를 방지합니다. - 번체 중국어 출력을 일본 JIS 신자체 또는 강희 번체로 변환할 수 있으며, 최근 연도의 전자고(全字庫) 한자 입력을 지원합니다. - macOS 화면 시뮬레이션 키보드를 지원합니다(전통 대천 및 전통 의천 배열만 해당). - 사용자 구문 파일 형식을 자동으로 정리하고 연관 어휘를 사용자 정의할 수 있습니다. 보안성 - Sandbox 기능이 활성화되어 있어 원리적으로 시스템 전역 키보드 권한을 획득할 수 없습니다. - '강화형 조자구역 보안 보호' 모드를 갖추어 입력을 받는 소프트웨어가 조자구역 내용에 사전 접근하는 것을 방지합니다. - Shift 키 감지는 InputMethodKit의 IMKServer에서 전달되는 NSEvent 신호 데이터 스트림 컨텍스트를 관찰하는 방식으로만 구현되므로, 시스템 전역 키보드 이벤트를 감청하거나 보조 권한을 신청할 필요가 없으며 로컬 데이터를 외부로 전송하지도 않습니다. Shift 중국어·영어 전환에는 macOS 10.15 Catalina 이상이 필요합니다. 시스템 요구 사항 - 빌드에는 Swift 6.4 이상이 필요합니다. Xcode 27+(macOS 26.6 이상 필요) 또는 Xcode 26.x에 별도 설치한 Swift 6.4+ 오픈소스 툴체인을 사용합니다. Intel Mac에서는 Xcode 내장 Swift 버전 제한으로 인해 SwiftPM 명령줄로만 빌드할 수 있습니다. - 산출물은 최소 macOS 12 Monterey를 지원하며, 권장 최소 버전은 macOS 14 Sonoma입니다. 권장 메모리는 최소 4GB이며 SSD 사용을 권장합니다. - macOS 10.9~10.10용 legacy 설치 패키지가 필요한 경우 Xcode 15, MacOSX13.3.sdk, Swift 5.10.1 툴체인이 추가로 필요하며 make debugLegacy/releaseLegacy로 구동합니다. 이 경로는 CI에 포함되지 않습니다. 빌드 절차 Xcode 설치 후 DerivedData를 프로젝트 폴더 아래의 상대 경로로 설정해야 합니다. 그렇지 않으면 make가 오류를 발생시킵니다. 자주 사용하는 명령: make update로 최신 어휘집 리소스를 가져옵니다. make release로 arm64 + x86_64 유니버설 버전을 빌드합니다. make archive로 .xcarchive를 생성합니다. make debug로 빠른 디버그 빌드를 수행합니다. Xcode에서 직접 프로젝트를 열고 vChewingInstaller 스킴을 선택하여 컴파일할 수도 있습니다. 라이선스 및 유지보수 무란 관용 라이선스 조항 제2판(MulanPSL-2.0)으로 배포됩니다. 프로그램 유지보수는 Shiki Suen이 담당합니다. 철한 엔진과 호마(Homa) 조구 엔진은 LGPL v3.0 or later(Swift App Development 예외 포함)로 라이선스됩니다. 유인 어휘집(선봉 말뭉치)도 MulanPSL-2.0으로 배포되며, 그중 어휘 빈도 데이터는 NAER의 비상업적 사용 허가를 받았습니다. 4.1.3 버전 이전의 기록은 vChewing-macOS-AncientArchive 저장소에 별도 보관되어 있습니다.