Pembungkusan dan Pengedaran untuk Platform Desktop

electron-builder ialah alat piawai untuk memaketkan aplikasi Electron menjadi pemasang yang boleh diedarkan. Konfigurasinya berada dalam package.json di bawah kunci "build", yang menentukan metadata aplikasi (appId, productName), laluan ikon dan format sasaran bagi setiap platform.

electron-builder menyokong macOS (dmg dan zip), Windows (pemasang nsis) dan Linux (AppImage serta deb). Anda boleh menyasarkan berbilang platform dalam satu arahan binaan atau mengkonfigurasi CI untuk membina setiap platform pada pelaksana aslinya bagi mendapatkan keserasian terbaik.

macOS memerlukan penandatanganan kod menggunakan sijil Apple Developer supaya Gatekeeper membenarkan pengguna membuka aplikasi tanpa amaran keselamatan. electron-builder membaca sijil anda daripada Rantai Kunci macOS semasa proses binaan dan menandatangani semua binari secara automatik.

Selain penandatanganan kod, macOS moden juga memerlukan notarisasi — anda perlu menghantar aplikasi kepada perkhidmatan notarisasi Apple, yang mengimbas perisian hasad dan mengeluarkan tiket. electron-builder boleh mengautomatikkan notarisasi melalui electron-notarize, dan pengguna macOS 10.15 ke atas akan disekat tanpanya.

Windows memerlukan sijil Authenticode daripada Pihak Berkuasa Sijil (CA) yang dipercayai supaya SmartScreen mempercayai pemasang anda. Tanpa penandatanganan, pengguna akan melihat amaran "Windows protected your PC". Sijil Pengesahan Lanjutan (EV) menghapuskan amaran itu serta-merta, manakala sijil OV piawai membina kepercayaan dari semasa ke semasa.

Selepas binaan berjaya, electron-builder menulis pemasang khusus platform ke direktori dist/. Anda akan menemui DMG atau zip untuk macOS, fail boleh laku NSIS .exe untuk Windows dan AppImage atau .deb untuk Linux, bersama-sama manifes kemas kini automatik latest.yml (atau latest-mac.yml).

Aplikasi Electron memerlukan ikon dalam format khusus platform: PNG 512x512 untuk Linux, fail ICNS (pelbagai resolusi) untuk macOS dan fail ICO (pelbagai resolusi) untuk Windows. electron-builder boleh menjana semua format daripada satu PNG 1024x1024 menggunakan bendera --icon.

Pakej electron-updater disepadukan dengan electron-builder untuk menyediakan kemas kini automatik. Terbitkan binaan anda ke GitHub Releases atau S3, dan electron-updater boleh menyemak kemas kini semasa permulaan, memuat turun kemas kini delta di latar belakang dan meminta pengguna memulakan semula aplikasi.

Panggil autoUpdater.checkForUpdatesAndNotify() dalam main.js selepas aplikasi sedia. electron-updater mengambil manifes latest.yml daripada sasaran penerbitan anda, membandingkan versi dan, jika kemas kini tersedia, memuat turunnya serta memaparkan pemberitahuan asli apabila kemas kini itu sedia dipasang.

electron-builder memaketkan fail JavaScript aplikasi anda ke dalam satu arkib ASAR (serupa dengan fail tar) untuk pengedaran. Ini meningkatkan prestasi permulaan dengan mengurangkan carian sistem fail dan menyukarkan pemeriksaan terus terhadap kod sumber anda, walaupun tidak menjadikannya mustahil.

Modul Node.js asli (fail .node) tidak boleh dimuatkan dari dalam arkib ASAR — modul tersebut mesti dinyahpak ke sistem fail. Konfigurasikan asarUnpack dalam electron-builder untuk menyenaraikan corak modul asli, yang akan meletakkannya dalam direktori app.asar.unpacked bersebelahan dengan arkib.

Mengedarkan aplikasi Electron melibatkan konfigurasi sasaran electron-builder, menandatangani kod untuk macOS (dengan notarisasi) dan Windows (Authenticode), serta menyediakan kemas kini automatik dengan electron-updater jika diperlukan. Arkib ASAR memaketkan aplikasi anda untuk pengedaran, manakala modul asli dinyahpak secara berasingan. Alur CI/CD yang kukuh mengendalikan langkah-langkah ini secara automatik bagi setiap platform.