การจัดแพ็กเกจและเผยแพร่สำหรับแพลตฟอร์มเดสก์ท็อป

electron-builder เป็นเครื่องมือมาตรฐานสำหรับแพ็กแอป Electron ให้เป็นตัวติดตั้งที่แจกจ่ายได้ การกำหนดค่าจะอยู่ใน package.json ภายใต้คีย์ "build" โดยระบุข้อมูลเมตาของแอป (appId, productName) เส้นทางไอคอน และรูปแบบเป้าหมายสำหรับแต่ละแพลตฟอร์ม

electron-builder รองรับ macOS (dmg และ zip), Windows (ตัวติดตั้ง nsis) และ Linux (AppImage และ deb) คุณสามารถกำหนดเป้าหมายหลายแพลตฟอร์มด้วยคำสั่งสร้างเพียงคำสั่งเดียว หรือกำหนดค่า CI ให้สร้างแต่ละแพลตฟอร์มบนเครื่องสร้างที่เป็นระบบปฏิบัติการเดียวกัน เพื่อให้เข้ากันได้ดีที่สุด

macOS ต้องใช้การเซ็นโค้ดด้วยใบรับรอง Apple Developer เพื่อให้ Gatekeeper อนุญาตให้ผู้ใช้เปิดแอปได้โดยไม่แสดงคำเตือนด้านความปลอดภัย electron-builder จะอ่านใบรับรองจากพวงกุญแจของ macOS ระหว่างกระบวนการสร้าง และเซ็นไบนารีทั้งหมดโดยอัตโนมัติ

นอกเหนือจากการเซ็นโค้ดแล้ว macOS รุ่นใหม่ยังต้องมีการรับรองโดย Apple ด้วย ซึ่งเป็นการส่งแอปไปยังบริการรับรองของ Apple เพื่อสแกนหามัลแวร์และออกตั๋วรับรอง electron-builder สามารถทำให้กระบวนการรับรองเป็นอัตโนมัติผ่าน electron-notarize และผู้ใช้ macOS 10.15 ขึ้นไปจะถูกบล็อกไม่ให้เปิดแอปหากไม่มีการรับรองนี้

Windows ต้องใช้ใบรับรอง Authenticode จากหน่วยงานออกใบรับรองที่น่าเชื่อถือ (CA) เพื่อให้ SmartScreen เชื่อถือตัวติดตั้งของคุณ หากไม่มีการเซ็น ผู้ใช้จะเห็นคำเตือน "Windows protected your PC" ใบรับรอง Extended Validation (EV) จะกำจัดคำเตือนนี้ได้ทันที ส่วนใบรับรอง OV มาตรฐานจะสร้างความน่าเชื่อถือเมื่อเวลาผ่านไป

หลังจากสร้างสำเร็จ electron-builder จะเขียนตัวติดตั้งเฉพาะแพลตฟอร์มไว้ในไดเรกทอรี dist/ คุณจะพบไฟล์ DMG หรือ zip สำหรับ macOS ไฟล์ .exe ของ NSIS สำหรับ Windows และไฟล์ AppImage หรือ .deb สำหรับ Linux รวมถึงไฟล์รายการกำกับการอัปเดตอัตโนมัติ latest.yml (หรือ latest-mac.yml)

แอป Electron ต้องใช้ไอคอนในรูปแบบเฉพาะของแต่ละแพลตฟอร์ม ได้แก่ PNG ขนาด 512x512 สำหรับ Linux ไฟล์ ICNS (หลายความละเอียด) สำหรับ macOS และไฟล์ ICO (หลายความละเอียด) สำหรับ Windows electron-builder สามารถสร้างรูปแบบทั้งหมดจาก PNG ขนาด 1024x1024 ไฟล์เดียวโดยใช้แฟล็ก --icon

แพ็กเกจ electron-updater ทำงานร่วมกับ electron-builder เพื่อให้บริการอัปเดตอัตโนมัติ เผยแพร่บิลด์ของคุณไปยัง GitHub Releases หรือ S3 แล้ว electron-updater จะตรวจสอบการอัปเดตเมื่อเริ่มต้นระบบ ดาวน์โหลดการอัปเดตส่วนต่างในเบื้องหลัง และแจ้งให้ผู้ใช้เริ่มแอปใหม่

เรียกใช้ autoUpdater.checkForUpdatesAndNotify() ใน main.js หลังจากแอปพร้อมทำงานแล้ว electron-updater จะดึงไฟล์รายการกำกับ latest.yml จากเป้าหมายการเผยแพร่ของคุณ เปรียบเทียบเวอร์ชัน และหากมีการอัปเดต ก็จะดาวน์โหลดการอัปเดตนั้นพร้อมแสดงการแจ้งเตือนแบบเนทีฟเมื่อพร้อมติดตั้ง

electron-builder จะรวมไฟล์ JavaScript ของแอปพลิเคชันไว้ในคลังจัดเก็บ ASAR เดียว (คล้ายกับไฟล์ tar) เพื่อแจกจ่าย วิธีนี้ช่วยเพิ่มประสิทธิภาพการเริ่มต้นระบบโดยลดการค้นหาในระบบไฟล์ และทำให้การตรวจสอบซอร์สโค้ดโดยตรงทำได้ยากขึ้น (แต่ยังไม่ถึงกับเป็นไปไม่ได้)

โมดูล Node.js แบบเนทีฟ (ไฟล์ .node) ไม่สามารถโหลดจากภายในคลังจัดเก็บ ASAR ได้ แต่ต้องแยกออกมาไว้ในระบบไฟล์ ให้กำหนดค่า asarUnpack ใน electron-builder เพื่อระบุรูปแบบของโมดูลเนทีฟ ซึ่งจะนำโมดูลเหล่านั้นไปไว้ในไดเรกทอรี app.asar.unpacked ข้างคลังจัดเก็บ

เหตุใดการแจกจ่ายแอปสำหรับ macOS จึงต้องมีการรับรองโดย Apple นอกเหนือจากการเซ็นโค้ด

การแจกจ่ายแอป Electron ต้องกำหนดค่าเป้าหมายของ electron-builder เซ็นโค้ดสำหรับทั้ง macOS (พร้อมการรับรองโดย Apple) และ Windows (ด้วย Authenticode) และอาจตั้งค่าการอัปเดตอัตโนมัติด้วย electron-updater คลังจัดเก็บ ASAR จะรวมแอปของคุณเพื่อการแจกจ่าย โดยแยกโมดูลเนทีฟออกมาไว้ต่างหาก กระบวนการ CI/CD ที่มีประสิทธิภาพจะจัดการขั้นตอนเหล่านี้โดยอัตโนมัติสำหรับแต่ละแพลตฟอร์ม