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, .NET 5, .NET 6 e 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

  1. Selecione Publicar Itens em vez de Saída Primária para obter a saída correta para projetos .NET Core 3.1 e .NET 5.0 ou posteriores. Para abrir essa caixa de diálogo, selecione Adicionar>Saída do Projeto... no menu de contexto do projeto.

    The Publish Items output group in the Add Project Output Group dialog

  2. Para criar um instalador autossuficiente, defina a propriedade PublishProfilePath no nó Publicar Itens no projeto de instalação, usando o caminho relativo de um perfil de publicação com o conjunto de propriedades correto.

    Setting the publish profile on the Publish Items project output item

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:

.NET Core items in the Prerequisites dialog

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

Observação

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