사이드 프로젝트가 늘 "출시 직전"에서 끝납니다

맥 앱을 만들어보고 싶다는 생각은 오래됐는데, 막상 시작하면 늘 같은 곳에서 멈춥니다.

- 튜토리얼은 따라 했는데 "내 앱"으로 넘어가는 다리가 없습니다.

- 로컬에서는 잘 돌던 기능이 샌드박스를 켜는 순간 조용히 죽습니다.

- 서명, 프로비저닝, 심사 — 코드 밖의 절차에서 며칠씩 새어 나갑니다.

- 그러다 "나중에 하자"가 되고, 앱은 영영 앱스토어에 못 올라갑니다.

문제는 코딩 실력이 아니라 끝까지 가본 경험의 부재입니다.

■ 흔한 오해: "앱스토어 출시는 큰 프로젝트다"

이 앱은 커밋한 날짜 기준 9일 만에 앱스토어까지 갔습니다. 113커밋, 추가 31,899줄. 대단한 아키텍처가 아니라, 막힐 때마다 하나씩 풀어낸 기록입니다. 그중 30건(27%)이 수정 커밋이었고, 이 책은 그 수정들을 숨기지 않고 그대로 목차로 만들었습니다.

■ 이 책의 가장 큰 강점 — 똑같이 만들 수 있게 프롬프트를 드립니다

각 장에는 "이렇게 시켜보세요" 박스가 있습니다. 그 기능을 AI 코딩 도구(Claude Code, Cursor 등)에게 시킬 때 그대로 붙여넣을 수 있는 프롬프트 예제 9개 — 전체 계획 수립부터 노치 창 붙이기, 디버깅, 샌드박스 대비, 심사 회신까지. 저자도 이 앱 구현의 대부분을 AI에게 맡겼습니다(출력 토큰 809,290개 실측). 코드를 몰라도, 바이브 코딩으로 이 앱을 똑같이 만들 수 있습니다.

■ 어떤 막힘들이었나

- 창을 노치에 붙이라고 좌표를 계산했는데 AppKit이 조용히 창을 끌어내려서 며칠을 헤맬 뻔한 일 — 답은 세 줄짜리 오버라이드였습니다.

- 화면에 분명히 그려져 있는데 아무 입력도 안 받는 버튼 — SwiftUI 히트테스트의 함정과, 로그 이분탐색으로 원인을 좁힌 과정.

- 3시간 들여 만든 유리 질감 디자인을 다음 날 아침 1시간 반 만에 걷어낸 이야기 — 배경화면을 통제할 수 없으면 반투명은 집니다.

- 무료판과 유료판의 경계를 마케팅이 아니라 App Sandbox가 그은 사연.

- 심사 리젝 2건 — 코드를 한 줄도 안 고치고 문서로 통과한 방법과, 앱 이름에 "Mac"을 쓰면 안 된다는 것을 리젝으로 배운 기록.

- 프로젝트 이름이 오타였다는 걸 제출 직전 새벽에 발견한 사건.

그리고 2부에서는 같은 원리로 미니 노치 HUD를 빈 폴더에서 직접 만듭니다. 실습 코드 전문이 함께 갑니다.

■ 실측

- 커밋한 날 9일, 113커밋, 추가 31,899줄 / 삭제 3,589줄

- 수정·되돌리기 커밋 30건(27%) — 제목이 fix로 시작하는 27건을 전수 분석해 본문에 실었습니다

- 앱스토어 제출 2회, 심사 이슈 2건 (모두 메타데이터, 코드 문제 0건)

- Claude Code 세션 8건, 출력 토큰 809,290개 (중복 제거 실측)

- 필수 비용: Apple Developer Program 연회비뿐

숫자는 전부 git 이력과 로그에서 꺼냈고, 세는 방법(중복 제거 기준)까지 본문에 적었습니다.

■ 앱도, 소스도 먼저 확인하세요

이 책의 결과물은 맥 앱스토어에 실제로 올라가 있습니다. 무료이고 로그인도 없습니다.

apps.apple.com/kr/app/notchit-hud/id6762633044

무료판 소스 전체도 GitHub에 공개돼 있습니다 — 앱스토어에 제출된 그 리비전 그대로, MIT 라이선스입니다.

github.com/illuwa/notchit-pub

■ 목차

[1부 — 기록]

1. 9일의 지도 — 하루 몰아치기 세 번과 긴 공백, 첫날 약 7시간에 나온 제출 뼈대

2. 노치에 붙이는 물리학 — AppKit이 조용히 창을 끌어내리는 지점, 평평한 바닥 착지, 1pt 겹침

3. 안 눌리는 버튼의 정체 — contentShape 히트테스트, 클릭 통과, 스크롤 라우팅, onKeyDown

4. 예쁨이 가독성에 지던 날 — 3시간 만든 재질 시스템을 다음 날 걷어낸 기록, 핫스팟 통계

5. 샌드박스가 제품을 설계한다 — 허용 API 7종과 차단 3종, 무료/유료 경계, 죽은 토글 함정

