dotnet run

Artículo
12/06/2023

Este artículo se aplica a: ✔️ SDK de .NET Core 3.1 y versiones posteriores

NOMBRE

dotnet run: ejecuta el código fuente sin comandos explícitos de compilación o inicio.

Sinopsis

dotnet run [-a|--arch <ARCHITECTURE>] [-c|--configuration <CONFIGURATION>]
    [-f|--framework <FRAMEWORK>] [--force] [--interactive]
    [--launch-profile <NAME>] [--no-build]
    [--no-dependencies] [--no-launch-profile] [--no-restore]
    [--os <OS>] [--project <PATH>] [-r|--runtime <RUNTIME_IDENTIFIER>]
    [--tl:[auto|on|off]] [-v|--verbosity <LEVEL>]
    [[--] [application arguments]]

dotnet run -h|--help

Descripción

El comando dotnet run proporciona una opción conveniente para ejecutar la aplicación desde el código fuente con un comando. Es útil para un desarrollo iterativo rápido desde la línea de comandos. El comando depende del comando dotnet build para compilar el código. Los requisitos para la compilación, como que el cliente se deba restaurar primero, también se aplican a dotnet run.

Nota

dotnet run no respeta argumentos como /property:property=value, que sí los respeta dotnet build.

Los archivos de salida se escriben en la ubicación predeterminada, que es bin/<configuration>/<target>. Por ejemplo, si tiene una aplicación netcoreapp2.1 y ejecuta dotnet run, la salida se colocará en bin/Debug/netcoreapp2.1. Los archivos se sobrescriben según sea necesario. Los archivos temporales se colocan en el directorio obj.

Si el proyecto especifica varios marcos, al ejecutar dotnet run se produce un error a menos que se use la opción -f|--framework <FRAMEWORK> para especificar el marco.

El comando dotnet run debe usarse en el contexto de proyectos, no de ensamblados compilados. Si, por el contrario, está intentando ejecutar una DLL de aplicación dependiente del marco de trabajo, debe usar dotnet sin un comando. Por ejemplo, para ejecutar myapp.dll, use:

dotnet myapp.dll

Para obtener más información sobre el controlador dotnet, vea el tema Herramientas de la interfaz de la línea de comandos (CLI) de .NET.

Para ejecutar la aplicación, el comando dotnet run resuelve las dependencias de la aplicación que se encuentran fuera del entorno de tiempo de ejecución compartido desde la caché de NuGet. Dado que se usan dependencias almacenadas en caché, no se recomienda utilizar dotnet run para ejecutar aplicaciones en producción. En su lugar, cree una implementación mediante el comando dotnet publish e implemente la salida publicada.

Restauración implícita

No es necesario ejecutar dotnet restore porque lo ejecutan implícitamente todos los comandos que necesitan que se produzca una restauración, como dotnet new, dotnet build, dotnet run, dotnet test, dotnet publish y dotnet pack. Para deshabilitar la restauración implícita, use la opción --no-restore.

El comando dotnet restore sigue siendo válido en algunos escenarios donde tiene sentido realizar una restauración explícita, como las compilaciones de integración continua en Azure DevOps Services o en los sistemas de compilación que necesitan controlar explícitamente cuándo se produce la restauración.

Para obtener información sobre cómo administrar fuentes de NuGet, vea la documentación de dotnet restore.

Este comando admite las opciones de dotnet restore cuando se pasan con el formato largo (por ejemplo, --source). No se admiten las opciones de formato corto, como -s.

Descargas de manifiestos de cargas de trabajo

Cuando se ejecuta, este comando inicia una descarga asincrónica en segundo plano de manifiestos de publicidad de cargas de trabajo. Si la descarga no ha terminado cuando finaliza el comando, se detiene. Para obtener más información, vea Manifiestos de publicidad.

Opciones

--

Delimita los argumentos a dotnet run a partir de argumentos de la aplicación que se va a ejecutar. Todos los argumentos después de este delimitador se pasan a la aplicación que se ejecuta.

-a|--arch <ARCHITECTURE>

Especifica la arquitectura de destino. Se trata de una sintaxis abreviada para establecer el identificador del entorno de ejecución (RID), donde el valor proporcionado se combina con el RID predeterminado. Por ejemplo, en un equipo win-x64, al especificar --arch x86 se establece el RID en win-x86. Si usa esta opción, no use la opción -r|--runtime. Disponible a partir de .NET 6 (versión preliminar 7).

-c|--configuration <CONFIGURATION>

Define la configuración de compilación. El valor predeterminado para la mayoría de los proyectos es Debug, pero puede invalidar los valores de configuración de compilación en el proyecto.

-f|--framework <FRAMEWORK>

Compila y ejecuta la aplicación con el marco especificado. El marco debe especificarse en el archivo de proyecto.
--force

Fuerza la resolución de todas las dependencias, incluso si la última restauración se realizó correctamente. Especificar esta marca es lo mismo que eliminar el archivo project.assets.json.

-?|-h|--help

Imprime una descripción de cómo usar el comando.

--interactive

