Compartilhar via


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ê pode 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 para 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, consulte Como incluir pré-requisitos com um aplicativo ClickOnce.

Os pré-requisitos são gerenciados na caixa de diálogo Pré-requisitos , acessíveis 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 do .NET Core 3.1 e .NET 5 ou posterior, você define as propriedades de implantação usando a ferramenta de Publicação em vez do Assistente de Publicação e da página de Publicação do Designer de Projeto. Para obter mais informações, consulte Implantar um aplicativo do Windows .NET 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 .

    Captura de tela da caixa de diálogo Pré-requisitos no Visual Studio.

  4. Na caixa de diálogo Pré-requisitos , verifique se a caixa de seleção Criar programa de instalação para instalar componentes de pré-requisito 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 componentes de pré-requisito está marcada.

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

  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ê deve verificar se os instaladores dos componentes especificados existem no local especificado.