Share via


Incluir pré-requisitos com um aplicativo ClickOnce

Antes que possa distribuir o software necessário com um aplicativo ClickOnce, primeiro você deverá baixar os pacotes de instalador desses pré-requisitos em seu computador de desenvolvimento. Quando você publicar um aplicativo e escolher Baixar pré-requisitos da mesma localização que meu aplicativo baixa, ocorrerá um erro se os pacotes de instalador não estiverem na pasta Pacotes.

Observação

Para adicionar um pacote de instalador para o .NET Framework, confira o Guia de Implantação do .NET Framework para desenvolvedores.

Para adicionar um pacote de instalador ao usar Package.xml

  1. No Explorador de Arquivos, abra a pasta Pacotes.

    Por padrão, o caminho é %ProgramFiles(x86)%\Microsoft SDKs\ClickOnce Bootstrapper\Packages\.

Observação

A partir do Visual Studio 2019, os pacotes de inicialização da versão 7 também serão descobertos no caminho <VS Install Path>\MSBuild\Microsoft\VisualStudio\BootstrapperPackages.

  1. Abra a pasta do pré-requisito que você deseja adicionar e, em seguida, abra a pasta do idioma da versão instalada do Visual Studio (por exemplo, en para inglês).

  2. No Bloco de Notas, abra o arquivo Package.xml.

  3. Localize o elemento Name que contém http://go.microsoft.com/fwlink e copie a URL. Inclua a parte LinkID.

    Observação

    Se nenhum elemento Name contiver http://go.microsoft.com/fwlink, abra o arquivo Product.xml na pasta raiz do pré-requisito e localize a cadeia de caracteres fwlink.

    Importante

    Alguns pré-requisitos têm vários pacotes de instalador (por exemplo, para sistemas de 32 bits ou 64 bits). Se vários elementos Name contiverem fwlink, você deverá repetir as etapas restantes para cada um deles.

  4. Cole a URL na barra de endereços de seu navegador e, quando a execução ou gravação for solicitada, escolha Salvar.

    Essa etapa baixará o arquivo do instalador em seu computador.

  5. Copie o arquivo na pasta raiz do pré-requisito.

    Por exemplo, para o pré-requisito do .NET Framework 4.7.2, copie o arquivo para a pasta \Packages\DotNetFX472.

    Agora você poderá distribuir o pacote de instalador com seu aplicativo.