WiX Burn Bundle para implantar o WebView2 Runtime

Este exemplo, WV2DeploymentWiXBurnBundleSample, demonstra como usar um WiX Burn Bundle para implantar o WebView2 Runtime. Siga as etapas deste artigo para criar um instalador do WiX que instala em cadeia o Evergreen WebView2 Runtime por meio do Burn Bundle.

  • Nome da amostra: WV2DeploymentWiXBurnBundleSample
  • Diretório do repositório: WV2DeploymentWiXBurnBundleSample
  • Arquivo de projeto: WV2DeploymentWiXBurnBundleSample.wixproj

Este exemplo cria um instalador WiX para o aplicativo de exemplo Win32. Este exemplo usa o WiX Burn Bundle para instalar em cadeia o Evergreen WebView2 Runtime.

Este exemplo demonstra essas duas abordagens de distribuição diferentes para distribuir o WebView2 Runtime para seu aplicativo:

  • Baixando o Evergreen WebView2 Runtime Bootstrapper por meio de um link armazenado em seu aplicativo.
  • Empacotando o Evergreen WebView2 Runtime Bootstrapper com seu aplicativo.

A outra abordagem, não demonstrada neste exemplo, é empacotar o Instalador Autônomo do Evergreen WebView2 Runtime com seu aplicativo. Essa abordagem é muito semelhante ao empacotamento do Evergreen WebView2 Runtime Bootstrapper com seu aplicativo.

Para obter uma visão geral das abordagens, consulte Implantando o Evergreen WebView2 Runtime em Distribuir seu aplicativo e o WebView2 Runtime.

Etapa 1 – Instalar o Visual Studio

O Microsoft Visual Studio é necessário. O Microsoft Visual Studio Code não tem suporte para este exemplo.

Se o Visual Studio (versão mínima necessária) ainda não estiver instalado, com suporte a C++:

  1. Em uma janela ou guia separada, consulte Instalar o Visual Studio em Configurar seu ambiente de Desenvolvimento para WebView2. Siga as etapas nesta seção para instalar o Visual Studio, incluindo o suporte a C++.

Em seguida, retorne a esta página e continue as etapas abaixo.

Etapa 2 - Instale as ferramentas de compilação do WiX Toolset

Se ainda não tiver terminado, instale o WiX Toolset:

  1. Em uma nova janela ou guia, acesse WiX Toolset e baixe as ferramentas de compilação do WiX Toolset.

  2. Clique no wixnnn.exe arquivo e clique em Abrir arquivo.

    Uma caixa de diálogo pode ser aberta, Requer que o .NET Framework 3.5.1 esteja habilitado:

    Requer a caixa de diálogo do .NET Framework

    Se o .NET Framework 3.5.1 já estiver habilitado em seu computador, pule para continuar instalando esse componente WiX.

  3. Clique no botão OK . A janela do instalador do WiX é fechada.

  4. Pressione a tecla do logotipo do Windows Tecla do logotipo do Windows, digite Recursos do Windows e pressione Enter. A caixa de diálogo Ativar ou desativar recursos do Windows é exibida.

  5. Marque a caixa de marca a caixa de marca .NET Framework 3.5 (inclui .NET 2.0 e 3.0):

    Ativar ou desativar recursos > do Windows no .NET Framework 3.5

    Não é necessário selecionar os itens filho.

  6. Clique em OK. Talvez você receba uma solicitação para permitir que o Windows Update baixe arquivos.

    Para obter mais informações, consulte Instalar o .NET Framework 3.5 no Windows 11, Windows 10, Windows 8.1 e Windows 8.

  7. Depois que o .NET Framework 3.5.1 estiver habilitado, execute o wixnnn.exe arquivo novamente. Por exemplo, no Microsoft Edge, clique em Configurações e mais, clique em Downloads e clique em Abrir arquivo abaixo wix311.exe.

  8. Clique no painel Instalar do instalador do WiX.

  9. No Controle de Conta de Usuário, clique no botão Sim . A parte superior do instalador do WiX diz "Instalado com êxito".

Instale também o componente WiX Visual Studio, conforme a próxima seção.

Etapa 3 - Instale a extensão Visual Studio do conjunto de ferramentas WiX

Se ainda não tiver terminado, instale a Extensão Visual Studio 2019 do Conjunto de Ferramentas WiX:

  1. Em uma nova janela ou guia, vá para WiX Toolset , baixe e instale a extensão:

    • WiX Toolset Visual Studio 2019 Extension - arquivo do instalador baixado: Votive2019.vsix

  2. No Controle de Conta de Usuário, clique no botão Sim . O instalador VSIX para WiX extensão do Visual Studio é aberto:

    Instalador VSIX para WiX Extensão do Visual Studio 2019

  3. Clique no botão Instalar .

  4. Se uma caixa de diálogo VSIX aguardando o desligamento dos processos for aberta, feche o Visual Studio. O Instalador do VSIX prossegue.

    O Instalador do VSIX lê Instalação concluída:

    Instalador VSIX - Instalação Concluída - Conjunto de Ferramentas WiX Visual Studio 2019 Extension

  5. No Instalador do VSIX, clique no botão Fechar .

  6. No instalador do WiX, clique no painel Sair .

  7. Feche o Visual Studio, se estiver aberto.

Etapa 4 – Clonar ou baixar o repositório WebView2Samples

  1. Se ainda não tiver feito isso, clone ou baixe o WebView2Samples repositório para sua unidade local. Em uma janela ou guia separada, consulte Baixar o repositório WebView2Samples em Configurar seu ambiente de desenvolvimento para WebView2. Siga as etapas nesta seção e, em seguida, retorne a esta página e continue abaixo.

Etapa 5 - Compilar o projeto de implantação

  1. Na cópia local do repositório WebView2Samples, abra <repo-location>\WebView2Samples\SampleApps\WebView2Samples.sln com o Visual Studio (não o Visual Studio Code).

    Se o campo Sem suporte ... . A caixa de diálogo wixproj é exibida, instale o WiX Toolset e a WiX Toolset Extension, acima:

    Mensagem de projetos wix sem suporte

  2. Este exemplo é uma extensão do exemplo WV2DeploymentWiXCustomActionSample . No Gerenciador de Soluções, expanda WV2DeploymentWiXCustomActionSample e clique duas vezes em Product.wxs.

  3. Em Product.wxs, comente todos os elementos , <CustomAction>, e <Custom> em <!-- Step 4: Config Custom Action to download/install Bootstrapper --><!-- Step 5: Config execute sequence of custom action --> e para que a <Binary>Ação Personalizada não seja usada.

  4. Abra Bundle.wxs no WV2DeploymentWiXBurnBundleSample projeto. Edite Bundle.wxs dependendo do fluxo de trabalho que você deseja usar:

    Para empacotar o Evergreen WebView2 Runtime Bootstrapper com seu aplicativo:

    • Remova o comentário do <ExePackage Id="InvokeBootstrapper" ...> elemento abaixo <!-- [Package Bootstrapper] ... -->e comente outros <ExePackage> elementos.

    Para baixar o Evergreen WebView2 Runtime Bootstrapper por meio de um link em seu aplicativo:

    • Remova o comentário do <ExePackage Id="DownloadAndInvokeBootstrapper" ...> elemento abaixo <!-- [Download Bootstrapper] ... -->e comente outros <ExePackage> elementos.

  5. Se você estiver empacotando o Evergreen WebView2 Runtime Bootstrapper com seu aplicativo, baixe o Bootstrapper e coloque-o na pasta anexa SampleApps .

  6. Construa o WV2DeploymentWiXBurnBundleSample projeto.

Confira também

  • Last updated on