Työpöytäalustojen paketointi ja jakelu

electron-builder on vakiotyökalu Electron-sovellusten pakkaamiseen ja jaettavien asennusohjelmien luomiseen. Sen määritys sijaitsee package.json-tiedostossa "build"-avaimen alla, ja siinä määritetään sovelluksen metatiedot (appId, productName), kuvakkeiden polut sekä alustakohtaiset kohdemuodot.

electron-builder tukee macOS:ää (dmg ja zip), Windowsia (nsis-asennusohjelma) ja Linuxia (AppImage ja deb). Voitte kohdistaa koonnin useille alustoille yhdellä build-komennolla tai määrittää CI:n kokoamaan sovelluksen kullakin alustalla sen omassa natiivissa runner-ympäristössä parhaan yhteensopivuuden varmistamiseksi.

macOS edellyttää koodin allekirjoittamista Apple Developer -varmenteella, jotta Gatekeeper sallii käyttäjien avata sovelluksen ilman suojausvaroitusta. electron-builder lukee varmenteen macOS Keychainista koontiprosessin aikana ja allekirjoittaa kaikki binäärit automaattisesti.

Koodin allekirjoittamisen lisäksi moderni macOS edellyttää myös notarointia – sovellus lähetetään Applen notarointipalveluun, joka tarkistaa sen haittaohjelmien varalta ja myöntää lipukkeen. electron-builder voi automatisoida notaroinnin electron-notarize-paketin avulla, ja macOS 10.15+:n käyttäjät eivät voi avata sovellusta ilman sitä.

Windows edellyttää luotetulta varmentajalta (CA) hankittua Authenticode-varmennetta, jotta SmartScreen luottaa asennusohjelmaan. Ilman allekirjoitusta käyttäjälle näytetään "Windows suojasi tietokonettasi" -varoitus. Extended Validation (EV) -varmenteet poistavat varoituksen heti, kun taas tavalliset OV-varmenteet rakentavat luottamusta ajan mittaan.

Onnistuneen koonnin jälkeen electron-builder kirjoittaa alustakohtaiset asennusohjelmat dist/-hakemistoon. Sieltä löytyvät macOS:n DMG- tai zip-tiedosto, Windowsin NSIS .exe -tiedosto ja Linuxin AppImage- tai .deb-tiedosto sekä automaattisten päivitysten manifesti latest.yml (tai latest-mac.yml).

Electron-sovellukset tarvitsevat alustakohtaisissa muodoissa olevat kuvakkeet: Linuxille 512x512 PNG-tiedoston, macOS:lle ICNS-tiedoston (useita resoluutioita) ja Windowsille ICO-tiedoston (useita resoluutioita). electron-builder voi luoda kaikki muodot yhdestä 1024x1024 PNG-tiedostosta --icon-lipun avulla.

electron-updater-paketti integroituu electron-builderiin ja tarjoaa automaattiset päivitykset. Julkaiskaa koontiversiot GitHub Releasesiin tai S3:een, jolloin electron-updater voi tarkistaa päivitykset käynnistyksen yhteydessä, ladata delta-päivityksen taustalla ja pyytää käyttäjää käynnistämään sovelluksen uudelleen.

Kutsukaa autoUpdater.checkForUpdatesAndNotify()-funktiota main.js-tiedostossa, kun sovellus on valmis. electron-updater hakee latest.yml-manifestin julkaisukohteesta, vertaa versioita ja, jos päivitys on saatavilla, lataa sen ja näyttää natiivin ilmoituksen, kun päivitys on valmis asennettavaksi.

electron-builder niputtaa sovelluksen JavaScript-tiedostot yhteen ASAR-arkistoon (tar-tiedoston kaltaiseen) jakelua varten. Tämä parantaa käynnistyksen suorituskykyä vähentämällä tiedostojärjestelmähakuja ja vaikeuttaa lähdekoodin suoraa tarkastelua, mutta ei tee siitä mahdotonta.

Natiivimoduuleja (.node-tiedostoja) ei voi ladata ASAR-arkiston sisältä – ne on purettava tiedostojärjestelmään. Määrittäkää electron-builderissa asarUnpack-asetus ja luetelkaa siinä natiivimoduulien kuviot. Tällöin moduulit sijoitetaan app.asar.unpacked-hakemistoon arkiston rinnalle.

Electron-sovelluksen jakelu edellyttää electron-builderin kohteiden määrittämistä, koodin allekirjoittamista sekä macOS:lle (notarointi mukaan lukien) että Windowsille (Authenticode) ja haluttaessa automaattisten päivitysten määrittämistä electron-updaterilla. ASAR-arkisto niputtaa sovelluksen jakelua varten, ja natiivimoduulit puretaan erikseen. Hyvä CI/CD-putki käsittelee nämä vaiheet automaattisesti alustakohtaisesti.