Partager via


Empaquetage de votre application Electron pour la distribution

Ce guide vous montre comment créer un package MSIX pour distribuer votre application Electron avec des API Windows.

Prerequisites

Préparer l’empaquetage

Avant d’empaqueter, configurez votre outil de génération pour exclure les fichiers temporaires de la build finale :

  • .winapp/ dossier
  • winapp.yaml
  • Fichiers de certificat (.pfx)
  • Symboles de débogage (.pdb)
  • Artéfacts de build C# (dossiers obj/, bin/)
  • Packages MSIX (*.msix)

Vérifiez que votre appxmanifest.xmlExecutable attribut pointe vers le fichier correct .exe .

L'approche vous donne plus de contrôle et fonctionne avec n’importe quel emballeur Electron.

Créer votre application Electron

npx electron-forge package

Cela crée une version de production dans le ./out/ dossier.

Créer le package MSIX

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

Remplacez <your-app-folder> par le nom de dossier réel créé par Electron Forge (par exemple, my-windows-app-win32-x64).

Conseil / Astuce

Ajoutez ces commandes à vos package.json scripts pour des raisons pratiques :

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

Option 2 : Utilisation d’Electron Forge MSIX Maker

Si vous utilisez déjà Electron Forge, vous pouvez intégrer directement l’empaquetage MSIX.

Installer le MSIX Maker

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

Configurer forge.config.js

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

Mettre à jour appxmanifest.xml

Mettez à jour le chemin d’accès Executable pour pointer vers le app dossier :

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

Créer le package MSIX

npm run make

Le package MSIX est créé dans ./out/make/msix/.

Installer et tester MSIX

Installez le certificat de développement (configuration unique, exécutez en tant qu’administrateur) :

npx winapp cert install .\devcert.pfx

Installez le package MSIX :

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

Votre application s’affiche dans le menu Démarrer.

Options de distribution

Microsoft Store

Envoyez votre application pour obtenir les mises à jour automatiques et de distribution les plus larges. En savoir plus : Publier votre application dans le Microsoft Store.

Téléchargement direct

Hébergez le package MSIX sur votre site web. Signez-le avec un certificat d’autorité de certification approuvée.

Distribution d’entreprise

Distribuez via Company Portal (Intune), téléchargement direct ou installation manuelle. En savoir plus : Distribuer des applications en dehors du Windows Store.

Programme d’installation d’applications

Créez un .appinstaller fichier pour les mises à jour automatiques. En savoir plus : Vue d’ensemble du fichier du programme d’installation d’application.