6. 심사장에서 생긴 일 — 이름 오타 사건, VPN 문의를 문서로 이긴 방법, 상표 리젝

7. 얼마나 들었나 — 시간·커밋·AI 토큰·돈 전부 실측

[2부 — 실습, 코드 전문 동봉]

8. 뼈대 — 창을 노치에 붙인다 (빈 폴더에서 빌드 한 줄까지)

9. 지표 — CPU 사용률을 읽는다 (공개 API + 순수 함수 + 오버플로 함정)

10. 인터랙션 — 눌리는 것과 통과하는 것, 일부러 부수는 실험 2가지

11. 오늘 할 일 — 30분 / 이번 주 / 이번 달 적용 플랜

부록 A: 맥 앱스토어 제출 전 체크리스트 (실제 겪은 항목만)

부록 B: 지표 수집 API 한눈에 (샌드박스 가능/차단)

부록 C: 동봉 실습 코드 안내

A4 36페이지, 도형 6점 + 실구동 화면 7장 + 프롬프트 예제 박스 9개 + 실습 코드 ZIP 동봉. Notchit HUD 1.1.0 기준입니다.

■ 솔직히 말씀드립니다 — 이 책에 없는 것

Swift 문법 강의가 아닙니다. 기초는 Apple 공식 튜토리얼(developer.apple.com/tutorials/swiftui)이 무료이고 더 낫습니다.

소스 코드 해설서가 아닙니다. 무료판 소스는 위 공개 저장소에서 무료로 읽으실 수 있습니다. 이 책은 코드가 아니라 그 코드에 이르는 과정 — 막힌 지점, 되돌린 결정, 심사 대응 — 과 그것을 직접 재현하는 2부 실습을 담습니다.

앱스토어 심사 규정집이 아닙니다. 정식 지침은 Apple이 무료로 공개합니다. 이 책에 있는 건 실제 제출에서 그 지침이 어떻게 부딪히는지의 사례입니다.

Pro 버전 이야기가 아닙니다. 책의 모든 화면과 구현은 무료판 기준입니다.

■ 이런 분께

- 코드를 잘 몰라도 AI와 함께 내 맥 앱을 만들어 보고 싶은 분 — 장마다 붙여넣을 프롬프트가 있습니다

- SwiftUI 문법은 아는데 앱 하나를 끝까지 못 가본 분

- 맥 앱스토어 제출·샌드박스·서명 절차가 막막한 분

- 사이드 프로젝트를 "출시"까지 끌고 가는 감각을 얻고 싶은 분

■ 이런 분께는 권하지 않습니다

- 프로그래밍 자체가 처음이라 기초 개념부터 필요하신 분 — 공식 튜토리얼을 먼저 보시는 게 맞습니다

- 코드만 읽고 싶으신 분 — 공개 저장소(github.com/illuwa/notchit-pub)가 무료입니다

- iOS 앱을 만드시려는 분 — 이 책은 macOS 전용 이야기입니다

■ 가격

0원입니다.

무료로 드리는 이유는 분명합니다. 앱(Notchit HUD)도 무료판 소스도 이미 무료로 풀었습니다. 이 책을 읽고 노치 앱을 만들어 보는 분이 늘고, 앱을 쓰는 분이 늘고, 다음 책을 기다리는 독자가 느는 쪽이 책값 몇천 원보다 저에게 이득입니다.

■ 환불 정책

무료 상품이라 결제가 없고 따라서 환불도 없습니다. 받으신 PDF와 실습 코드는 그대로 공유하셔도 됩니다.

■ 자주 묻는 질문

Q. 정말 무료인가요?

네. 결제 절차가 없습니다. 앱도, 무료판 소스도, 이 책도 전부 무료입니다.

Q. 실습 코드도 함께 오나요?

네. 받으시는 압축 파일 안에 전자책 PDF와 함께 2부 실습 앱(NotchMini)의 코드 전문이 들어 있습니다. 학습·개인 프로젝트에 자유롭게 수정해 쓰시면 됩니다.

Q. 어떤 맥이 필요한가요?

앱 자체는 macOS 13 이상이면 됩니다. 노치가 없는 맥에서는 메뉴바 모드로 돌아갑니다. 2부 실습은 Xcode(또는 Command Line Tools)가 도는 맥이면 충분하고, 노치 없는 맥용 폴백 경로도 코드에 들어 있습니다.

Q. AI 도구 없이도 따라갈 수 있나요?

네. 책의 내용은 노치 창 처리·히트테스트·샌드박스·심사 같은 macOS 개발 지식이고, 프롬프트 박스는 선택지입니다. 2부 실습도 AI 없이 그대로 따라갈 수 있습니다.

Q. 책 내용이 낡지 않나요?

이 책은 API 레퍼런스가 아니라 특정 앱(Notchit HUD 1.1.0)을 출시까지 끌고 간 과정의 기록이라, macOS 버전이 올라가도 서사와 원칙(히트테스트 디버깅, 샌드박스 경계 설계, 심사 대응)은 그대로 유효합니다. 앱이 크게 바뀌면 판을 갱신합니다.