Empaquetado de la aplicación Electron para la distribución

En esta guía se muestra cómo crear un paquete MSIX para distribuir la aplicación Electron con las API de Windows.

Prerrequisitos

• Completado la configuración del entorno de desarrollo
• Se ha comprobado que la aplicación se ejecuta correctamente con npm start

Preparación para el empaquetado

Antes de empaquetar, configure la herramienta de compilación para excluir los archivos temporales de la compilación final:

• .winapp/ carpeta
• winapp.yaml
• Archivos de certificado (.pfx)
• Símbolos de depuración (.pdb)
• Artefactos de compilación de C# (carpetas obj/, bin/)
• Paquetes MSIX (*.msix)

Compruebe que el appxmanifest.xmlExecutable atributo apunta al archivo correcto .exe .

Opción 1: Uso de la CLI de Winapp directamente (recomendado)

Este enfoque proporciona más control y funciona con cualquier empaquetador de Electron.

Cree su aplicación Electron

npx electron-forge package

Esto crea una versión de producción en la ./out/ carpeta .

Creación del paquete MSIX

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

Reemplace por <your-app-folder> el nombre de carpeta real creado por Electron Forge (por ejemplo, my-windows-app-win32-x64).

Sugerencia

Agregue estos comandos a los package.json scripts para mayor comodidad:

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

Opción 2: Uso de Electron Forge MSIX Maker

Si ya usa Electron Forge, puede integrar el empaquetado MSIX directamente.

Instalación de MSIX Maker

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

Configuración de forge.config.js

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

Actualizar appxmanifest.xml

Actualice la Executable ruta de acceso para que apunte a la app carpeta:

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

Creación del paquete MSIX

npm run make

El paquete MSIX se creará en ./out/make/msix/.

Instalación y prueba de MSIX

Instale el certificado de desarrollo (instalación única, ejecute como administrador):

npx winapp cert install .\devcert.pfx

Instale el paquete MSIX:

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

La aplicación aparecerá en el menú Inicio.

Opciones de distribución

Microsoft Store

Envíe la aplicación para obtener la distribución más amplia y las actualizaciones automáticas. Más información: Publicar la aplicación en Microsoft Store.

Descarga directa

Hospede el paquete MSIX en su sitio web. Firmarlo con un certificado de confianza de una autoridad certificadora (CA).

Distribución empresarial

Distribuya a través de Company Portal (Intune), descarga directa o carga lateral. Más información: Distribuir aplicaciones fuera de la Tienda.

Instalador de aplicación

Cree un .appinstaller archivo para actualizaciones automáticas. Más información: Información general sobre el archivo del instalador de aplicación.

Temas relacionados

• Configuración de Electron para el desarrollo de la API de Windows
• Referencia de la CLI de winapp
• Documentación de empaquetado msix