Tutorial: Publicación de una aplicación de consola de .NET con Visual Studio Code

  • Artículo

En este tutorial se muestra cómo publicar una aplicación de consola para que otros usuarios puedan ejecutarla. La publicación crea el conjunto de archivos que se necesitan para ejecutar una aplicación. Para implementar los archivos, cópielos en el equipo de destino.

La CLI de .NET se usa para publicar la aplicación, por lo que puede seguir este tutorial con un editor de código que no sea Visual Studio Code si lo prefiere.

Requisitos previos

Publicar la aplicación

  1. Inicie Visual Studio Code.

  2. Abra la carpeta de proyecto HelloWorld que ha creado en Creación de una aplicación de consola de .NET con Visual Studio Code.

  3. Elija Ver>Terminal en el menú principal.

    Se abrirá el terminal en la carpeta HelloWorld.

  4. Ejecute el siguiente comando:

    dotnet publish --configuration Release

    La configuración de compilación predeterminada es Depuración, por lo que este comando especifica la versión de la configuración de compilación Versión. La salida de la configuración de compilación Versión tiene muy poca información de depuración simbólica y está totalmente optimizada.

    La salida del comando es similar al ejemplo siguiente:

    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\

Inspección de los archivos

De forma predeterminada, el proceso de publicación crea una implementación dependiente del marco, que es un tipo de implementación donde la aplicación publicada se ejecuta en un equipo que tenga instalado el entorno de ejecución de .NET. Para ejecutar la aplicación publicada, puede usar el archivo ejecutable o ejecutar el comando dotnet HelloWorld.dll desde un símbolo del sistema.

En los pasos siguientes, examinará los archivos creados por el proceso de publicación.

  1. Seleccione Explorador en la barra de navegación izquierda.

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

    Explorer showing published files

    Como se muestra en la imagen, el resultado publicado incluye los siguientes archivos:

    • HelloWorld.deps.json

      Este es el archivo de dependencias en tiempo de ejecución de la aplicación. Define los componentes y las bibliotecas de .NET (incluida la biblioteca de vínculos dinámicos que contiene la aplicación) necesarios para ejecutar la aplicación. Para obtener más información, consulte Archivos de configuración en tiempo de ejecución.

    • HelloWorld.dll

      Esta es la versión de implementación dependiente del marco de la aplicación. Para ejecutar esta biblioteca de vínculos dinámicos, escriba dotnet HelloWorld.dll en un símbolo del sistema. Este método de ejecución de la aplicación funciona en cualquier plataforma que tenga instalado el entorno de ejecución de .NET.

    • HelloWorld.exe (HelloWorld en Linux o macOS.)

      Esta es la versión del ejecutable dependiente del marco de la aplicación. El archivo es específico del sistema operativo.

    • HelloWorld.pdb (opcional para la implementación)

      Este es el archivo de símbolos de depuración. No necesita implementar este archivo junto con su aplicación, aunque se debe guardar en caso de que necesite depurar la versión publicada de la aplicación.

    • HelloWorld.runtimeconfig.json

      Este es el archivo de configuración en tiempo de ejecución de la aplicación. Identifica la versión de .NET en la que se ha compilado la aplicación para ejecutarse. También puede agregarle opciones de configuración. Para obtener más información, consulte Opciones de configuración de entornos de ejecución de .NET.

Ejecutar la aplicación publicada

  1. En el Explorador, haga clic con el botón derecho en la carpeta publish (o presione Ctrl y haga clic en macOS) y seleccione Abrir en terminal integrado.

    Context menu showing Open in Terminal

  2. En Windows o Linux, ejecute la aplicación con el archivo ejecutable.

    1. En Windows, escriba .\HelloWorld.exe y presione Entrar.

    2. En Linux, escriba ./HelloWorld y presione Entrar.

    3. Escriba un nombre cuando se le pida y presione cualquier tecla para salir.

  3. En cualquier plataforma, ejecute la aplicación con el comando dotnet:

    1. Escriba dotnet HelloWorld.dll y presione ENTRAR.

    2. Escriba un nombre cuando se le pida y presione cualquier tecla para salir.

Recursos adicionales

Pasos siguientes

En este tutorial, ha publicado una aplicación de consola. En el siguiente tutorial, creará una biblioteca de clases.

