Compartilhar via

Empacotando seu aplicativo Electron para distribuição

Este guia mostra como criar um pacote MSIX para distribuir seu aplicativo Electron com APIs do Windows.

Pré-requisitos

Preparar para embalagem

Antes de empacotar, configure sua ferramenta de build para excluir arquivos temporários do build final:

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

Verifique se o appxmanifest.xmlExecutable atributo aponta para o arquivo correto .exe .

Essa abordagem oferece mais controle e é compatível com qualquer empacotador Electron.

Criar seu aplicativo Electron

npx electron-forge package

Isso 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 da pasta real criado por Electron Forge (por exemplo, my-windows-app-win32-x64).

Dica

Adicione estes comandos aos scripts package.json para 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: Usando o Electron Forge MSIX Maker

Se você já estiver usando o Electron Forge, poderá integrar o empacotamento MSIX diretamente.

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 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

Instale o certificado de desenvolvimento (configuração única, execute como administrador):

npx winapp cert install .\devcert.pfx

Instale o pacote MSIX:

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

Seu aplicativo será exibido no Menu Iniciar.

Opções de distribuição

Microsoft Store

Envie seu aplicativo para a distribuição mais ampla e as atualizações automáticas. Saiba mais: publicar seu aplicativo na Microsoft Store.

Download direto

Hospede o pacote MSIX em seu site. Assine-o com um certificado de AC (autoridade de certificação) confiável.

Distribuição empresarial

Distribua via download direto, sideload, ou pelo Company Portal (Intune). Saiba mais: Distribua aplicativos fora da Loja.

Instalador de Aplicativo

Crie um .appinstaller arquivo para atualizações automáticas. Saiba mais: Visão geral do arquivo do Instalador de Aplicativos.

  • Last updated on