Compartilhar via


Extensão de projetos do instalador do Visual Studio e .NET

O empacotamento de aplicativos como MSI geralmente é realizado usando a Extensão de Projetos do Instalador do Visual Studio.

Este artigo se aplica a aplicativos direcionados ao .NET Core 3.1 e ao .NET 5 ou versões posteriores.

Você pode baixar a extensão aqui:

Atualizações para o .NET Core e o .NET

O .NET Core e o .NET 5+ têm dois modelos diferentes para publicação.

  • Implantações dependentes de estrutura

  • Os aplicativos autossuficientes incluem o runtime.

Para obter mais informações sobre essas estratégias de implantação, confira Visão geral da publicação de aplicativos .NET.

Criar um projeto de instalação

  1. No Visual Studio, escolha Extensões>Gerenciar Extensões e pesquise por "Projetos do Instalador do Visual Studio". Ou baixe a extensão diretamente do Marketplace.

  2. Na janela Iniciar, escolha Criar um projeto e digite "instalação" na caixa de pesquisa. Escolha um projeto de Instalação e siga as instruções.

    Para obter um exemplo detalhado mostrando como criar e compilar um projeto de Instalação, consulte Passo a passo: implantando um aplicativo baseado no Windows.

    Para obter informações gerais sobre projetos de Instalação (*.vsproj), confira Projetos de Instalação e Implantação.

    Para obter informações sobre propriedades de implantação, consulte Propriedades de implantação.

Alterações no fluxo de trabalho para .NET Core 3.1 e .NET 5 ou posterior

  • Para obter a saída correta para projetos do .NET Core 3.1 e .NET 5.0 ou posteriores, selecione Publicar Itens em vez de Saída Primária na caixa de diálogo Adicionar Grupo de Saída do Projeto. Para abrir esta caixa de diálogo, selecione Adicionar>saída do projeto... no menu de contexto do projeto de configuração.

    O grupo de saída Publicar Itens na caixa de diálogo Adicionar Grupo de Saída do Projeto

  • Para criar um instalador independente, defina a propriedade PublishProfilePath no nó Itens de Publicação no projeto de Instalação, usando o caminho relativo de um perfil de publicação com as propriedades corretas definidas.

    Captura de tela que mostra a configuração do perfil de publicação no item de saída do projeto Itens de Publicação.

    Captura de tela da configuração do perfil de publicação no item de saída do projeto Itens de Publicação.

    Antes de definir essa propriedade, crie um perfil de publicação do projeto de aplicativo escolhendo Publicar no menu de contexto do projeto de aplicativo no Gerenciador de Soluções e implante o aplicativo em uma pasta.

Observação

Não há suporte para esse fluxo de trabalho para aplicativos ASP.NET Core, apenas para aplicativos da Área de Trabalho do Windows.

Pré-requisitos

Se quiser que o instalador possa instalar o runtime necessário para um aplicativo .NET Core 3.1 ou .NET 5.0+ dependente da estrutura, você pode fazer isso usando pré-requisitos. Na caixa de diálogo de propriedades do projeto do instalador, abra a caixa de diálogo Pré-requisitos... e você verá as seguintes entradas:

Itens do .NET Core na caixa de diálogo Pré-requisitos

A opção .NET Core Runtime... deve ser selecionada para aplicativos de console, .NET Desktop Runtime... deve ser selecionada para aplicativos WPF e WinForms.

Observação

Esses itens estão presentes começado no Visual Studio 2019 Atualização 7.