Permite que el comando se detenga y espere una entrada o una acción del usuario. Por ejemplo, para completar la autenticación. Disponible desde el SDK de .NET Core 3.0.

--launch-profile <NAME>

El nombre del perfil de inicio (si lo hay) que se usará al iniciar la aplicación. Los perfiles de inicio se definen en el archivo launchSettings.json y se suelen denominar Development, Staging y Production. Para obtener más información, consulte Working with multiple environments (Trabajo con varios entornos).
--no-build

No compila el proyecto antes de ejecutarlo. También establece la marca --no-restore de forma implícita.
--no-dependencies

Al restaurar un proyecto con referencias de proyecto a proyecto (P2P), se restaura el proyecto raíz y no las referencias.
--no-launch-profile

No intenta usar launchSettings.json para configurar la aplicación.
--no-restore

No ejecuta una restauración implícita al ejecutar el comando.

--os <OS>

Especifica el sistema operativo (SO) de destino. Se trata de una sintaxis abreviada para establecer el identificador del entorno de ejecución (RID), donde el valor proporcionado se combina con el RID predeterminado. Por ejemplo, en un equipo win-x64, al especificar --os linux se establece el RID en linux-x64. Si usa esta opción, no use la opción -r|--runtime. Disponible a partir de .NET 6.

--project <PATH>

Especifica la ruta de acceso del archivo del proyecto que se va a ejecutar (nombre de la carpeta o ruta de acceso completa). Si no se especifica, se toma como predeterminado el directorio actual.

La abreviación -p para --project está en desuso a partir del SDK de .NET 6. Por un tiempo limitado a partir del SDK de .NET 6 RC1, -p seguirá pudiéndose usar para --project a pesar de la advertencia de caída en desuso. Si el argumento proporcionado para la opción no contiene =, el comando acepta -p como forma abreviada para --project. De lo contrario, el comando da por supuesto que -p es una forma abreviada para --property. Este uso flexible de -p para --project se eliminará gradualmente en .NET 7.
--property:<NAME>=<VALUE>

Establece una o varias propiedades MSBuild. Especifique varias propiedades delimitadas por punto y coma o repitiendo la opción:
```
--property:<NAME1>=<VALUE1>;<NAME2>=<VALUE2>
--property:<NAME1>=<VALUE1> --property:<NAME2>=<VALUE2>
```
La forma abreviada -p se puede usar para --property. Si el argumento proporcionado para la opción contiene =, -p se acepta como forma abreviada para --property. De lo contrario, el comando da por supuesto que -p es una forma abreviada para --project.

Para pasar --property a la aplicación en lugar de establecer una propiedad MSBuild, proporcione la opción después del separador de sintaxis --, por ejemplo:
```
dotnet run -- --property name=value
```
-r|--runtime <RUNTIME_IDENTIFIER>

Especifica el tiempo de ejecución de destino para el que restaurar los paquetes. Para obtener una lista de identificadores de tiempo de ejecución (RID), consulte el catálogo de RID.

--tl:[auto|on|off]

Especifica si se debe usar el registrador de terminal para la salida de compilación. El valor predeterminado es auto, que primero comprueba el entorno antes de habilitar el registro de terminal. La comprobación del entorno comprueba que el terminal sea capaz de usar características de salida modernas y no usa una salida estándar redirigida antes de habilitar el nuevo registrador. La opción on omite la comprobación del entorno y habilita el registro de terminal. La opción off omite la comprobación del entorno y usa el registrador de consola predeterminado.

El registrador de terminal muestra la fase de restauración seguida de la fase de compilación. Durante cada fase, los proyectos en compilación actuales aparecen en la parte inferior del terminal. Cada proyecto que se compila genera una salida del destino de MSBuild que se está compilando actualmente y la cantidad de tiempo invertido en ese destino. Puede buscar en esta información para obtener más información sobre la compilación. Cuando un proyecto termina de compilarse, se escribe una única sección "compilación completada" en la que se captura lo siguiente:
- El nombre del proyecto compilado.
- La plataforma de destino (si es de destino múltiple).
- El estado de esa compilación.
- La salida principal de esa compilación (con hipervínculo).
- Los diagnósticos generados para ese proyecto.
Esta opción está disponible a partir de .NET 8.

-v|--verbosity <LEVEL>

Establece el nivel de detalle del comando. Los valores permitidos son q[uiet], m[inimal], n[ormal], d[etailed] y diag[nostic]. De manera predeterminada, es minimal. Para obtener más información, vea LoggerVerbosity.

Ejemplos

Ejecución del proyecto en el directorio actual:
```
dotnet run
```

Ejecución del proyecto especificado:

dotnet run --project ./projects/proj1/proj1.csproj

Ejecute el proyecto en el directorio actual, especificando la configuración de versión:
```
dotnet run --property:Configuration=Release
```
Ejecute el proyecto en el directorio actual (el argumento --help en este ejemplo se pasa a la aplicación, dado que se usa la opción -- en blanco):
```
dotnet run --configuration Release -- --help
```
Restaure las dependencias y herramientas del proyecto en el directorio actual para mostrar solo la salida mínima y, después, ejecute el proyecto:
```
dotnet run --verbosity m
```