Partilhar via

Ação Personalizada WiX para implementar o Runtime do WebView2

Este exemplo, WV2DeploymentWiXCustomActionSample, demonstra como utilizar uma Ação Personalizada WiX para implementar o WebView2 Runtime.

  • Nome de exemplo: WV2DeploymentWiXCustomActionSample
  • Diretório de repositório: WV2DeploymentWiXCustomActionSample
  • Ficheiro de projeto: WV2DeploymentWiXCustomActionSample.wixproj

Para o ajudar a compreender como implementar o Evergreen WebView2 Runtime com a sua aplicação, este exemplo cria um instalador WiX para o WebView2APISample e utiliza uma Ação Personalizada WiX para instalar em cadeia o Runtime do Evergreen WebView2.

Este exemplo demonstra várias abordagens de implementação diferentes:

  • Transferir o Bootstrapper do Runtime Do Evergreen WebView2 através de uma ligação.
  • Empacote o Bootstrapper do Evergreen WebView2 Runtime com a sua aplicação.
  • Empacote o Instalador Autónomo do Evergreen WebView2 Runtime com a sua aplicação.

Passo 1 – Instalar o Visual Studio 2019 com suporte C++

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

  1. Visual Studio – se a opção Instalar o Visual Studio 2019 (versão mínima necessária) com suporte C++ ainda não estiver instalada, numa janela ou separador separador separador, consulte Instalar o Visual Studio em Configurar o ambiente de Programador para WebView2. Siga os passos nessa secção para instalar o Visual Studio 2019 com suporte C++ e, em seguida, regresse a esta página e continue os passos abaixo.

Passo 2 – Instalar ferramentas de compilação do WiX Toolset

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

  1. Numa nova janela ou separador, aceda a WiX Toolset e, em seguida, transfira as ferramentas de compilação do WiX Toolset.

  2. Clique no wixnnn.exe ficheiro e, em seguida, clique em Abrir ficheiro.

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

    Requer .NET Framework caixa de diálogo

    Se .NET Framework 3.5.1 já estiver ativado no seu computador, avance para continuar a instalar este componente WiX.

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

  4. Prima a tecla do logótipo do Windows tecla do logótipo do Windows, escreva Funcionalidades do Windows e, em seguida, prima Enter. É apresentada a caixa de diálogo Ativar ou desativar funcionalidades do Windows .

  5. Selecione a caixa de marcar .NET Framework 3.5 (inclui .NET 2.0 e 3.0):

    Ativar ou desativar > as funcionalidades do Windows .NET Framework 3.5

    Não precisa de selecionar os itens subordinados.

  6. Clique em OK. Poderá ser-lhe perguntado se deve permitir Windows Update transferir ficheiros.

    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 de ativar .NET Framework 3.5.1, execute novamente o wixnnn.exe ficheiro. Por exemplo, no Microsoft Edge, clique em Definições e muito mais, clique em Transferências e, em seguida, clique em Abrir ficheiro abaixo wix311.exede .

  8. Clique no painel Instalar do instalador WiX.

  9. Em Controlo de Conta de Utilizador, clique no botão Sim . A parte superior do instalador WiX indica "Instalado com êxito".

Instale também o componente WiX Visual Studio, de acordo com a secção seguinte.

Passo 3 – Instalar a Extensão do Visual Studio do WiX Toolset

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

  1. Numa nova janela ou separador, aceda a WiX Toolset e, em seguida, transfira e instale a extensão:

    • Extensão do Visual Studio 2019 do WiX Toolset - ficheiro do instalador transferido: Votive2019.vsix

  2. Em Controlo de Conta de Utilizador, clique no botão Sim . É aberta a extensão DO VSIX Installer for WiX Visual Studio:

    VsIX Installer for WiX Visual Studio 2019 extension (Instalador vsIX para a extensão WiX Visual Studio 2019)

  3. Clique no botão Instalar .

  4. Se for aberta uma VSIX à espera que os processos encerrem , feche o Visual Studio. O Instalador do VSIX prossegue.

    O Instalador do VSIX lê Instalar concluído:

    Instalador do VSIX – Instalação Concluída – Extensão WiX Toolset do Visual Studio 2019

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

  6. No instalador WiX, clique no painel Sair .

