Unidad 2

Descargar estos apunte en pdf o html

Índice

Instalación y entorno

Kit de instalación portable preparado para el curso 2026/27

En este enlace a una carpeta de OneDrive puedes encontrar el archivo PortablePRG.zip con la instalación portable de .NET SDK 10 y VSCode que vamos a utilizar durante todo el curso 2026/27 incluidas las pruebas prácticas.

Para poder acceder al enlace de la carpeta debes estar autenticado con tu cuenta de alu.edu.gva.es. Si no lo estás, te pedirá que te autentiques. Si aún no tienes acceso a tu cuenta, puedes seguir los pasos descritos en la en siguiente punto de ampliación.

En el siguiente enlace puedes encontrar una guía con los pasos que se han seguido para generar esta configuración portable donde si tienes tiempo puedes profundizar en los elementos que la componen y cómo se ha generado.

Instalación portable

Debería ya estar todo preparado para que podamos empezar a trabajar con VSCode y .NET SDK 10 ejecutando el script inicio.cmd nos establecerá el entrono de ejecución portable.

Esta unidad virtual (V:\) nos permitirá tener una ruta fija con la que se realizó la instalación y por tanto permitirá que las extensiones de VSCode que almacenan rutas absolutas funcionen correctamente. Además, se establecerán las variables de entorno necesarias para que el SDK de .NET funcione correctamente.

Por último, el script cli.cmd nos abrirá un terminal de comandos (cmd) situado en la carpeta V:\proyectos con todas las variables de entorno necesarias para poder trabajar con .NET SDK 10 a través de la CLI dotnet.

Descripción de la instalación portable (Ampliación)

Aunque quizá no entiendas algún concepto en este momento, si tienes interés en saber más sobre la instalación portable, puedes leer el siguiente descripción a continuación ...

1. Configuración de usuario del SDK de .NET:

   V:\dotnet_localconfig es la carpeta que hemos elegido para guardar la configuración del SDK de .NET. En ella, además de los datos de configuración del SDK de .NET, se guardará la caché de paquetes y herramientas de NuGet. Ya entenderás a qué nos referimos con esto último durante el curso.

   Si hubiéramos instalado el SDK de .NET de forma 'normal', esto es, a través del instalador. La configuración del mismo se guardaría en la carpeta C:\Users\alumno\.dotnet para nuestro usuario alumno.

2. Ubicación del .NET y el SDK:

   Dentro de la carpeta V:\dotnet se encuentra el .NET SDK y el Runtime. En el hay muchas carpetas y ficheros, pero la más importante es la carpeta sdk donde se encuentran las diferentes versiones del SDK de .NET que tengamos instaladas. En nuestro caso, solo tenemos la versión 10.0.302 que es la que vamos a utilizar durante el curso.

3. Proyectos de C#:

   Dentro de la carpeta V:\proyectos es donde guardaremos todos los proyectos que vayamos creando durante el curso. De entrada puedes encontrar dos carpetas ejemplo y ejemplo_con_test que son dos proyectos de ejemplo con el típico "Hello World" y con los cuales podremos probar que la instalación funciona correctamente. Como su nombre indica, el segundo proyecto tiene además un proyecto de test asociado, para permitirnos probar la ejecución de test unitarios con xUnit.

4. VSCode portable:

   Dentro de la carpeta V:\vscode se encuentra la instalación portable de VSCode con las que nos permitirán trabajar con C# y .NET ya instaladas.

Entorno de desarrollo

Editores de desarrollo generalistas

Se trata de editores 'ligeros' que nos permiten trabajar con diferentes lenguajes de programación y tecnologías. Suelen ser multiplataforma, incluso On-Line a través del navegador.

El más popular y que prácticamente tiene una posición dominante en la actualidad es Visual Studio Code (VSCode) (Microsoft). Es un editor Open Source bastante ligero con infinidad de extensiones creadas por la 'comunidad'.
Aunque su uso más popular es para el desarrollo Web. También nos permitirá afrontar una gran cantidad de desarrollos en lenguajes y tecnologías diferentes como C#.
Además, muchos de los entornos más 'populares' no CLI basados en IA como Cursor (SpaceX), Antigravity (Google), etc. están basados en VSCode y sus extensiones. Por lo que es interesante conocerlo y dominarlo.

Entornos integrados de desarrollo

Arriba tienes un ranking obtenido de PYPL que es un índice de popularidad obtenido a partir de las tendencias de búsqueda en Google de los diferentes IDEs y editores de desarrollo.

Creación desde la línea de comandos (CLI)

