Commandos mas usados de .NET CLI

La Interfaz de Linea de Comandos (CLI) de .NET es una herramienta multi plataforma para crear, compilar y correr projectos de .NET. Para mas infomacion acerca de ella puedes visitar la documentacion oficial de microsot aqui.

La interfaz de comandos es de bastante utilidad en los siguientes escenarios:

  • Ambientes donde no cuentas con un IDE
  • Automatizacion de tareas usando scripts
  • Ambientes en los que no tenemos acceso a una interfaz de usuario

Verificar variables de ambiente y version actual

Verificar version de dotnet

Muestra la version del SDK de dotnet que el CLI usara. En caso de que haya multiples versiones instaladas el CLI usara la ultima version disponible por defecto

dotnet --version
List SDKs

List available Software Develpment Kits (SDK) available in the machine. The CLI will use the latest version found by default.

dotnet --list-sdks
Lista de runtimes

Lista los runtime disponibles de .NET Core

dotnet --list-runtimes
Usar una version especifica del SDK

En algunos casos vamos a necesitar usar una version especifica del SDK, Una forma de lograr eso es especificando la version en el archivo globaljson.

dotnet new globaljson --sdk-version [version]
Listar las plantillas disponibels

List available templates; the list will vary depending on the current SDK. Lista las plantillas disponibles, las plantillas van a variar dependiendo de la version del SDK a la que estemos apuntando.

dotnet new --list

Ciclo de desarrollo

Crear una nueva solucion

Crea una nueva solucion en el folder en que es ejecutado o el folder en que se indique como output usando la varable -o.

dotnet new sln -n [solution-name] -o [output-folder]
Agregar un archivo gitignore

Este comando debe ser ejecutado en la raiz del repositorio de git.

dotnet new gitignore
Crear un nuevo proyecto

Crea un nuevo projecto en el path especificado usando la plantilla indicada. Recuerda que este comando solo creara el proyecto pero este aun debe ser agregado a una solucion.

dotnet new [template-name] -n [project-name] -o [output-folder]
Agregar el proyecto a una solucion

Luego de haber creado un proyecto, deberemos agregarlo a una solucion. Este comando debe ser ejectutado desde la carpeta donde se encuentra la solucion.

dotnet sln add [path to the csproj to add]
Agregar un paquete nuget al proyecto

Agrega un packet nuget.

dotnet add [project] package [package-name] --version [version-number]
Build

Compila la solucion.

dotnet build
Run

Corre una aplicacion, automaticamente compilara el solucion antes de eso.

dotnet run --project [path-to-the-project]
Publicar

Publica la aplicacion.

dotnet publish -r win-x64 -c Release -o [output-path]

Ejemplos

Crear una aplicacion de consola con el CLI de .NET
  • Setear la version del SDK a 5.0.403
  • Crear un nuevo folder para la solucion
  • Crear una nueva solucion
  • Navegar a la carpeta de la solucion
  • Crear un folder para el codigo
  • Crear un nuevo proyecto usando la plantila de consola
  • Agregar el proyecto a la solucion
dotnet new globaljson --sdk-version 5.0.403
md ConsoleApp
dotnet new sln -n ConsoleApp -o ConsoleApp
cd ConsoleApp
md src
dotnet new console -n ConsoleApp -o src/ConsoleApp
dotnet sln add src/consoleapp/consoleapp.csproj
dotnet build
dotnet run --project src/consoleapp