Pakning og distribution til desktopplatforme

electron-builder er standardværktøjet til at pakke Electron-apps som installationsprogrammer, der kan distribueres. Konfigurationen ligger i package.json under nøglen "build" og angiver metadata for appen (appId, productName), ikonstier og målformater for hver platform.

electron-builder understøtter macOS (dmg og zip), Windows (nsis-installationsprogram) og Linux (AppImage og deb). Du kan målrette flere platforme med én build-kommando eller konfigurere CI til at bygge hver platform på dens egen runner for at opnå den bedste kompatibilitet.

macOS kræver kodesignering med et Apple Developer-certifikat, for at Gatekeeper lader brugere åbne appen uden en sikkerhedsadvarsel. electron-builder læser dit certifikat fra macOS Keychain under buildprocessen og signerer automatisk alle binære filer.

Ud over kodesignering kræver moderne macOS også notarisering — du indsender appen til Apples notariseringsservice, som scanner den for skadelig software og udsteder en billet. electron-builder kan automatisere notarisering via electron-notarize, og brugere på macOS 10.15 eller nyere bliver blokeret uden den.

Windows kræver et Authenticode-certifikat fra en betroet certifikatautoritet (CA), for at SmartScreen kan have tillid til dit installationsprogram. Uden signering får brugerne advarslen "Windows protected your PC". Extended Validation-certifikater (EV) fjerner advarslen med det samme, mens almindelige OV-certifikater opbygger tillid over tid.

Efter et vellykket build skriver electron-builder platformsspecifikke installationsprogrammer til mappen dist/. Her finder du DMG- eller zip-filen til macOS, NSIS-.exe-filen til Windows og AppImage- eller .deb-filen til Linux sammen med et manifest til automatisk opdatering, latest.yml (eller latest-mac.yml).

Electron-apps skal have ikoner i platformspecifikke formater: en 512x512 PNG-fil til Linux, en ICNS-fil (i flere opløsninger) til macOS og en ICO-fil (i flere opløsninger) til Windows. electron-builder kan generere alle formater ud fra en enkelt PNG-fil på 1024x1024 med flaget --icon.

Pakken electron-updater integreres med electron-builder for at levere automatiske opdateringer. Udgiv dine builds på GitHub Releases eller S3, så kan electron-updater søge efter opdateringer ved opstart, hente deltaopdateringen i baggrunden og bede brugeren om at genstarte.

Kald autoUpdater.checkForUpdatesAndNotify() i main.js, når appen er klar. electron-updater henter manifestet latest.yml fra dit udgivelsesmål, sammenligner versionerne og henter en tilgængelig opdatering. Derefter viser den en systemnotifikation, når opdateringen er klar til installation.

electron-builder samler din apps JavaScript-filer i et enkelt ASAR-arkiv (svarende til en tar-fil) til distribution. Det forbedrer opstartshastigheden ved at reducere antallet af opslag i filsystemet og gør det sværere, men ikke umuligt, at inspicere din kildekode direkte.

Native Node.js-moduler (.node-filer) kan ikke indlæses fra et ASAR-arkiv — de skal pakkes ud til filsystemet. Konfigurer asarUnpack i electron-builder for at angive mønstre for native moduler. Så placeres de i mappen app.asar.unpacked ved siden af arkivet.

Distribution af en Electron-app indebærer konfiguration af electron-builder-mål, signering af koden til både macOS (med notarisering) og Windows (Authenticode) samt eventuelt opsætning af automatiske opdateringer med electron-updater. ASAR-arkivet samler appen til distribution, mens native moduler pakkes ud separat. En solid CI/CD-pipeline håndterer automatisk disse trin for hver platform.