La gestión de proyectos se hace con la CLI dotnet. Pero para poder usar el .NET instalado en nuestra versión portable, tendremos dos opciones:

1. [Recomendada] Ejecutar el script cli.cmd que nos abrirá un terminal de comandos (cmd) situado en la carpeta V:\proyectos y que contendrá todas las variables de entorno necesarias para poder trabajar con nuestro .NET SDK 10 portable.
2. [Alternativa] Ejecutar el script inicio.cmd que nos abrirá uns instancia de VSCode con la configuración portable y que a través de la opción de menú Terminal → Nuevo Terminal o (Ctrl + Shift + ñ) nos abrirá un terminal de comandos (cmd) situado en la parte inferior de VSCode. Deberíamos manualmente situarnos en la carpeta V:\proyectos con el comando cd /d V:\proyectos.

Por ejemplo, para crear un proyecto desde consola usaremos dotnet new y en concreto para crea una aplicación de consola ejecutaremos dotnet new console -n <nombre> siguiendo los siguiente pasos:

1. Creamos una carpeta a modo de workspace donde guardaremos los proyectos de ejemplo de la unidad. Por ejemplo, V:\proyectos\u2ejemplos y nos situamos en ella ejecutando los siguientes comandos:

    V:\proyectos> mkdir u2ejemplos
    V:\proyectos> cd u2ejemplos

2. Creamos un proyecto de consola con el nombre ejemplo1 ejecutando el siguiente comando:

    V:\proyectos\u2ejemplos> dotnet new console -n ejemplo1
    
    La plantilla "Aplicación de consola" se creó correctamente.
    Procesando acciones posteriores a la creación...
    Restaurando V:\proyectos\u2ejemplos\ejemplo1\ejemplo1.csproj:
    Restauración realizada correctamente.

<Project Sdk="Microsoft.NET.Sdk">

  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <TargetFramework>net10.0</TargetFramework>
    <ImplicitUsings>enable</ImplicitUsings>
    <Nullable>enable</Nullable>
  </PropertyGroup>

</Project>

Definiendo una solución para asociar nuestro proyecto

Es un punto que ha cambiado bastante en .NET 10 respecto a versiones anteriores, en .NET 10 podremos:

1. Crear un proyecto sin solución asociada. Esto es lo que hemos hecho en el ejemplo anterior.
2. Crear una solución con un único proyecto asociado. Esto es lo que hace Visual Studio Community por defecto.
3. Crear una solución y asociarle uno o varios proyectos. Por ejemplo, una aplicación de consola y un proyecto de test unitarios. Esto es lo que haremos más adelante en el curso.
4. Ejecutar un fuente de código sin necesidad de crear un proyecto ni una solución.

Podemos decir que una solución es un contenedor o unidad organizativa que nos permite agrupar uno o varios proyectos. Aunque no es obligatorio, es recomendable crear una solución para cada proyecto que creemos.

Por ejemplo, para crear una solución para nuestro proyecto de ejemplo y asociarle el proyecto ya creado, ejecutaremos los siguientes comandos:

1. Creamos la solución ejemplo1.slnx ejecutando el siguiente comando:

    V:\proyectos\u2ejemplos> dotnet new sln -n ejemplo1
    
    La plantilla "Archivo de la solución" se creó correctamente.

2. Asociamos el proyecto ejemplo1.csproj a la solución ejemplo1.slnx ejecutando el siguiente comando:

    V:\proyectos\u2ejemplos> dotnet sln ejemplo1.slnx add ejemplo1\ejemplo1.csproj
    
    Se ha agregado el proyecto "ejemplo1\ejemplo1.csproj" a la solución.slnx'.

   Fíjate que hemos tenido que indicar la ruta relativa del proyecto ejemplo1\ejemplo1.csproj ya que el comando dotnet sln add se ejecuta desde la carpeta donde se encuentra la solución y no desde la carpeta del proyecto.

<Solution>
  <Project Path="ejemplo1/ejemplo1.csproj" />
</Solution>

Compilando un proyecto

Tendremos dos opciones:

1. Compilamos todos los proyectos dentro de la solución. Como en nuestro caso solo hay un proyecto, se compilará únicamente ese. Ejecutaremos el siguiente comando:

    V:\proyectos\u2ejemplos> dotnet build ejemplo1.slnx

   Si hay una única solución en la carpeta, podemos omitir el nombre de la solución y ejecutar el siguiente comando:

    V:\proyectos\u2ejemplos> dotnet build

