Condividi tramite


Creazione del pacchetto dell'app Electron per la distribuzione

Questa guida illustra come creare un pacchetto MSIX per distribuire l'app Electron con le API di Windows.

Prerequisiti

Prepararsi per l'imballaggio

Prima di creare pacchetti, configurare lo strumento di compilazione per escludere i file temporanei dalla compilazione finale:

  • .winapp/ cartella
  • winapp.yaml
  • File di certificato (.pfx)
  • Simboli di debug (.pdb)
  • Artifacts di compilazione C# (cartelle /obj/, bin/)
  • Pacchetti MSIX (*.msix)

Verificare che l'attributo appxmanifest.xmlExecutable punti al file corretto .exe .

Questo approccio offre maggiore controllo e funziona con qualsiasi impacchettatore Electron.

Creare l'app Electron

npx electron-forge package

Verrà creata una versione di produzione nella ./out/ cartella .

Creare il pacchetto MSIX

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

Sostituire <your-app-folder> con il nome effettivo della cartella creato da Electron Forge (ad esempio, my-windows-app-win32-x64).

Suggerimento

Aggiungere questi comandi agli package.json script per praticità:

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

Opzione 2: Uso di Electron Forge MSIX Maker

Se si usa già Electron Forge, è possibile integrare direttamente i pacchetti MSIX.

Installare MSIX Maker

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

Configurare forge.config.js

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

Aggiornare appxmanifest.xml

Aggiornare il Executable percorso in modo che punti alla app cartella:

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

Creare il pacchetto MSIX

npm run make

Il pacchetto MSIX verrà creato in ./out/make/msix/.

Installare e testare MSIX

Installare il certificato di sviluppo (installazione una tantum, eseguirlo come amministratore):

npx winapp cert install .\devcert.pfx

Installare il pacchetto MSIX:

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

L'app verrà visualizzata nel menu Start.

Opzioni di distribuzione

Microsoft Store

Inviare l'app per la distribuzione più ampia e gli aggiornamenti automatici. Altre informazioni: Pubblicare l'app in Microsoft Store.

Download diretto

Ospitare il pacchetto MSIX nel sito Web. Firmarlo con un certificato dell'autorità di certificazione (CA) attendibile.

Distribuzione aziendale

Distribuire tramite il Portale dell'azienda (Intune), scaricamento diretto o sideloading. Altre informazioni: Distribuire app all'esterno dello Store.

Installatore di app

Creare un .appinstaller file per gli aggiornamenti automatici. Altre informazioni: Panoramica del file di installazione app.