Creación de una biblioteca de clases de .NET con Visual Studio Code

En este tutorial se muestra cómo publicar una aplicación de consola para que otros usuarios puedan ejecutarla. La publicación crea el conjunto de archivos que se necesitan para ejecutar una aplicación. Para implementar los archivos, cópielos en el equipo de destino.

La CLI de .NET se usa para publicar la aplicación, por lo que puede seguir este tutorial con un editor de código que no sea Visual Studio Code si lo prefiere.

Requisitos previos

Publicar la aplicación

  1. Inicie Visual Studio Code.

  2. Abra la carpeta de proyecto HelloWorld que ha creado en Creación de una aplicación de consola de .NET con Visual Studio Code.

  3. Elija Ver>Terminal en el menú principal.

    Se abrirá el terminal en la carpeta HelloWorld.

  4. Ejecute el siguiente comando:

    dotnet publish --configuration Release

    La configuración de compilación predeterminada es Depuración, por lo que este comando especifica la versión de la configuración de compilación Versión. La salida de la configuración de compilación Versión tiene muy poca información de depuración simbólica y está totalmente optimizada.

    La salida del comando es similar al ejemplo siguiente:

    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\

Inspección de los archivos

De forma predeterminada, el proceso de publicación crea una implementación dependiente del marco, que es un tipo de implementación donde la aplicación publicada se ejecuta en un equipo que tenga instalado el entorno de ejecución de .NET. Para ejecutar la aplicación publicada, puede usar el archivo ejecutable o ejecutar el comando dotnet HelloWorld.dll desde un símbolo del sistema.

En los pasos siguientes, examinará los archivos creados por el proceso de publicación.

  1. Seleccione Explorador en la barra de navegación izquierda.

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

    Explorer showing published files

    Como se muestra en la imagen, el resultado publicado incluye los siguientes archivos:

    • HelloWorld.deps.json

      Este es el archivo de dependencias en tiempo de ejecución de la aplicación. Define los componentes y las bibliotecas de .NET (incluida la biblioteca de vínculos dinámicos que contiene la aplicación) necesarios para ejecutar la aplicación. Para obtener más información, consulte Archivos de configuración en tiempo de ejecución.

    • HelloWorld.dll

      Esta es la versión de implementación dependiente del marco de la aplicación. Para ejecutar esta biblioteca de vínculos dinámicos, escriba dotnet HelloWorld.dll en un símbolo del sistema. Este método de ejecución de la aplicación funciona en cualquier plataforma que tenga instalado el entorno de ejecución de .NET.

    • HelloWorld.exe (HelloWorld en Linux, no creada en macOS).

      Esta es la versión del ejecutable dependiente del marco de la aplicación. El archivo es específico del sistema operativo.

    • HelloWorld.pdb (opcional para la implementación)

      Este es el archivo de símbolos de depuración. No necesita implementar este archivo junto con su aplicación, aunque se debe guardar en caso de que necesite depurar la versión publicada de la aplicación.

    • HelloWorld.runtimeconfig.json

      Este es el archivo de configuración en tiempo de ejecución de la aplicación. Identifica la versión de .NET en la que se ha compilado la aplicación para ejecutarse. También puede agregarle opciones de configuración. Para obtener más información, consulte Opciones de configuración de entornos de ejecución de .NET.

Ejecutar la aplicación publicada

  1. En el Explorador, haga clic con el botón derecho en la carpeta publish (o presione Ctrl y haga clic en macOS) y seleccione Abrir en terminal.

    Context menu showing Open in Terminal

  2. En Windows o Linux, ejecute la aplicación con el archivo ejecutable.

    1. En Windows, escriba .\HelloWorld.exe y presione Entrar. En Windows con el terminal de Bash, escriba ./HelloWorld.exe.

    2. En Linux, escriba ./HelloWorld y presione Entrar.

    3. Escriba un nombre cuando se le pida y presione cualquier tecla para salir.

  3. En cualquier plataforma, ejecute la aplicación con el comando dotnet:

    1. Escriba dotnet HelloWorld.dll y presione ENTRAR.

    2. Escriba un nombre cuando se le pida y presione cualquier tecla para salir.

Recursos adicionales

Pasos siguientes

En este tutorial, ha publicado una aplicación de consola. En el siguiente tutorial, creará una biblioteca de clases.

