Delen via


Uw Electron-app verpakken voor distributie

Deze handleiding laat zien hoe u een MSIX-pakket maakt voor het distribueren van uw Electron-app met Windows-API's.

Vereiste voorwaarden

Voorbereiden voor verpakking

Voordat u het pakket verpakt, configureert u uw buildhulpprogramma om tijdelijke bestanden uit te sluiten van de uiteindelijke build:

  • map .winapp/
  • winapp.yaml
  • Certificaatbestanden (.pfx)
  • Symbolen voor foutopsporing (.pdb)
  • C#-bouwartefacten (mappen obj/, bin/)
  • MSIX-pakketten (*.msix)

Controleer of het appxmanifest.xmlExecutable kenmerk verwijst naar het juiste .exe bestand.

Deze aanpak geeft je meer controle en werkt met elke Electron packager.

Uw Electron-app bouwen

npx electron-forge package

Hiermee maakt u een productieversie in de ./out/ map.

Het MSIX-pakket maken

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

Vervang door <your-app-folder> de werkelijke mapnaam die is gemaakt door Electron Forge (bijvoorbeeld my-windows-app-win32-x64).

Aanbeveling

Voeg deze opdrachten voor het gemak toe aan uw package.json scripts:

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

Optie 2: Electron Forge MSIX Maker gebruiken

Als u Electron Forge al gebruikt, kunt u MSIX-pakketten rechtstreeks integreren.

MSIX Maker installeren

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

forge.config.js configureren

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

appxmanifest.xml bijwerken

Werk het Executable pad bij om naar de app map te verwijzen:

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

Het MSIX-pakket maken

npm run make

Het MSIX-pakket wordt gemaakt in ./out/make/msix/.

MsiX installeren en testen

Installeer het ontwikkelingscertificaat (eenmalige installatie, als administrator uitvoeren):

npx winapp cert install .\devcert.pfx

Installeer het MSIX-pakket:

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

Uw app wordt weergegeven in het menu Start.

Distributieopties

Microsoft Store

Dien uw app in voor de breedste distributie en automatische updates. Meer informatie: Uw app publiceren naar de Microsoft Store.

Direct downloaden

Host het MSIX-pakket op uw website. Onderteken het met een vertrouwd CA-certificaat.

Enterprise-distributie

Distributeer via Company Portal (Intune), directe download of sideloading. Meer informatie: Apps buiten de Store distribueren.

App-installatieprogramma

Maak een .appinstaller bestand voor automatische updates. Meer informatie: Overzicht van app-installatiebestand.