2. Compilamos un proyecto concreto. Ejecutaremos el siguiente comando:

    V:\proyectos\u2ejemplos> dotnet build ejemplo1\ejemplo1.csproj

En ambos casos antes de la compilación se ha ejecutado automáticamente un proceso de restauración de paquetes y herramientas que podríamos haber ejecutado manualmente con el comando dotnet restore ejemplo1\ejemplo1.csproj. Esto condición necesaria para que el proyecto pueda compilar correctamente.

Ejecutando un proyecto

No podremos ejecutar directamente una solución pues puede estar compuesta por más de una proyecto ejecutable y no sabría cuál ejecutar. Por lo que deberemos ejecutar un proyecto concreto. Tendremos también varias opciones:

1. [Recomendada] Situándonos en la carpeta del proyecto, podemos ejecutar el siguiente comando:

    V:\proyectos\u2ejemplos> cd ejemplo1
    V:\proyectos\u2ejemplos\ejemplo1> dotnet run

   No hay confusión posible ya que solo hay un proyecto en la carpeta. Pero si hubiera más de un proyecto, nos daría un error y nos indicaría que deberíamos indicar el proyecto a ejecutar.

2. En la carpeta del archivo de la solución, indicamos que proyecto queremos ejecutar dentro de la solución. Ejecutaremos el siguiente comando:

    V:\proyectos\u2ejemplos> dotnet run ejemplo1.slnx --project ejemplo1

   Como antes, si hay una única solución en la carpeta, podemos omitir el nombre de la solución y ejecutar el siguiente comando:

    V:\proyectos\u2ejemplos> dotnet run --project ejemplo1

Estructura de carpetas y ficheros

4. El fichero ejemplo1.csproj es el fichero de definición del proyecto que hemos creado y que contiene la información necesaria para compilarlo y ejecutarlo.
5. El fichero Program.cs es el fichero de código fuente que contiene la clase Program y el método Main() que es el punto de entrada del programa.
6. Las carpetas [bin] y [obj] son carpetas de salida que se crean automáticamente al compilar el proyecto. En la carpeta [bin] se genera el ejecutable del proyecto y en la carpeta [obj] se generan ficheros intermedios necesarios para la compilación.

Creando una solución desde VS Code

Solución simple desde un proyecto de consola

Lo más simple para abrir una solución con un único proyecto creado desde la consola como hicimos en el ejemplo anterior, sería abrir o arrastrar a VSCode la carpeta donde se encuentra el archivo con la solución. En nuestro caso V:\proyectos\u2ejemplos. Automáticamente nos abrirá el la solución ejemplo1.slnx.

Solución con varios proyectos desde consola

Veamos cómo sería el proceso, paso a paso:

1. Crearemos una carpeta o workspace con el nombre de la solución y que contendrá todos los proyectos. Por ejemplo, vamos a crear una solución que contenga varios ejercicios y por tanto crearemos la carpeta V:\proyectos\u2ejemplos\ejercicios

2. Dentro de la carpeta creamos la solución.

    V:\...\ejercicios> dotnet new sln -n ejercicios

3. Creamos por ejemplo dos proyectos de consola pertenecientes al ejercicio 1 y 2 respectivamente.

    V:\...\ejercicios> dotnet new console -n ej1
    V:\...\ejercicios> dotnet new console -n ej2

4. Asociamos los proyectos a la solución y como solo hay una en el wrokspace, no es necesario indicar el nombre de la solución.

    V:\...\ejercicios> dotnet sln add ej1\ej1.csproj
    V:\...\ejercicios> dotnet sln add ej2\ej2.csproj

5. Por último y de forma opcional, podemos crear un fichero .gitignore por si acaso decidiéramos subir la solución a un repositorio de Git en el futuro. Esto nos permitirá ignorar ficheros y carpetas que no queremos subir al repositorio.

    V:\...\ejercicios> dotnet new gitignore

Si abrimos la carpeta V:\proyectos\u2ejemplos\ejercicios que contiene la solución desde VSCode. Detectará automáticamente la solución ejercicios.slnx y nos mostrará en el explorador de soluciones los dos proyectos que contiene.

C:\ejemplo> dotnet --info
...
.NET SDKs installed:
  8.0.301 [C:\Program Files\dotnet\sdk]
  10.0.302 [C:\Program Files\dotnet\sdk]
...

C:\ejemplo> dotnet new console -f "net8.0" -n ejemplo

{
    "sdk": {
        "version": "8.0.301"
    }
}

C:\ejemplo> dotnet new console -f "net8.0" -n ejemplo
C:\ejemplo> dotnet new globaljson