Partilhar via

Embalar a sua aplicação Electron para distribuição

Este guia mostra-lhe como criar um pacote MSIX para distribuir a sua aplicação Electron com APIs do Windows.

Pré-requisitos

Preparar para a embalagem

Antes de empacotamentos, configure a sua ferramenta de compilação para excluir ficheiros temporários da versão final:

  • .winapp/ pasta
  • winapp.yaml
  • Ficheiros de certificados (.pfx)
  • Símbolos de depuração (.pdb)
  • artefatos de compilação C# (pastas obj/, bin/)
  • Pacotes MSIX (*.msix)

Verifica se o teu appxmanifest.xmlExecutable atributo aponta para o ficheiro correto .exe .

Esta abordagem dá-te mais controlo e funciona com qualquer empacotador Electron.

Constrói a tua aplicação Electron

npx electron-forge package

Isto cria uma versão de produção na ./out/ pasta.

Criar o pacote MSIX

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

Substitua <your-app-folder> pelo nome real da pasta criado pelo Electron Forge (por exemplo, my-windows-app-win32-x64).

Sugestão

Adicione estes comandos aos seus package.json scripts para maior conveniência:

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

Opção 2: Usar o Electron Forge MSIX Maker

Se já estiveres a usar o Electron Forge, podes integrar diretamente o pacote MSIX.

Instalar o MSIX Maker

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

Configurar forge.config.js

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

Atualizar o appxmanifest.xml

Atualize o Executable caminho para apontar para a app pasta:

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

Criar o pacote MSIX

npm run make

O pacote MSIX será criado em ./out/make/msix/.

Instalar e testar o MSIX

Instalar o certificado de desenvolvimento (configuração única, executar como administrador):

npx winapp cert install .\devcert.pfx

Instale o pacote MSIX:

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

A sua aplicação aparecerá no Menu Iniciar.

Opções de distribuição

Loja Microsoft

Submeta a sua aplicação para a maior distribuição e atualizações automáticas. Saiba mais: Publique a sua aplicação na Microsoft Store.

Download direto

Aloja o pacote MSIX no teu site. Assine com um certificado de autoridade certificadora (CA) de confiança.

Distribuição empresarial

Distribua através do Company Portal (Intune), download direto ou sideloading. Saiba mais: Distribua aplicações fora da Loja.

Instalador de Aplicações

Crie um .appinstaller ficheiro para atualizações automáticas. Saiba mais: Visão geral dos ficheiros do instalador de aplicações.

  • Last updated on