프로젝트 소개

electron-builder는 Electron 데스크톱 애플리케이션을 macOS, Windows, Linux용 배포 가능한 아티팩트로 패키징하고 빌드하며, 즉시 사용 가능한 자동 업데이트 지원을 포함합니다. npm 패키지로 배포되며 일반적으로 개발 의존성으로 설치됩니다. README에 설명된 주요 기능: - NPM 패키지 관리: 네이티브 애플리케이션 의존성을 컴파일하고(Yarn 지원), 개발 의존성을 절대 포함하지 않으며, two-package.json 구조를 요구하지 않으면서 지원합니다. - CI 서버 또는 개발 머신에서의 코드 서명. - 자동 업데이트 준비가 된 애플리케이션 패키징. - 다양한 대상 형식: 크로스 플랫폼 7z, zip, tar.xz, tar.7z, tar.lz, tar.gz, tar.bz2 및 unpacked dir; macOS dmg, pkg 및 mas; Linux AppImage, snap, deb, rpm, freebsd, pacman, p5p 및 apk; Windows nsis 설치 프로그램, nsis-web 웹 설치 프로그램, portable, AppX, MSI 및 Squirrel.Windows. - GitHub Releases, Amazon S3, DigitalOcean Spaces 및 Bintray에 아티팩트 게시. - 고급 빌드: 이미 패키징된 앱 패킹, 빌드 단계 분리, CI에서 하드 링크를 사용한 병렬 빌드/게시로 IO 및 디스크 사용량 감소. - 모든 플랫폼에서 Linux 또는 Windows 앱을 빌드하기 위한 Docker 이미지. - 필요한 도구 파일(예: Windows 코드 서명 또는 AppX용)의 자동 온디맨드 다운로드, 수동 설정 불필요. 요구 사항 및 설정: v27에는 Node.js >= 22.12.0이 필요하며, 이는 호환성을 깨는 변경 사항(네이티브 ESM, Node 버전 상향, 사용 중단된 API 제거)이 있는 주요 릴리스이고 마이그레이션 명령을 제공합니다. Yarn 3 사용자는 nodeLinker를 node-modules로 설정해야 합니다. 구성은 package.json의 build 필드 또는 별도의 js, ts, yml, json/json5 파일에 있으며, ESM과 CommonJS 모두를 위한 TypeScript 타입이 있는 프로그래밍 방식 API를 사용할 수 있습니다. 디버깅은 DEBUG, FPM_DEBUG 및 DEBUG_DMG 환경 변수를 통해 지원됩니다. 이 프로젝트는 electron-react-boilerplate, electron-vue-vite, vite-electron-builder 및 electronjs-with-nextjs와 같은 커뮤니티 보일러플레이트를 안내하며, 기여와 기부를 환영합니다.