Pengemasan dan Distribusi untuk Platform Desktop

electron-builder adalah alat standar untuk mengemas aplikasi Electron menjadi penginstal yang dapat didistribusikan. Konfigurasinya berada di package.json di bawah kunci "build", yang menentukan metadata aplikasi (appId, productName), jalur ikon, dan format target untuk setiap platform.

electron-builder mendukung macOS (dmg dan zip), Windows (penginstal NSIS), dan Linux (AppImage dan deb). Anda dapat menargetkan beberapa platform dengan satu perintah pembuatan, atau mengonfigurasi CI untuk membuat setiap platform pada pelaksana aslinya agar kompatibilitasnya optimal.

macOS memerlukan penandatanganan kode dengan sertifikat Apple Developer agar Gatekeeper mengizinkan pengguna membuka aplikasi tanpa peringatan keamanan. electron-builder membaca sertifikat Anda dari Keychain macOS selama proses pembuatan dan menandatangani semua biner secara otomatis.

Selain penandatanganan kode, macOS modern juga memerlukan notarisasi—mengirimkan aplikasi ke layanan notarisasi Apple, yang memindai malware dan menerbitkan tiket. electron-builder dapat mengotomatiskan notarisasi melalui electron-notarize, dan pengguna macOS 10.15 atau yang lebih baru akan diblokir tanpa notarisasi tersebut.

Windows memerlukan sertifikat Authenticode dari Otoritas Sertifikat (CA) tepercaya agar SmartScreen mempercayai penginstal Anda. Tanpa penandatanganan, pengguna akan melihat peringatan "Windows protected your PC". Sertifikat Extended Validation (EV) langsung menghilangkan peringatan tersebut, sedangkan sertifikat OV standar membangun kepercayaan seiring waktu.

Setelah pembuatan berhasil, electron-builder menulis penginstal khusus platform ke direktori dist/. Anda akan menemukan DMG atau zip untuk macOS, berkas .exe NSIS untuk Windows, serta AppImage atau .deb untuk Linux, bersama dengan manifes pembaruan otomatis latest.yml (atau latest-mac.yml).

Aplikasi Electron memerlukan ikon dalam format khusus platform: PNG berukuran 512x512 untuk Linux, berkas ICNS (multiresolusi) untuk macOS, dan berkas ICO (multiresolusi) untuk Windows. electron-builder dapat membuat semua format tersebut dari satu PNG berukuran 1024x1024 menggunakan opsi --icon.

Paket electron-updater terintegrasi dengan electron-builder untuk menyediakan pembaruan otomatis. Publikasikan hasil pembuatan Anda ke GitHub Releases atau S3, lalu electron-updater dapat memeriksa pembaruan saat aplikasi dimulai, mengunduh pembaruan delta di latar belakang, dan meminta pengguna untuk memulai ulang.

Panggil autoUpdater.checkForUpdatesAndNotify() di main.js setelah aplikasi siap. electron-updater mengambil manifes latest.yml dari target publikasi Anda, membandingkan versi, dan jika pembaruan tersedia, mengunduhnya serta menampilkan notifikasi asli saat pembaruan siap dipasang.

electron-builder mengemas berkas JavaScript aplikasi Anda ke dalam satu arsip ASAR (mirip berkas tar) untuk didistribusikan. Hal ini meningkatkan kinerja saat memulai dengan mengurangi pencarian di sistem berkas dan membuat kode sumber Anda lebih sulit (meskipun bukan mustahil) untuk diperiksa secara langsung.

Modul Node.js asli (berkas .node) tidak dapat dimuat dari dalam arsip ASAR—modul tersebut harus dibongkar ke sistem berkas. Konfigurasikan asarUnpack di electron-builder untuk mencantumkan pola modul asli; konfigurasi ini menempatkannya di direktori app.asar.unpacked bersama arsip tersebut.

Mengapa notarisasi diperlukan untuk distribusi macOS selain sekadar penandatanganan kode?

Mendistribusikan aplikasi Electron mencakup konfigurasi target electron-builder, penandatanganan kode untuk macOS (dengan notarisasi) dan Windows (Authenticode), serta secara opsional menyiapkan pembaruan otomatis dengan electron-updater. Arsip ASAR mengemas aplikasi untuk didistribusikan, sedangkan modul asli dibongkar secara terpisah. Alur CI/CD yang solid menangani langkah-langkah ini secara otomatis untuk setiap platform.