Partilhar via

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

  • Artigo

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 a máquina 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

Publicar a aplicação

  1. Inicie o Visual Studio Code.

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

  3. Escolha View>Terminal no menu principal.

    O terminal abre na pasta HelloWorld .

  4. Execute o seguinte comando:

    dotnet publish --configuration Release

    A configuração de compilação padrão é Debug, portanto, este comando especifica a configuração de compilação de versão . A saída da configuração de compilação Release tem informações mínimas de depuração simbólica 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 uma máquina que tem o tempo de execução do .NET instalado. Para executar o aplicativo publicado, você pode usar o arquivo executável ou executar o comando em dotnet HelloWorld.dll 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.

    Explorer showing published files

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

    • HelloWorld.deps.json

      Este é o arquivo de dependências de tempo de execução do aplicativo. Ele define os componentes .NET e as bibliotecas (incluindo a biblioteca de vínculo dinâmico que contém seu aplicativo) necessários para executar o aplicativo. Para obter mais informações, consulte Arquivos de configuração de tempo de execução.

    • HelloWorld.dll

      Esta é a versão de implantação dependente da estrutura do aplicativo. Para executar essa biblioteca de vínculo dinâmico, digite dotnet HelloWorld.dll em um prompt de comando. Esse método de execução do aplicativo funciona em qualquer plataforma que tenha o tempo de execução do .NET instalado.

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

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

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

      Este é o arquivo de símbolos de depuração. Você não é obrigado a implantar esse arquivo junto com seu aplicativo, embora deva salvá-lo no caso de precisar depurar a versão publicada do seu aplicativo.

    • HelloWorld.runtimeconfig.json

      Este é o arquivo de configuração de tempo de execução 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 ele. Para obter mais informações, consulte Definições de configuração de tempo de execução do .NET.

Executar o aplicativo publicado

  1. No Explorer, clique com o botão direito do mouse na pasta de publicação (clique com a tecla Ctrl pressionada no macOS) e selecione Abrir no Terminal Integrado.

    Context menu showing Open in Terminal

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

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

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

    3. Digite um nome em resposta ao prompt e pressione qualquer tecla para sair.

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

    1. Digite dotnet HelloWorld.dll e pressione Enter.

    2. Digite um nome em resposta ao prompt e pressione qualquer tecla para sair.

Recursos adicionais

Próximos passos

Neste tutorial, você publicou um aplicativo de console. No próximo tutorial, você cria 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 a máquina 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

Publicar a aplicação

  1. Inicie o Visual Studio Code.

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

  3. Escolha View>Terminal no menu principal.

    O terminal abre na pasta HelloWorld .

  4. Execute o seguinte comando:

    dotnet publish --configuration Release

    A configuração de compilação padrão é Debug, portanto, este comando especifica a configuração de compilação de versão . A saída da configuração de compilação Release tem informações mínimas de depuração simbólica 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 da estrutura, que é um tipo de implantação em que o aplicativo publicado é executado em uma máquina que tem o tempo de execução do .NET instalado. Para executar o aplicativo publicado, você pode usar o arquivo executável ou executar o comando em dotnet HelloWorld.dll 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.

    Explorer showing published files

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

    • HelloWorld.deps.json

      Este é o arquivo de dependências de tempo de execução do aplicativo. Ele define os componentes .NET e as bibliotecas (incluindo a biblioteca de vínculo dinâmico que contém seu aplicativo) necessários para executar o aplicativo. Para obter mais informações, consulte Arquivos de configuração de tempo de execução.

    • HelloWorld.dll

      Esta é a versão de implantação dependente da estrutura do aplicativo. Para executar essa biblioteca de vínculo dinâmico, digite dotnet HelloWorld.dll em um prompt de comando. Esse método de execução do aplicativo funciona em qualquer plataforma que tenha o tempo de execução do .NET instalado.

    • HelloWorld.exe (HelloWorld no Linux, não criado no macOS.)

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

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

      Este é o arquivo de símbolos de depuração. Você não é obrigado a implantar esse arquivo junto com seu aplicativo, embora deva salvá-lo no caso de precisar depurar a versão publicada do seu aplicativo.

    • HelloWorld.runtimeconfig.json

      Este é o arquivo de configuração de tempo de execução 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 ele. Para obter mais informações, consulte Definições de configuração de tempo de execução do .NET.

Executar o aplicativo publicado

  1. No Explorer, clique com o botão direito do mouse na pasta de publicação (clique com a tecla Ctrl pressionada no macOS) e selecione Abrir no Terminal.

    Context menu showing Open in Terminal

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

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

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

    3. Digite um nome em resposta ao prompt e pressione qualquer tecla para sair.

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

    1. Digite dotnet HelloWorld.dll e pressione Enter.

    2. Digite um nome em resposta ao prompt e pressione qualquer tecla para sair.

Recursos adicionais

Próximos passos

Neste tutorial, você publicou um aplicativo de console. No próximo tutorial, você cria 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 a máquina 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

Publicar a aplicação

  1. Inicie o Visual Studio Code.

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

  3. Escolha View>Terminal no menu principal.

    O terminal abre na pasta HelloWorld .

  4. Execute o seguinte comando:

    dotnet publish --configuration Release

    A configuração de compilação padrão é Debug, portanto, este comando especifica a configuração de compilação de versão . A saída da configuração de compilação Release tem informações mínimas de depuração simbólica 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 da estrutura, que é um tipo de implantação em que o aplicativo publicado é executado em uma máquina que tem o tempo de execução do .NET instalado. Para executar o aplicativo publicado, você pode usar o arquivo executável ou executar o comando em dotnet HelloWorld.dll 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.

    Explorer showing published files

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

    • HelloWorld.deps.json

      Este é o arquivo de dependências de tempo de execução do aplicativo. Ele define os componentes .NET e as bibliotecas (incluindo a biblioteca de vínculo dinâmico que contém seu aplicativo) necessários para executar o aplicativo. Para obter mais informações, consulte Arquivos de configuração de tempo de execução.

    • HelloWorld.dll

      Esta é a versão de implantação dependente da estrutura do aplicativo. Para executar essa biblioteca de vínculo dinâmico, digite dotnet HelloWorld.dll em um prompt de comando. Esse método de execução do aplicativo funciona em qualquer plataforma que tenha o tempo de execução do .NET instalado.

    • HelloWorld.exe (HelloWorld no Linux, não criado no macOS.)

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

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

      Este é o arquivo de símbolos de depuração. Você não é obrigado a implantar esse arquivo junto com seu aplicativo, embora deva salvá-lo no caso de precisar depurar a versão publicada do seu aplicativo.

    • HelloWorld.runtimeconfig.json

      Este é o arquivo de configuração de tempo de execução 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 ele. Para obter mais informações, consulte Definições de configuração de tempo de execução do .NET.

Executar o aplicativo publicado

  1. No Explorer, clique com o botão direito do mouse na pasta de publicação (clique com a tecla Ctrl pressionada no macOS) e selecione Abrir no Terminal.

    Context menu showing Open in Terminal

  2. Execute o aplicativo usando o executável.

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

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

    3. Digite um nome em resposta ao prompt e pressione qualquer tecla para sair.

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

    1. Digite dotnet HelloWorld.dll e pressione Enter.

    2. Digite um nome em resposta ao prompt e pressione qualquer tecla para sair.

Recursos adicionais

Próximos passos

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

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