Información general sobre la CLI de .NET

  • Artículo

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

La interfaz de la línea de comandos (CLI) de .NET es una cadena de herramientas multiplataforma que sirve para desarrollar, compilar, ejecutar y publicar aplicaciones .NET.

La CLI de .NET se incluye con el SDK de .NET. Para obtener más información sobre cómo instalar el SDK de .NET, vea Instalación de .NET Core.

Comandos de la CLI

De forma predeterminada, se instalan los siguientes comandos:

Comandos básicos

Comandos de modificación del proyecto

Comandos avanzados

Comandos de administración de herramientas

Las herramientas son aplicaciones de consola que se instalan mediante paquetes NuGet y se invocan desde el símbolo del sistema. Puede encargarse de escribir las herramientas o instalar las escritas por terceros. Las herramientas también se denominan herramientas globales, herramientas de ruta de acceso de herramientas y herramientas locales. Para obtener más información, vea la información general sobre las herramientas de .NET.

Estructura de comandos

La estructura de comandos de la CLI consta del controlador ("dotnet"), el comando y posiblemente de los argumentos de comandos y otras opciones. Este patrón se puede ver en la mayoría de las operaciones de la CLI, como la creación de una nueva aplicación de consola y su ejecución desde la línea de comandos, como muestran los siguientes comandos cuando se ejecutan desde un directorio denominado my_app:

dotnet new console
dotnet build --output ./build_output
dotnet ./build_output/my_app.dll

Controlador

El controlador se denomina dotnet y tiene dos responsabilidades, ejecutar una aplicación dependiente del marco o ejecutar un comando.

Para ejecutar una aplicación dependiente del marco, especifique la aplicación después del controlador, por ejemplo, dotnet /path/to/my_app.dll. Cuando ejecute el comando desde la carpeta donde reside la DLL de la aplicación, simplemente ejecute dotnet my_app.dll. Si quiere usar una versión específica del entorno de ejecución .NET, use la opción --fx-version <VERSION> (consulte la referencia del comando dotnet).

Cuando se proporciona un comando para el controlador, dotnet.exe inicia el proceso de ejecución del comando de la CLI. Por ejemplo:

dotnet build

En primer lugar, el controlador determina la versión de SDK que se debe usar. Si no hay ningún archivo global.json, se usa la última versión del SDK disponible. Podría tratarse de una versión preliminar o de una versión estable, en función de lo último que esté disponible en el equipo. Una vez determinada la versión del SDK, se ejecutará el comando.

Comando

El comando realiza una acción. Por ejemplo, dotnet build compila código. dotnet publish publica el código. Los comandos se implementan como una aplicación de consola usando una convención dotnet {command}.

Argumentos

Los argumentos que se pasan en la línea de comandos son los argumentos para el comando invocado. Por ejemplo, cuando ejecuta dotnet publish my_app.csproj, el argumento my_app.csproj indica el proyecto que se publicará y se pasa al comando publish.

Opciones

Las opciones que se pasan en la línea de comandos son las opciones para el comando que se invoca. Por ejemplo, cuando ejecuta dotnet publish --output /build_output, la opción --output y su valor se pasan al comando publish.

Vea también