Pakowanie i dystrybucja na platformy desktopowe

electron-builder to standardowe narzędzie do pakowania aplikacji Electron w instalatory przeznaczone do dystrybucji. Jego konfiguracja znajduje się w package.json pod kluczem "build" i określa metadane aplikacji (appId, productName), ścieżki ikon oraz formaty docelowe dla poszczególnych platform.

electron-builder obsługuje macOS (dmg i zip), Windows (instalator NSIS) oraz Linux (AppImage i deb). Można wskazać wiele platform w jednym poleceniu kompilacji albo skonfigurować CI tak, aby kompilował każdą platformę na właściwym dla niej runnerze, co zapewnia najlepszą zgodność.

macOS wymaga podpisywania kodu certyfikatem Apple Developer, aby Gatekeeper pozwolił użytkownikom otworzyć aplikację bez ostrzeżenia dotyczącego bezpieczeństwa. electron-builder odczytuje certyfikat z macOS Keychain podczas procesu kompilacji i automatycznie podpisuje wszystkie pliki binarne.

Oprócz podpisywania kodu współczesny macOS wymaga również notaryzacji — przesłania aplikacji do usługi notaryzacji Apple, która skanuje ją pod kątem złośliwego oprogramowania i wystawia bilet. electron-builder może zautomatyzować notaryzację za pośrednictwem electron-notarize, a użytkownicy macOS 10.15+ nie będą mogli bez niej uruchomić aplikacji.

Windows wymaga certyfikatu Authenticode od zaufanego urzędu certyfikacji (CA), aby SmartScreen ufał instalatorowi. Bez podpisu użytkownicy zobaczą ostrzeżenie „System Windows ochronił komputer”. Certyfikaty Extended Validation (EV) usuwają to ostrzeżenie natychmiast, natomiast standardowe certyfikaty OV budują zaufanie stopniowo.

Po pomyślnej kompilacji electron-builder zapisuje instalatory właściwe dla poszczególnych platform w katalogu dist/. Znajdują się tam plik DMG lub zip dla macOS, plik .exe instalatora NSIS dla Windows oraz AppImage lub .deb dla Linuxa, a także manifest automatycznych aktualizacji latest.yml (lub latest-mac.yml).

Aplikacje Electron wymagają ikon w formatach właściwych dla poszczególnych platform: PNG o rozmiarze 512x512 dla Linuxa, pliku ICNS (wielorozdzielczego) dla macOS oraz pliku ICO (wielorozdzielczego) dla Windows. electron-builder może wygenerować wszystkie formaty z pojedynczego pliku PNG o rozmiarze 1024x1024 przy użyciu flagi --icon.

Pakiet electron-updater integruje się z electron-builderem, zapewniając automatyczne aktualizacje. Należy opublikować kompilacje w GitHub Releases lub S3, a electron-updater będzie mógł sprawdzać aktualizacje przy uruchomieniu, pobierać aktualizację różnicową w tle i prosić użytkownika o ponowne uruchomienie.

Należy wywołać autoUpdater.checkForUpdatesAndNotify() w main.js po przygotowaniu aplikacji. electron-updater pobiera manifest latest.yml z docelowej lokalizacji publikacji, porównuje wersje, a jeśli aktualizacja jest dostępna, pobiera ją i wyświetla natywne powiadomienie, gdy będzie gotowa do zainstalowania.

electron-builder pakuje pliki JavaScript aplikacji w pojedyncze archiwum ASAR (podobne do pliku tar) przeznaczone do dystrybucji. Poprawia to wydajność uruchamiania, ograniczając liczbę operacji wyszukiwania plików, i utrudnia bezpośrednie przeglądanie kodu źródłowego, choć go nie uniemożliwia.

Natywnych modułów Node.js (plików .node) nie można ładować z wnętrza archiwum ASAR — muszą zostać wypakowane do systemu plików. W konfiguracji electron-builder należy ustawić asarUnpack i podać wzorce natywnych modułów. Zostaną one umieszczone w katalogu app.asar.unpacked obok archiwum.

Dystrybucja aplikacji Electron obejmuje konfigurację celów electron-builder, podpisanie kodu dla macOS (wraz z notaryzacją) i Windows (za pomocą Authenticode), a także opcjonalne skonfigurowanie automatycznych aktualizacji z electron-updater. Archiwum ASAR pakuje aplikację na potrzeby dystrybucji, a moduły natywne są wypakowywane osobno. Solidny potok CI/CD automatycznie obsługuje te kroki dla każdej platformy.