Masaüstü Platformları için Paketleme ve Dağıtım

electron-builder, Electron uygulamalarını dağıtılabilir yükleyiciler halinde paketlemek için kullanılan standart araçtır. Yapılandırması, package.json dosyasında "build" anahtarı altında bulunur ve uygulama üst verilerini (appId, productName), simge yollarını ve platforma özel hedef biçimleri belirtir.

electron-builder; macOS'u (dmg ve zip), Windows'u (NSIS yükleyicisi) ve Linux'u (AppImage ve deb) destekler. Tek bir derleme komutuyla birden çok platformu hedefleyebilir veya en iyi uyumluluk için CI'ı her platformda kendi yerel çalıştırıcısında derleme yapacak şekilde yapılandırabilirsiniz.

Gatekeeper'ın kullanıcıların uygulamayı güvenlik uyarısı olmadan açmasına izin vermesi için macOS, bir Apple Developer sertifikasıyla kod imzalanmasını gerektirir. electron-builder, derleme işlemi sırasında sertifikanızı macOS Keychain'den okur ve tüm ikili dosyaları otomatik olarak imzalar.

Kod imzalamanın yanı sıra modern macOS, uygulamanın kötü amaçlı yazılım taraması yapan ve bir bilet veren Apple notarizasyon hizmetine gönderilmesini de gerektirir. electron-builder, electron-notarize aracılığıyla notarizasyonu otomatikleştirebilir; macOS 10.15 ve sonraki sürümlerdeki kullanıcılar bu işlem olmadan uygulamayı açamaz.

SmartScreen'in yükleyicinize güvenmesi için Windows, güvenilir bir Sertifika Yetkilisinden (CA) alınmış bir Authenticode sertifikası gerektirir. İmzalama yapılmazsa kullanıcılar "Windows protected your PC" uyarısını görür. Genişletilmiş Doğrulama (EV) sertifikaları uyarıyı hemen kaldırırken standart OV sertifikaları zaman içinde güven oluşturur.

Başarılı bir derlemeden sonra electron-builder, platforma özel yükleyicileri dist/ dizinine yazar. macOS için DMG veya zip dosyasını, Windows için NSIS .exe dosyasını ve Linux için AppImage veya .deb dosyasını, ayrıca bir latest.yml (veya latest-mac.yml) otomatik güncelleme bildirim dosyasını burada bulabilirsiniz.

Electron uygulamaları platforma özel biçimlerde simgelere ihtiyaç duyar: Linux için 512x512 PNG, macOS için bir ICNS dosyası (çok çözünürlüklü) ve Windows için bir ICO dosyası (çok çözünürlüklü). electron-builder, --icon seçeneğini kullanarak tek bir 1024x1024 PNG dosyasından tüm biçimleri oluşturabilir.

electron-updater paketi, otomatik güncellemeler sağlamak için electron-builder ile bütünleşir. Derlemelerinizi GitHub Releases'a veya S3'e yayımlayın; electron-updater başlangıçta güncellemeleri denetleyebilir, artımlı güncellemeyi arka planda indirebilir ve kullanıcıdan uygulamayı yeniden başlatmasını isteyebilir.

Uygulama hazır olduktan sonra main.js içinde autoUpdater.checkForUpdatesAndNotify() çağrısını yapın. electron-updater, yayımlama hedefinizden latest.yml bildirim dosyasını alır, sürümleri karşılaştırır ve bir güncelleme varsa güncellemeyi indirip yüklenmeye hazır olduğunda yerel bir bildirim gösterir.

electron-builder, dağıtım için uygulamanızın JavaScript dosyalarını tek bir ASAR arşivinde (tar dosyasına benzer) birleştirir. Bu, dosya sistemi aramalarını azaltarak başlangıç performansını artırır ve kaynak kodunuzu doğrudan incelemeyi zorlaştırır (ancak imkânsız hâle getirmez).

Yerel Node.js modülleri (.node dosyaları) bir ASAR arşivinin içinden yüklenemez; dosya sistemine çıkarılmaları gerekir. electron-builder içinde asarUnpack yapılandırmasını kullanarak yerel modül desenlerini listeleyin; bu işlem onları arşivin yanında bulunan app.asar.unpacked dizinine yerleştirir.

Bir Electron uygulamasını dağıtmak; electron-builder hedeflerini yapılandırmayı, hem macOS (notarizasyonla) hem de Windows (Authenticode ile) için kodu imzalamayı ve isteğe bağlı olarak electron-updater ile otomatik güncellemeleri ayarlamayı içerir. ASAR arşivi uygulamanızı dağıtım için birleştirir; yerel modüller ayrıca arşivden çıkarılır. Sağlam bir CI/CD işlem hattı bu adımları her platform için otomatik olarak gerçekleştirir.