Dotnet CLI La herramienta de línea de comandos para ASP.NET Core

La CLI de dotnet es una interfaz de línea de comandos (CLI) que es una nueva herramienta para desarrollar aplicaciones .NET. Es una herramienta multiplataforma y se puede utilizar en Windows, MAC o Linux. En este tutorial, aprenderás cómo usar .NET Cli para crear una aplicación ASP.NET Core simples.
Descarga de CLI DotNet
La CLI de DotNet se instala como parte del SDK de Net Core. Puede instalar y descargar el SDK de Net Core y seguir los pasos que explico en este enlace.
La CLI se instala en paralelo. Por lo tanto, se pueden instalar y usar múltiples versiones de CLI Tools
Uso de la CLI de DotNet
La sintaxis de Dotnet CLI consta de tres partes. El driver, el “verbo” y los “argumentos”
dotnet [verbo] [argumentos]
El driver se llama "dotnet
"
El “verbo
” es el comando que desea ejecutar. El comando realiza una acción.
Los “argumentos
” se pasan a los comandos invocados
Comandos más comunes
Estos son algunos de los comandos comúnmente utilizados para dotnet
Comandos | Descripción |
---|---|
new | Crea un nuevo proyecto, archivo de configuración o solución basada en la plantilla especificada. |
restore | Restaura las dependencias y herramientas de un proyecto. |
build | Construye un proyecto y todas sus dependencias. |
publish | Empaqueta la aplicación y sus dependencias en una carpeta para su implementación. |
run | Ejecuta el código fuente sin ningún comando explícito de compilación o ejecución. |
test | Controlador de prueba .NET utilizado para ejecutar pruebas unitarias. |
vstest | Ejecuta pruebas desde los archivos especificados. |
pack | Empaqueta el código en un paquete NuGet. |
migrate | .NET Core a un proyecto .NET Core de otra versión |
clean | Limpia la salida de un proyecto. |
sln | Modifica un archivo de solución de .NET Core. |
help | Muestra documentación más detallada para el comando especificado. |
store | Almacena los ensamblados especificados en el almacén de paquetes de tiempo de ejecución. |
Creación de un nuevo proyecto ASP.NET Core mediante CLI DotNet
Primero, abre el símbolo del sistema o Windows Powershell y crea una carpeta llamada "HelloWorld
"
DotNet new
El comando dotnet new se usa para crear el nuevo proyecto. La sintaxis parcial es la siguiente
dotnet new <TEMPLATE> [--force] [-i|--install] [-lang|--language] [-n|--name] [-o|--output]
Dónde:
TEMPLATE
Template para instanciar cuando se invoca el comando
-force
Fuerza la generación de contenido incluso si cambiaría los archivos existentes. Esto es necesario cuando el directorio de salida ya contiene un proyecto.
-i|– install <PATH|NUGET_ID>
Instala un paquete o template desde la PATH
o NUGET_ID
proporcionados.
-l|–list
Enumera los templates que contienen el nombre especificado. Si se invoca para el comando dotnet new, enumera las posibles plantillas disponibles para el directorio dado. Por ejemplo, si el directorio ya contiene un proyecto, no enumera todas las plantillas de proyecto.
-lang|–language {C#|F#|VB}
El lenguaje del template a crear. El lenguaje aceptado varía según el template (consulta los valores predeterminados en la sección de argumentos). No válido para algunos templates.
-n|–name <OUTPUT_NAME>
El nombre de la salida creado. Si no se especifica ningún nombre, se utiliza el nombre del directorio actual.
-o|–output <OUTPUT_DIRECTORY>
Ubicación para colocar directorio generado. El valor predeterminado es el directorio actual.
-h|–help
Imprime la ayuda.
La lista completa de opciones para dotnet new está disponible aquí
Crear un nuevo proyecto usando dotnet new
El siguiente comando crea un nuevo proyecto dotnet usando el TEMPLATE
dotnet new <TEMPLATE>
Puedes encontrar la lista de TEMPLATES usando
Dotnet new -l
Lista de Templates
Template | Descripción |
---|---|
console | Aplicación de consola |
classlib | Class library |
mstest | Unit Test Project |
xunit | xUnit Test Project |
web | ASP.NET Core Vacía |
mvc | ASP.NET Core Web App (Model-View-Controller) |
razor | ASP.NET Core Web App |
angular | ASP.NET Core with Angular |
react | ASP.NET Core with React.js |
reactredux | ASP.NET Core with React.js and Redux |
webapi | ASP.NET Core Web API |
Para crear una aplicación web vacía usa la plantilla web
Dotnet new web
Restaurando las Dependencias con dotnet restore
Una vez que creamos el nuevo proyecto, tenemos que descargar las dependencias. Esto se hace usando el comando restore
Dotnet restore
Usa –help para obtener ayuda
Dotnet restore –help
Ejecutar la aplicación con dotnet run
Usa dotnet run para iniciar la aplicación
Abre localhost:5000/
en el navegador y deberías poder ver "Hello World
"
Conclusión
Aprendiste a hacer uso de dotnet CLI (interfaz de línea de comandos). Esta herramienta es útil en MAC, Linux y Windows
.