Compartilhar via


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

O empacotamento de aplicativos como MSI geralmente é feito 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:

Projetos do Visual Studio Installer

Projetos do Visual Studio Installer

Atualização para .NET Core e .NET

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

  • Implantações dependentes de estrutura

  • 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 Visual Studio Installer". Ou baixe a extensão diretamente do Marketplace.

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

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

    Para obter informações gerais sobre projetos de configuração (*.vsproj), consulte Projetos de configuração e implantação.

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

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

  • Para obter o resultado correto para projetos .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 essa 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 autossuficiente, defina a propriedade PublishProfilePath no nó Publicar Itens no projeto de Configuração, usando o caminho relativo de um perfil de publicação com o conjunto de propriedades correto.

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

    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.

Nota

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 você 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 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.

Nota

Esses itens estão presentes a partir da versão do Visual Studio 2019 Atualização 7.