Mengemas aplikasi Electron Anda untuk distribusi

Panduan ini menunjukkan kepada Anda cara membuat paket MSIX untuk mendistribusikan aplikasi Electron Anda dengan API Windows.

Prasyarat

Bersiap untuk pengemasan

Sebelum pengemasan, konfigurasikan alat build Anda untuk mengecualikan file sementara dari build akhir:

  • Folder .winapp/
  • winapp.yaml
  • File sertifikat (.pfx)
  • Simbol Pemecahan Masalah (.pdb)
  • C# build artifacts (folder obj/, bin/)
  • Paket MSIX (*.msix)

Verifikasi bahwa atribut Anda appxmanifest.xmlExecutable menunjuk ke file yang benar .exe .

Pendekatan ini memberi Anda lebih banyak kontrol dan bekerja dengan pengemas Electron apa pun.

Membangun aplikasi Electron Anda

npx electron-forge package

Ini membuat versi produksi di folder ./out/.

Membuat paket MSIX

npx winapp pack .\out\<your-app-folder> --output .\out --cert .\devcert.pfx --manifest .\appxmanifest.xml

Ganti <your-app-folder> dengan nama folder aktual yang dibuat oleh Electron Forge (misalnya, my-windows-app-win32-x64).

Tip

Tambahkan perintah ini ke skrip Anda package.json untuk kenyamanan:

{
  "scripts": {
    "package-msix": "npx electron-forge package && npx winapp pack ./out/my-windows-app-win32-x64 --output ./out --cert ./devcert.pfx --manifest appxmanifest.xml"
  }
}

Opsi 2: Menggunakan Electron Forge MSIX Maker

Jika Anda sudah menggunakan Electron Forge, Anda dapat mengintegrasikan kemasan MSIX secara langsung.

Menginstal MSIX Maker

npm install --save-dev @electron-forge/maker-msix

Mengonfigurasi forge.config.js

module.exports = {
  makers: [
    {
      name: '@electron-forge/maker-msix',
      config: {
        appManifest: '.\\appxmanifest.xml',
        windowsSignOptions: {
          certificateFile: '.\\devcert.pfx',
          certificatePassword: 'password'
        }
      }
    }
  ],
};

Memperbarui appxmanifest.xml

Perbarui Executable jalur untuk menunjuk ke direktori app.

<Applications>
  <Application Id="myApp"
    Executable="app\my-app.exe"
    EntryPoint="Windows.FullTrustApplication">
  </Application>
</Applications>

Membuat paket MSIX

npm run make

Paket MSIX akan dibuat di ./out/make/msix/.

Menginstal dan menguji MSIX

Instal sertifikat pengembangan (penyiapan satu kali, jalankan sebagai administrator):

npx winapp cert install .\devcert.pfx

Instal paket MSIX:

Add-AppxPackage .\my-windows-app.msix

Aplikasi Anda akan muncul di Menu Mulai.

Opsi distribusi

Bursa Microsoft

Kirimkan aplikasi Anda untuk distribusi terluas dan pembaruan otomatis. Pelajari selengkapnya: Menerbitkan aplikasi Anda ke Microsoft Store.

Unduhan langsung

Host paket MSIX di situs web Anda. Tanda tangani dengan sertifikat dari otoritas sertifikat (CA) yang tepercaya.

Distribusi perusahaan

Distribusikan melalui Company Portal (Intune), unduhan langsung, atau penginstalan samping. Pelajari lebih lanjut: Mendistribusikan aplikasi di luar Toko.

Penginstal Aplikasi

Buat .appinstaller file untuk pembaruan otomatis. Pelajari selengkapnya: Gambaran umum file Penginstal Aplikasi.