Passo 4 – Clonar o repositório WebView2Samples

  1. Se ainda não tiver terminado, clone o WebView2Samples repositório para a unidade local. Numa janela ou separador separado, consulte Clonar o repositório WebView2Samples em Configurar o ambiente Dev para WebView2. Siga os passos nessa secção e, em seguida, regresse a esta página e continue abaixo.

Passo 5 – Abrir a solução no Visual Studio

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

Passo 6 – Editar Product.wxs para configurar como distribuir o WebView2 Runtime

  1. Abra Product.wxs no WV2DeploymentWiXCustomActionSample projeto.

  2. Edite Product.wxs consoante a abordagem que pretende utilizar:

Se quiser que a aplicação transfira o Evergreen WebView2 Runtime Bootstrapper (MicrosoftEdgeWebview2Setup.exe) através de uma ligação:

  1. Em <!-- Step 4: Config Custom Action to download/install Bootstrapper -->, anule o comentário do <CustomAction Id='DownloadAndInvokeBootstrapper' ...> elemento abaixo <!-- [Download Bootstrapper] ... -->.

  2. Comente outros <Binary> elementos e <CustomAction> em Step 4.

  3. Em <!-- Step 5: Config execute sequence of custom action -->, anule o comentário do <Custom Action='DownloadAndInvokeBootstrapper' ...> elemento abaixo <!-- [Download Bootstrapper] ...-->.

  4. Comente outros <Custom> elementos em Step 5.

Abordagem 2: Empacotar o Bootstrapper Do Runtime Do Evergreen WebView2 com a aplicação

Se quiser empacotar o Evergreen WebView2 Runtime Bootstrapper (MicrosoftEdgeWebview2Setup.exe) com a aplicação:

  1. Em <!-- Step 4: Config Custom Action to download/install Bootstrapper -->, anule o comentário dos <Binary Id="MicrosoftEdgeWebview2Setup.exe" ...> elementos e <CustomAction Id='InvokeBootstrapper' ...> abaixo <!-- [Package Bootstrapper] ... -->.

  2. Comente outros <Binary> elementos e <CustomAction> em Step 4.

  3. Em <!-- Step 5: Config execute sequence of custom action -->, anule o comentário do <Custom Action='InvokeBootstrapper' ...> elemento abaixo <!-- [Package Bootstrapper] ...-->.

  4. Comente outros <Custom> elementos em Step 5.

Abordagem 3: Empacotar o Instalador Autónomo do Evergreen WebView2 Runtime com a sua aplicação

Se quiser empacotar o Instalador Autónomo do Evergreen WebView2 Runtime com a aplicação:

  1. Em <!-- Step 4: Config Custom Action to download/install Bootstrapper -->, anule o comentário dos <Binary Id="MicrosoftEdgeWebView2RuntimeInstallerX64.exe" ...> elementos e <CustomAction Id='InvokeStandalone' ...> abaixo <!-- [Package Standalone Installer] ... -->.

  2. Comente outros <Binary> elementos e <CustomAction> em Step 4.

  3. Se estiver a filtrar dispositivos não X64, também poderá querer editar o nome do MicrosoftEdgeWebView2RuntimeInstallerX64 ficheiro para refletir a arquitetura correta.

  4. Em <!-- Step 5: Config execute sequence of custom action -->, anule o comentário do <Custom Action='InvokeStandalone' ...> elemento abaixo <!-- [Package Standalone Installer] ...-->.

  5. Comente outros <Custom> elementos em Step 5.

Passo 7 – Colocar bootstrapper ou instalador na pasta

Se planear empacotar o Bootstrapper (Abordagem 2) ou o Instalador Autónomo (Abordagem 3) com a aplicação:

  1. Transfira o Bootstrapper ou o Instalador Autónomo. No Microsoft Edge WebView2, clique em Transferir Agora para se deslocar para baixo até à secção Transferir o Runtime do WebView2 .

  2. Coloque o Bootstrapper transferido ou o Instalador Autónomo na pasta de colocação SampleApps .

Passo 8 – Criar o projeto do instalador

  1. Crie o WV2DeploymentVSInstallerSample projeto.

Confira também

  • Last updated on