Creación de una biblioteca de clases de .NET con Visual Studio Code

En este tutorial se muestra cómo publicar una aplicación de consola para que otros usuarios puedan ejecutarla. La publicación crea el conjunto de archivos que se necesitan para ejecutar una aplicación. Para implementar los archivos, cópielos en el equipo de destino.

La CLI de .NET se usa para publicar la aplicación, por lo que puede seguir este tutorial con un editor de código que no sea Visual Studio Code si lo prefiere.

Requisitos previos

Publicar la aplicación

  1. Inicie Visual Studio Code.

  2. Abra la carpeta de proyecto HelloWorld que ha creado en Creación de una aplicación de consola de .NET con Visual Studio Code.

  3. Elija Ver>Terminal en el menú principal.

    Se abrirá el terminal en la carpeta HelloWorld.

  4. Ejecute el siguiente comando:

    dotnet publish --configuration Release

    La configuración de compilación predeterminada es Depuración, por lo que este comando especifica la versión de la configuración de compilación Versión. La salida de la configuración de compilación Versión tiene muy poca información de depuración simbólica y está totalmente optimizada.

    La salida del comando es similar al ejemplo siguiente:

    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\

Inspección de los archivos

De forma predeterminada, el proceso de publicación crea una implementación dependiente del marco, que es un tipo de implementación donde la aplicación publicada se ejecuta en un equipo que tenga instalado el entorno de ejecución de .NET. Para ejecutar la aplicación publicada, puede usar el archivo ejecutable o ejecutar el comando dotnet HelloWorld.dll desde un símbolo del sistema.

En los pasos siguientes, examinará los archivos creados por el proceso de publicación.

  1. Seleccione Explorador en la barra de navegación izquierda.

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

    Explorer showing published files

    Como se muestra en la imagen, el resultado publicado incluye los siguientes archivos:

    • HelloWorld.deps.json

      Este es el archivo de dependencias en tiempo de ejecución de la aplicación. Define los componentes y las bibliotecas de .NET (incluida la biblioteca de vínculos dinámicos que contiene la aplicación) necesarios para ejecutar la aplicación. Para obtener más información, consulte Archivos de configuración en tiempo de ejecución.

    • HelloWorld.dll

      Esta es la versión de implementación dependiente del marco de la aplicación. Para ejecutar esta biblioteca de vínculos dinámicos, escriba dotnet HelloWorld.dll en un símbolo del sistema. Este método de ejecución de la aplicación funciona en cualquier plataforma que tenga instalado el entorno de ejecución de .NET.

    • HelloWorld.exe (HelloWorld en Linux, no creada en macOS).

      Esta es la versión del ejecutable dependiente del marco de la aplicación. El archivo es específico del sistema operativo.

    • HelloWorld.pdb (opcional para la implementación)

      Este es el archivo de símbolos de depuración. No necesita implementar este archivo junto con su aplicación, aunque se debe guardar en caso de que necesite depurar la versión publicada de la aplicación.

    • HelloWorld.runtimeconfig.json

      Este es el archivo de configuración en tiempo de ejecución de la aplicación. Identifica la versión de .NET en la que se ha compilado la aplicación para ejecutarse. También puede agregarle opciones de configuración. Para obtener más información, consulte Opciones de configuración de entornos de ejecución de .NET.

Ejecutar la aplicación publicada

  1. En el Explorador, haga clic con el botón derecho en la carpeta publish (o presione Ctrl y haga clic en macOS) y seleccione Abrir en terminal.

    Context menu showing Open in Terminal

  2. Ejecute la aplicación con el archivo ejecutable.

    1. En Windows, escriba .\HelloWorld.exe y presione Entrar.

    2. En Linux o macOS, escriba ./HelloWorld y presione Entrar.

    3. Escriba un nombre cuando se le pida y presione cualquier tecla para salir.

  3. En cualquier plataforma, ejecute la aplicación con el comando dotnet:

    1. Escriba dotnet HelloWorld.dll y presione ENTRAR.

    2. Escriba un nombre cuando se le pida y presione cualquier tecla para salir.

Recursos adicionales

Pasos siguientes

En este tutorial, ha publicado una aplicación de consola. En el siguiente tutorial, creará una biblioteca de clases.

Creación de una biblioteca de clases de .NET con Visual Studio Code