Instalar pré-requisitos com um aplicativo ClickOnce

Todos os aplicativos ClickOnce exigem que a versão correta do .NET Framework seja instalada em um computador antes que eles possam ser executados; muitos aplicativos também têm outros pré-requisitos. Ao publicar um aplicativo ClickOnce, você poderá escolher um conjunto de componentes de pré-requisito a serem empacotados junto com seu aplicativo. No momento da instalação, uma verificação será executada para cada pré-requisito a fim de determinar se ele já existe; caso contrário, ele será instalado antes de instalar o aplicativo ClickOnce.

Em vez de empacotar e publicar pré-requisitos, você também pode especificar um local de download para os componentes. Por exemplo, em vez de incluir pré-requisitos com cada aplicativo publicado, você pode usar um compartilhamento de arquivos centralizado ou local da Web que contenha os instaladores para todos os seus pré-requisitos; no momento da instalação, os componentes serão baixados e instalados desse local.

Importante

Você deve adicionar pacotes de instalador de pré-requisitos ao computador de desenvolvimento antes de publicar seu primeiro aplicativo ClickOnce. Para obter mais informações, confira Como incluir pré-requisitos com um aplicativo ClickOnce.

Os pré-requisitos são gerenciados na caixa de diálogo Pré-requisitos, que pode ser acessado no painel Publicar do Designer de Projeto.

Observação

Além da lista predeterminada de pré-requisitos, você pode adicionar seus próprios componentes à lista. Para obter mais informações, confira Criar pacotes de inicialização.

Para especificar os pré-requisitos a serem instalados com um aplicativo ClickOnce

  1. Com um projeto selecionado no Gerenciador de Soluções, no menu Projeto, clique em Propriedades.

    Observação

    No ClickOnce para .NET Core 3.1 e .NET 5 ou posterior, você define propriedades de implantação usando a ferramenta Publicar, em vez do Assistente de Publicação, e a página Publicar do Designer de Projeto. Para obter mais informações, confira Implantar um aplicativo .NET do Windows usando ClickOnce e ClickOnce para .NET.

  2. Selecione o painel Publicar.

  3. Clique no botão Pré-requisitos para abrir a caixa de diálogo Pré-requisitos.

  4. Na caixa de diálogo Pré-requisitos, verifique se a caixa de seleção Criar programa de instalação para instalar os componentes dos pré-requisitos está marcada.

  5. Na lista Pré-requisitos, verifique os componentes que você deseja instalar e clique em OK.

    Os componentes selecionados serão empacotados e publicados junto com seu aplicativo.

Para especificar um local de download diferente para pré-requisitos

  1. Com um projeto selecionado no Gerenciador de Soluções, no menu Projeto, clique em Propriedades.

  2. Selecione o painel Publicar.

  3. Clique no botão Pré-requisitos para abrir a caixa de diálogo Pré-requisitos.

  4. Na caixa de diálogo Pré-requisitos, verifique se a caixa de seleção Criar programa de instalação para instalar os componentes dos pré-requisitos está marcada.

  5. Na seção Especificar o local de instalação para pré-requisitos, selecione Baixar pré-requisitos deste local.

  6. Selecione um local na lista suspensa ou insira uma URL, um caminho de arquivo ou um local de FTP e clique em OK.

    Observação

    Você precisa verificar se os instaladores dos componentes especificados existem no local especificado.