Tutorial: Publicación de una aplicación de consola de .NET mediante 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 necesarios para ejecutar una aplicación. Para implementar los archivos, cópielos en la máquina de destino.

La CLI de .NET se usa para publicar la aplicación.

Prerrequisitos

Este tutorial funciona con la aplicación de consola que se crea en Creación de una aplicación de consola de .NET mediante Visual Studio Code.

Publicación de la aplicación

Inicie Visual Studio Code.
Abra la carpeta del proyecto HelloWorld que creó en Crear una aplicación de consola .NET usando Visual Studio Code.
Elija Ver>Terminal en el menú principal.

El terminal se abre en la carpeta HelloWorld.
Ejecute el siguiente comando:
```
dotnet publish
```
La configuración de compilación predeterminada es release, que es adecuada para un sitio implementado que se ejecuta en producció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:
```
Restore complete (1.1s)
  HelloWorld net10.0 succeeded (7.8s) → bin\Release\net10.0\publish\

Build succeeded in 10.3s
```

Abra el espacio de código de GitHub que creó en Creación de una aplicación de consola de .NET mediante Visual Studio Code.
Agregue la siguiente línea de código a la parte superior de HelloWorld.cs:
```
#:property PublishAot=false
```
Esta directiva de propiedad deshabilita la compilación nativa de antemano (AOT) y la aplicación usará el compilador Just-In-Time (JIT) estándar en tiempo de ejecución. La salida publicada dependerá del marco de trabajo.
En el terminal, asegúrese de que se encuentra en la carpeta tutoriales .

Ejecute el siguiente comando:

dotnet publish HelloWorld.cs

El comando crea un archivo ejecutable independiente.

La salida del comando es similar al ejemplo siguiente:

Restore complete (0.5s)
  HelloWorld net10.0 succeeded (4.0s) → artifacts\HelloWorld\

Build succeeded in 5.1s

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 tiene 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.

Seleccione Explorador en la barra de navegación izquierda.
Expanda bin/Release/net10.0/publish.

Como se muestra en la imagen, la salida publicada 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 de .NET y las bibliotecas (incluida la biblioteca de vínculos dinámicos que contiene la aplicación) necesarias 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 terminal. 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 es necesario implementar este archivo junto con la aplicación, aunque debe guardarlo 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 creó 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.

Para una aplicación de archivo único, el proceso de publicación crea un directorio de artefactos con un archivo de ensamblado compilado. La aplicación publicada se puede ejecutar mediante el dotnet comando .

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

Seleccione Explorador en la barra de navegación izquierda.
Expanda artefactos/HelloWorld.

Como se muestra en la imagen, la salida publicada incluye los siguientes archivos:
- HelloWorld
  
  Esta es la versión del ejecutable dependiente del marco de la aplicación. El archivo es específico del sistema operativo. Codespaces se ejecuta en Linux, por lo que se trata de un ejecutable de Linux.
- HelloWorld.deps.json
  
  Este es el archivo de dependencias en tiempo de ejecución de la aplicación. Define los componentes de .NET y las bibliotecas (incluida la biblioteca de vínculos dinámicos que contiene la aplicación) necesarias 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 terminal. 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.pdb (opcional para la implementación)
  
  Este es el archivo de símbolos de depuración. No es necesario implementar este archivo junto con la aplicación, aunque debe guardarlo 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 creó 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.
Haga clic con el botón derecho y seleccione Descargar... para descargar archivos de Codespaces en el equipo local.

Ejecución de la aplicación publicada

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.

menú contextual de
En Windows o Linux, ejecute la aplicación mediante el ejecutable.
1. En Windows, escriba .\HelloWorld.exe y presione Entrar.
2. En Linux, escriba ./HelloWorld y presione Entrar.
3. Escriba un nombre en respuesta a la indicación y presione Intro para salir.
En cualquier plataforma, ejecute la aplicación mediante el comando dotnet:
1. Introduzca dotnet HelloWorld.dll y presione . Luego, ingrese.
2. Escriba un nombre en respuesta a la indicación y presione Intro para salir.

En el Explorador, haga clic con el botón derecho en la carpeta artifacts/HelloWorld y seleccione Abrir en terminal integrado.
Ejecute la aplicación mediante el ejecutable. Escriba ./HelloWorld y presione Entrar.
Escriba un nombre en respuesta a la indicación y presione Intro para salir.

Recursos adicionales

Limpieza de recursos

GitHub elimina automáticamente Codespace después de 30 días de inactividad. Si tiene previsto explorar más tutoriales en esta serie, puede dejar su Codespace disponible. Si estás listo para visitar el sitio de .NET y descargar el SDK de .NET, puedes eliminar tu espacio de código. Para eliminar Codespace, abra una ventana del explorador y vaya a Codespaces. Ves una lista de tus espacios de código en la ventana. Seleccione los tres puntos (...) de la entrada del espacio de código del tutorial de aprendizaje. A continuación, seleccione "eliminar".

Pasos siguientes

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

Crear una biblioteca de clases de .NET con Visual Studio Code

Ohar-bidaltzea

Lagungarria izan al da orrialde hau?

Last updated on 2026-02-05