Tutorial: Publicar um aplicativo de console do .NET usando o Visual Studio Code

Este tutorial mostra como publicar um aplicativo de console para que outros usuários possam executá-lo. A publicação cria o conjunto de arquivos necessários para executar um aplicativo. Para implantar os arquivos, copie-os para o computador de destino.

A CLI do .NET é usada para publicar o aplicativo, para que você possa seguir este tutorial com um editor de código diferente do Visual Studio Code, se preferir.

Pré-requisitos

• Este tutorial funciona com o aplicativo de console que você cria no Criar um aplicativo de console do .NET usando o Visual Studio Code.

Publicar o aplicativo

1. Inicie o Visual Studio Code.

2. Abra a pasta de projeto HelloWorld que você criou no Criar um aplicativo de console .NET usando odo Visual Studio Code.

3. Escolha Exibir>Terminal no menu principal.

   O terminal é aberto na pasta HelloWorld.

4. Execute o seguinte comando:

   dotnet publish
   

   A configuração de build padrão é Release, que é apropriada para um site implantado em produção. A saída da configuração de compilação Release tem o mínimo de informações simbólicas de depuração e é totalmente otimizada.

   A saída do comando é semelhante ao exemplo a seguir:

   Microsoft (R) Build Engine version 17.8.0+b89cb5fde for .NET
   Copyright (C) Microsoft Corporation. All rights reserved.
     Determining projects to restore...
     All projects are up-to-date for restore.
     HelloWorld -> C:\Projects\HelloWorld\bin\Release\net8.0\HelloWorld.dll
     HelloWorld -> C:\Projects\HelloWorld\bin\Release\net8.0\publish\
   

Inspecionar os arquivos

Por padrão, o processo de publicação cria uma implantação dependente da estrutura, que é um tipo de implantação em que o aplicativo publicado é executado em um computador que tem o runtime do .NET instalado. Para executar o aplicativo publicado, você pode usar o arquivo executável ou executar o comando dotnet HelloWorld.dll em um prompt de comando.

Nas etapas a seguir, você examinará os arquivos criados pelo processo de publicação.

1. Selecione o Explorer, na barra de navegação à esquerda.

2. Expanda bin/Release/net8.0/publish.

   

   Como mostra a imagem, a saída publicada inclui os seguintes arquivos:

   • HelloWorld.deps.json

     Esse é o arquivo de dependências de runtime do aplicativo. Ele define os componentes do .NET e as bibliotecas (incluindo a biblioteca de links dinâmicos que contém seu aplicativo) necessárias para executar o aplicativo. Para obter mais informações, confira Arquivos de configuração de runtime.

   • HelloWorld.dll

     Essa é a versão de implantação dependente de estrutura do aplicativo. Para executar essa biblioteca de links dinâmicos, insira dotnet HelloWorld.dll em um prompt de comando. Esse método de execução do aplicativo funciona em qualquer plataforma que tenha o runtime do .NET instalado.

   • HelloWorld.exe (helloworld no Linux ou macOS.)

     Essa é a versão do executável dependente de estrutura do aplicativo. O arquivo é específico do sistema operacional.

   • HelloWorld.pdb (opcional para implantação)

     Esse é o arquivo de símbolos de depuração. Não é necessário implantar esse arquivo junto com seu aplicativo, embora você deve salvá-lo caso precise depurar a versão publicada do aplicativo.

   • HelloWorld.runtimeconfig.json

     Esse é o arquivo de configuração de runtime do aplicativo. Ele identifica a versão do .NET na qual seu aplicativo foi criado para ser executado. Você também pode adicionar opções de configuração a ela. Para obter mais informações, confira Definições de configuração de runtime do .NET.

Executar o aplicativo publicado

1. No Explorer, clique com o botão direito do mouse na pasta publish (Ctrl+clique no macOS) e selecione Abrir no Terminal Integrado.

   menu de Contexto

2. No Windows ou linux, execute o aplicativo usando o executável.

   1. No Windows, insira .\HelloWorld.exe e pressione Enter.

   2. No Linux, insira ./HelloWorld e pressione Enter.

   3. Insira um nome em resposta ao prompt e pressione Enter para sair.

3. Em qualquer plataforma, execute o aplicativo usando o comando dotnet:

   1. Insira dotnet HelloWorld.dll e pressione ENTER.

   2. Insira um nome em resposta ao prompt e pressione Enter para sair.

Recursos adicionais

• Implantação de aplicativo .NET
• Publicar aplicativos .NET com a CLI do .NET
• dotnet publish
• Usar o SDK do .NET em ambientes de CI (integração contínua)

Próximas etapas

Neste tutorial, você publicou um aplicativo de console. No próximo tutorial, você criará uma biblioteca de classes.

Criar uma biblioteca de classes do .NET usando o Visual Studio Code