데스크톱 플랫폼용 패키징 및 배포

electron-builder는 Electron 앱을 배포 가능한 설치 프로그램으로 패키징하는 표준 도구입니다. 구성은 package.json의 "build" 키에 있으며, 앱 메타데이터(appId, productName), 아이콘 경로, 플랫폼별 대상 형식을 지정합니다.

electron-builder는 macOS(dmg 및 zip), Windows(NSIS 설치 프로그램), Linux(AppImage 및 deb)를 지원합니다. 하나의 빌드 명령으로 여러 플랫폼을 대상으로 지정하거나, 최상의 호환성을 위해 CI가 각 플랫폼의 네이티브 실행 환경에서 플랫폼별로 빌드하도록 구성할 수 있습니다.

Gatekeeper가 보안 경고 없이 사용자가 앱을 열 수 있도록 macOS에서는 Apple Developer 인증서를 사용한 코드 서명이 필요합니다. electron-builder는 빌드 과정에서 macOS 키체인에서 인증서를 읽고 모든 바이너리에 자동으로 서명합니다.

코드 서명 외에도 최신 macOS에서는 공증이 필요합니다. 앱을 Apple의 공증 서비스에 제출하면 악성 코드를 검사하고 티켓을 발급합니다. electron-builder는 electron-notarize를 통해 공증을 자동화할 수 있으며, macOS 10.15 이상 사용자는 공증 없이는 앱 실행이 차단됩니다.

Windows에서 SmartScreen이 설치 프로그램을 신뢰하려면 신뢰할 수 있는 인증 기관(CA)의 Authenticode 인증서가 필요합니다. 서명하지 않으면 사용자에게 "Windows protected your PC" 경고가 표시됩니다. 확장 검증(EV) 인증서는 경고를 즉시 없애지만, 표준 OV 인증서는 시간이 지나면서 신뢰를 쌓습니다.

빌드가 성공하면 electron-builder는 플랫폼별 설치 프로그램을 dist/ 디렉터리에 기록합니다. macOS용 DMG 또는 zip, Windows용 NSIS .exe, Linux용 AppImage 또는 .deb와 함께 자동 업데이트 매니페스트인 latest.yml(또는 latest-mac.yml)을 확인할 수 있습니다.

Electron 앱에는 플랫폼별 형식의 아이콘이 필요합니다. Linux용 512x512 PNG, macOS용 ICNS 파일(다중 해상도), Windows용 ICO 파일(다중 해상도)입니다. electron-builder는 --icon 플래그를 사용해 하나의 1024x1024 PNG에서 모든 형식을 생성할 수 있습니다.

electron-updater 패키지는 electron-builder와 통합되어 자동 업데이트를 제공합니다. 빌드를 GitHub 릴리스 또는 S3에 게시하면 electron-updater가 시작할 때 업데이트를 확인하고, 백그라운드에서 차등 업데이트를 다운로드하며, 사용자에게 다시 시작하라는 메시지를 표시할 수 있습니다.

앱이 준비된 후 main.js에서 autoUpdater.checkForUpdatesAndNotify()를 호출하세요. electron-updater는 게시 대상에서 최신 latest.yml 매니페스트를 가져와 버전을 비교하고, 업데이트가 있으면 다운로드한 뒤 설치할 준비가 되었을 때 네이티브 알림을 표시합니다.

electron-builder는 배포를 위해 애플리케이션의 JavaScript 파일을 하나의 ASAR 아카이브(tar 파일과 유사함)로 묶습니다. 이렇게 하면 파일 시스템 조회가 줄어 시작 성능이 향상되고, 소스 코드를 직접 확인하기가 더 어려워집니다(불가능한 것은 아닙니다).

네이티브 Node.js 모듈(.node 파일)은 ASAR 아카이브 내부에서 로드할 수 없으므로 파일 시스템에 압축을 풀어야 합니다. electron-builder에서 asarUnpack을 구성해 네이티브 모듈 패턴을 나열하면 해당 모듈이 아카이브와 나란히 있는 app.asar.unpacked 디렉터리에 배치됩니다.

Electron 앱을 배포하려면 electron-builder 대상을 구성하고, macOS(공증 포함)와 Windows(Authenticode)에 맞게 코드에 서명하며, 필요에 따라 electron-updater로 자동 업데이트를 설정해야 합니다. ASAR 아카이브는 앱을 배포용으로 묶고, 네이티브 모듈은 별도로 압축을 풉니다. 견고한 CI/CD 자동화 절차가 플랫폼별로 이 단계를 자동 처리합니다.