06-packaging-distribution — binary로 배포하고, 신뢰 체인을 직접 짓는다

웹은 URL 하나로 끝난다. 사용자가 새로고침하면 새 버전이 떠 있다. Electron은 binary 하나를 사용자 디스크에 깔고, OS가 그 binary를 신뢰하게 만들고, 그 binary가 스스로 갱신되도록 인프라를 직접 세워야 한다. 이 챕터는 그 인프라의 7개 결정을 분해한다.

한 줄 답 (Pyramid Top)

Electron 배포는 단일 단계가 아니라 7개 결정의 사슬이다 — ① bundler 선택 → ② asar 패키징 → ③ OS별 installer → ④ code signing → ⑤ macOS notarization → ⑥ auto-update → ⑦ 멀티 아키텍처/채널 publishing. 이 사슬에서 한 고리만 빠져도 사용자는 “열 수 없는 앱”·“오래된 버전”·“보안 경고”를 만난다.

Why — 왜 패키징이 별도 챕터인가

웹 개발자가 Electron으로 넘어올 때 가장 과소평가하는 영역이다. 세 가지 비대칭이 이유다.

이 비대칭의 핵심은 — 사용자 디바이스에 binary가 살기 시작하는 순간 운영의 책임이 시작된다는 점이다. 보안 패치, OS 업데이트, 인증서 만료, CDN 비용까지 전부 내 책임이 된다.

05 보안에서 다룬 런타임 격리가 “공격면을 좁힌다”라면, 이 챕터는 배포 체인에서 “binary가 도중에 변조되지 않았음을 증명한다”이다. 둘은 보완 관계다.

How — 어떻게 정리했나

이 챕터는 배포 파이프라인의 흐름 순서로 7개 문서를 배치했다.

What — 핵심 개념 한 줄 요약

What-if — 한 고리만 빠지면

Insight — 흥미로운 이야기

“Squirrel은 다람쥐가 도토리를 옮기듯 조용히 업데이트하라는 뜻이다”

GitHub이 2014년 Atom 에디터를 위해 만든 Squirrel는 사용자가 인지하지 못하는 사이에 업데이트를 받는다는 디자인 철학에서 이름이 왔다. Slack·Discord·VS Code가 모두 Squirrel(.Windows) 모델을 채택했고 — 그래서 이 앱들은 관리자 권한 없이 사용자 폴더(%LOCALAPPDATA%)에 설치되고, 재시작할 때마다 새 버전이 들어가 있는 경험을 만든다.

“asar는 보안이 아니다 — 누구나 풀 수 있다”

npx @electron/asar extract app.asar ./out 한 줄이면 모든 JS 소스가 그대로 나온다. Electron 앱의 비즈니스 로직을 가리고 싶다면 난독화나 V8 bytecode 컴파일 (bytenode 등)을 별도로 적용해야 한다. asar의 역할은 “수만 개의 작은 파일을 fs 시스템 콜 한 번에 읽는 성능 최적화”지 보안 봉인이 아니다.

“Apple Developer Program $99/yr이 사실상 macOS 배포의 입장료다”

Microsoft Store, Mac App Store, Apple Developer Program이 전부 별도 비용이다. 게다가 Apple은 개인 인증서로는 notarize 불가 — 반드시 organization 단위 enrollment가 필요하다. Electron 앱을 출시한다는 결정은 곧 연 $400+ (Apple$99 + Windows EV $300+) 의 운영 비용 시작이라는 뜻이다.

다음 챕터로 가는 다리

이 챕터의 결과물은 다음과 직접 연결된다.

• 07 성능 & 메모리 → delta update는 그 자체로 시작 시간/네트워크 절감 — 성능 챕터의 일부
• 08 생태계 & 대안 → Tauri는 OS webview를 쓰므로 binary가 5MB, Electron은 100MB+ — 배포 비용 비교
• 05 보안 → 런타임 격리(context isolation)와 배포 신뢰(code signing)는 동일한 신뢰 문제의 두 끝

한 단락 요약

Electron 배포는 한 번 빌드해서 끝이 아니라 7개 결정의 사슬을 운영하는 일이다. bundler를 고르고 → asar로 묶고 → OS별 installer를 만들고 → 코드를 서명하고 → (mac) notarize하고 → auto-update를 깔고 → 다중 아키텍처와 채널로 배포한다. 이 사슬은 한 고리만 빠져도 사용자에게 부러진다 — 그래서 패키징은 마지막에 하는 일이 아니라 설계 첫날부터 같이 가는 인프라다. 이 챕터의 7개 문서는 그 사슬을 하나씩 분해한다.