기술 심층 분석
Swift로 macOS용 네이티브 이모지 선택기 만들기
Electron 없이, 군더더기 없이
이 글은 Emoji Picker for macOS의 개발 기록입니다. 채팅하는 동안 기본 선택기가 계속해서 글쓰기 흐름을 끊었기 때문에 이 앱을 만들었습니다. 내장 기능은 마우스로 손을 옮겨야 했고 사용하기에도 느렸습니다. 목표는 단순했습니다. 입력하고, 고르고, 계속 나아가는 것.
이 심층 분석의 내용
워크플로의 진짜 문제
macOS에는 이미 이모지 선택기가 있습니다. 가끔 사용하기에는 괜찮습니다. 하지만 텍스트를 많이 다루는 워크플로에서는 오히려 속도를 늦췄습니다. 패널을 열고, 손을 마우스로 옮기고, 고르고, 패널을 닫고, 하던 일로 돌아갑니다. 이 과정을 하루에 수십 번 반복하면 흐름이 끊기는 비용이 확연히 드러납니다.
초기 내부 테스트에서 잘못된 활성화가 얼마나 성가신지 드러났습니다. 그래서 활성화가 지루할 만큼 예측 가능하게 느껴질 때까지 규칙을 엄격하게 다듬었습니다. ;를 입력하고, 현재 앱에 머문 채로, 키보드로 선택하고, 계속 쓰면 됩니다.
- 지원 및 티켓 업무에서는 많은 짧은 메시지를 분류하면서 빠르게 삽입해야 합니다.
- 코드 리뷰 코멘트나 커밋 메시지에서는 대개 넣고 싶은 것이 이미 정해져 있으므로, 카테고리를 둘러보는 것보다 검색어를 입력하는 편이 더 빠릅니다.
- 하루에 40번 이상 패널을 열고 닫다 보면 입력 리듬이 금방 깨집니다.
아키텍처 결정
전역 단축키 처리
입력은 Core Graphics 이벤트 탭과 보호 장치가 있는 상태 머신으로 처리됩니다. 크기가 제한된 메모리 내 버퍼가 맨 앞에 있는 앱에서 최근 입력된 인쇄 가능한 문자를 보관하여, 설정된 트리거를 인식할 수 있게 합니다. 이 버퍼는 앱 전환, 단축키, 인쇄할 수 없는 입력, 취소 시 재설정됩니다. 설정 가능한 팝업 지연 시간 덕분에 검색어를 입력하는 동안에도 UI가 차분하게 유지됩니다.
NSPanel과 NSPopover 사이의 결정
처음에는 NSPopover로 시작했다가 NSPanel로 바꿨습니다. NSPopover는 Slack과 Chrome에서 앱을 빠르게 전환할 때 포커스를 너무 쉽게 잃었습니다. NSPanel은 수명 주기를 명시적으로 제어할 수 있게 해 주었고, 앱 경계를 넘어서도 키보드 입력이 예측 가능하게 전달되었습니다.
손쉬운 사용 권한과 삽입 방식
손쉬운 사용 권한이 있으면 Emoji Picker가 이러한 전역 이벤트를 모니터링하고 활성 앱에 키보드 이벤트를 다시 보낼 수 있습니다. 클립보드 기반 삽입은 채택하지 않았습니다. 클립보드 내용을 덮어쓰는 것은 예상하기 어렵고 신뢰하기 힘든 동작이기 때문입니다. 앱은 AXUIElement를 통해 텍스트 필드를 검사하지 않습니다. 세션이 시작될 때 맨 앞에 있어야 할 앱을 기록하고, 삽입하기 전에 같은 앱이 여전히 맨 앞에 있는지 확인합니다.
문자 수를 센 텍스트 대치
인라인 세션은 대상 앱에 도달한 트리거 문자와 검색어 문자의 수를 셉니다. 항목을 선택하면 Emoji Picker는 그 수만큼 Backspace 키 이벤트를 보낸 다음, 선택한 유니코드 텍스트를 합성 키보드 이벤트로 보냅니다. 클립보드는 절대 변경하지 않습니다. 그래도 사용자 지정 컨트롤은 합성 키보드 이벤트를 다르게 해석할 수 있으므로, 대상 앱 확인과 취소 동작이 중요합니다.
컨텍스트 감지 규칙
활성화를 예측 가능하게 유지하기 위해 사용하는 실용적인 규칙은 다음과 같습니다:
- Emoji Picker 자체의 윈도우와 사용자의 제외 목록에 있는 앱은 무시합니다.
- 최근 입력과 각 활성 세션을 맨 앞에 있는 앱에 연결하고, 앱을 전환하면 세션을 취소합니다.
- 설정된 트리거를 최근 입력된 인쇄 가능한 문자의 끝부분(길이 제한 있음)과 비교합니다.
- 인라인 검색어에는 문자, 숫자, 밑줄, 더하기 기호, 하이픈을 허용하고, 그 밖의 입력이 들어오면 취소합니다.
- UI를 표시하기 전에 사용자가 설정한 시작 시퀀스 차단 목록, 최소 검색어 길이, 팝업 지연 시간을 적용합니다.
- 명시적인 호출을 선호하는 사용자를 위해 바로 여는 트리거의 사용자 지정(예: ;; 또는 //)을 지원합니다.
단순화한 상태 로직(가독성을 위해 일부 생략):
func handle(_ event: KeyEvent, frontmostApp: App) {
guard frontmostApp != emojiPicker, !isExcluded(frontmostApp) else {
resetRecentInput()
return
}
if session == nil, recentInput.appending(event).hasSuffix(inlineTrigger) {
session = .inline(target: frontmostApp, deleteCount: inlineTrigger.count)
} else if session?.accepts(event) == true {
session?.appendToQuery(event)
showAfterConfiguredDelay()
}
}
func commit(_ text: String) {
guard session?.target == frontmostApp else { return cancel() }
postBackspaceEvents(count: session?.deleteCount ?? 0)
postUnicodeKeyboardEvent(text)
}
더 나은 상태 모델을 만들게 한 버그
v1.3 변경 내역에 기록된 한 문제가 업데이터 상태 모델의 사각지대를 드러냈습니다. 업데이트가 없다는 결과가 나온 후에도 Checking...이 계속 표시되거나, Available이 알 수 없는 상태로 남을 수 있었습니다. 작은 버그였지만 신뢰에 미치는 영향은 컸습니다.
이 문제를 고치면서 레이블을 그때그때 땜질하는 대신 상태 머신을 엄격하게 다듬어야 했습니다. 이를 계기로 앱 전체에서 UI 상태를 다루는 방식이 바뀌었습니다. 명시적인 상태 전환, 추론에 의존하는 상태의 축소, 비동기 확인과 표시되는 상태 간의 더 확실한 동기화입니다.
- 증상: 업데이트 없음 확인이 성공한 후에도 업데이터 상태 텍스트가 이전 상태로 남음.
- 근본 원인: 비동기 업데이트 콜백에서의 불완전한 상태 전환.
- 결과: 이제 명시적인 상태 전환이 상태 표시를 결정합니다.
성능 참고 사항
중요한 지표는 트리거부터 이모지가 삽입될 때까지의 시간입니다. 그래서 브라우저 엔진 기반 스택 대신 네이티브 Swift + AppKit 런타임을 고수했습니다.
Mac15,11(Apple M3 Max), macOS 26.2 빌드 25C56에서 배포용 ZIP의 v1.3.1을 사용해 측정했습니다. 아래의 실행 시간은 open -n부터 앱 프로세스가 나타날 때까지, 즉 프로세스가 보이기까지의 시작 시간을 의미합니다.
세션 중 첫 실행
217.68 ms(1회 측정, 프로세스가 보이기까지의 시작 시간).
웜 재실행
재실행 7회의 중앙값 110.02 ms.
유휴 메모리
ps 기준 110.4 MB RSS. 같은 실행에서 활성 상태 보기에는 실제 메모리 99.4 MB, 전용 메모리 29.6 MB로 표시되었습니다.
패키지 크기
ZIP 4.49 MB, 디스크상의 앱 번들 12.96 MB.
메모리 지표는 산정 방식이 서로 다르므로 측정값 그대로 제시합니다. 여기서 RSS의 대부분은 공유된 AppKit 프레임워크 메모리이며, 테스트에서 전용 메모리는 30 MB 미만으로 유지되었습니다.
macOS 유틸리티를 위한 Swift + AppKit vs Electron
항상 켜져 있는 유틸리티 도구에서는 UI 이식성보다 런타임의 특성이 더 중요합니다. 다음과 같은 실용적인 이유로 네이티브 Swift + AppKit을 선택했습니다:
- 작은 배포 파일, JavaScript 런타임 워밍업 없이 바로 시작하는 경로.
- macOS 네이티브 API를 사용한 손쉬운 사용 및 텍스트 삽입의 직접 통합.
- 가벼운 키보드 유틸리티에 브라우저 엔진을 내장한 프로세스 트리는 필요 없습니다.
내장 도구, Raycast, Emoji Picker의 시작 시간 측정 결과는 비교 페이지를 참조하세요.
설계상의 절충
메뉴 막대를 택한 이유
메뉴 막대 도구는 계속 실행해 두기 쉽고 빠르게 불러올 수 있습니다. 이 제품에서는 그것이 실제 사용 방식과 맞았습니다. 사용자는 채팅, 티켓, 커밋 메시지, 문서를 작성하는 동안 반복해서 앱을 호출하기 때문입니다.
의도적으로 최소한의 UI를 택한 이유
선택을 늦추는 장식 요소는 거의 모두 없앴습니다. 매일 직접 사용해 보니, 화려한 시각 효과보다 명확한 카테고리, 알기 쉬운 키보드 탐색, 최소한의 크롬이 더 효과적이었습니다.
기본 선택기가 여전히 나은 점
이모지를 가끔만 입력한다면 macOS 기본 선택기로도 충분하며 별도의 설정도 필요 없습니다. 이 앱은 하루 종일 이모지를 입력하면서 그때마다 흐름이 끊기는 불편을 반복해서 느끼는 사용자를 위한 것입니다.
로컬 우선을 택한 이유
로컬 우선은 타협할 수 없는 원칙이었습니다. 계정이 필요 없고, 클라우드에 의존하지 않으며, 입력 동작을 외부 서비스로 보내지 않습니다.
뜻밖에 알게 된 것
- 작은 상태 버그가 눈에 띄는 시각적 버그보다 신뢰를 더 크게 떨어뜨릴 수 있습니다.
- 파워 유저는 잘못된 활성화를 즉시 알아챕니다.
- 활성화 오작동이 사라질 때까지 아무도 새로운 기능을 요청하지 않았습니다.
가장 큰 교훈은 키보드 도구는 새로움이 아니라 일관성으로 평가받는다는 것입니다. 매번 같은 방식으로 동작하는 앱이 워크플로에서 확실한 자리를 차지합니다.
알려진 제약 사항
- 전역 트리거 모니터링과 앱 간 삽입을 위해 손쉬운 사용 권한이 필요합니다.
- 앱은 필드가 보안 필드인지 여부를 포함해 포커스된 필드의 메타데이터를 검사하지 않습니다. 트리거 모니터링을 원하지 않는 앱은 제외 목록에 추가할 수 있습니다.
- 일부 사용자 지정 텍스트 컨트롤은 합성된 Backspace 또는 유니코드 키보드 이벤트를 다르게 해석하여 삽입 신뢰성이 떨어질 수 있습니다.
- 트리거 감지 경로는 주로 라틴 문자 키보드 레이아웃에서 집중적으로 테스트되었습니다.
지원
Emoji Picker 지원 페이지에서 질문하거나 문제를 보고하거나 기능을 요청하세요. 계정이 필요하지 않습니다.
Emoji Picker 사용해 보기
문제를 발견하셨나요? 앱 버전, macOS 버전, 재현 단계와 함께 보고해 주세요.