Tutorial: publicar um aplicativo de console do .NET usando 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, portanto, você pode 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 em Criar um aplicativo de console .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 em Criar um aplicativo de console .NET usando o Visual Studio Code.

3. Escolha Exibir>Terminal no menu principal.

   O terminal é aberto na pasta HelloWorld.

4. Execute o comando a seguir:

   dotnet publish --configuration Release
   

   A configuração de compilação padrão é Debug, portanto, esse comando especifica a configuração de compilação Release. 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 de estrutura, que é um tipo de implantação em que o aplicativo publicado é executado em um computador que tenha 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/net7.0/publish.

   

   Como mostra a imagem anterior, 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 e as bibliotecas do .NET (incluindo a biblioteca de vínculo dinâmico que contém o aplicativo) necessários 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, não criado no 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 juntamente com seu aplicativo, embora você deva salvá-lo caso precise depurar a versão publicada do seu aplicativo.

   • HelloWorld.runtimeconfig.json

     Esse é o arquivo de configuração de runtime do aplicativo. Ele identifica a versão do .NET com base na qual o aplicativo foi criado para ser executado. Você também pode adicionar opções de configuração a ele. 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.

   

2. No Windows ou no 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 à solicitação e pressione qualquer tecla 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 à solicitação e pressione qualquer tecla para sair.

Recursos adicionais

• Implantação de aplicativos .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 .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, portanto, você pode 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 em Criar um aplicativo de console .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 em Criar um aplicativo de console .NET usando o Visual Studio Code.

3. Escolha Exibir>Terminal no menu principal.

   O terminal é aberto na pasta HelloWorld.

4. Execute o comando a seguir:

   dotnet publish --configuration Release
   

   A configuração de compilação padrão é Debug, portanto, esse comando especifica a configuração de compilação Release. 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 16.7.4+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\net7.0\HelloWorld.dll
     HelloWorld -> C:\Projects\HelloWorld\bin\Release\net7.0\publish\
   

Inspecionar os arquivos

Por padrão, o processo de publicação cria uma implantação dependente de estrutura, que é um tipo de implantação em que o aplicativo publicado é executado em um computador que tenha 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/net7.0/publish.

   

   Como mostra a imagem anterior, 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 e as bibliotecas do .NET (incluindo a biblioteca de vínculo dinâmico que contém o aplicativo) necessários 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, não criado no 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 juntamente com seu aplicativo, embora você deva salvá-lo caso precise depurar a versão publicada do seu aplicativo.

   • HelloWorld.runtimeconfig.json

     Esse é o arquivo de configuração de runtime do aplicativo. Ele identifica a versão do .NET com base na qual o aplicativo foi criado para ser executado. Você também pode adicionar opções de configuração a ele. 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.

   

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

   1. No Windows, insira .\HelloWorld.exe e pressione Enter. No Windows, com o terminal Bash, insira ./HelloWorld.exe.

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

   3. Insira um nome em resposta à solicitação e pressione qualquer tecla 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 à solicitação e pressione qualquer tecla para sair.

Recursos adicionais

• Implantação de aplicativos .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 .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, portanto, você pode 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 em Criar um aplicativo de console .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 em Criar um aplicativo de console .NET usando o Visual Studio Code.

3. Escolha Exibir>Terminal no menu principal.

   O terminal é aberto na pasta HelloWorld.

4. Execute o comando a seguir:

   dotnet publish --configuration Release
   

   A configuração de compilação padrão é Debug, portanto, esse comando especifica a configuração de compilação Release. 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 16.7.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\net6.0\HelloWorld.dll
     HelloWorld -> C:\Projects\HelloWorld\bin\Release\net6.0\publish\
   

Inspecionar os arquivos

Por padrão, o processo de publicação cria uma implantação dependente de estrutura, que é um tipo de implantação em que o aplicativo publicado é executado em um computador que tenha 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/net6.0/publish.

   

   Como mostra a imagem anterior, 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 e as bibliotecas do .NET (incluindo a biblioteca de vínculo dinâmico que contém o aplicativo) necessários 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, não criado no 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 juntamente com seu aplicativo, embora você deva salvá-lo caso precise depurar a versão publicada do seu aplicativo.

   • HelloWorld.runtimeconfig.json

     Esse é o arquivo de configuração de runtime do aplicativo. Ele identifica a versão do .NET com base na qual o aplicativo foi criado para ser executado. Você também pode adicionar opções de configuração a ele. 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.

   

2. Execute o aplicativo usando o executável.

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

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

   3. Insira um nome em resposta à solicitação e pressione qualquer tecla 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 à solicitação e pressione qualquer tecla para sair.

Recursos adicionais

• Implantação de aplicativos .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 .NET usando o Visual Studio Code