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