Práctica UT02P03: Instalación y configuración de Visual Studio Code para Java

🎯 Objetivos

• Instalar Visual Studio Code en Xubuntu y en Windows 11.
• Usar el comando code desde la terminal y comprobar que está en el PATH.
• Añadir y eliminar extensiones, en particular el Extension Pack for Java.
• Indicar a VS Code qué JDK debe usar (el Temurin 21 de la práctica 02).
• Crear, ejecutar y depurar un proyecto Java.
• Personalizar el editor y configurar sus actualizaciones.

🧰 Requisitos

• Haber terminado la Práctica 02: Temurin 21 instalado y JAVA_HOME y PATH configurados en los dos sistemas.
• Usuario con permisos de administrador.
• Conexión a Internet.

1. Instalación en Xubuntu 24.04

Instalaremos VS Code desde el repositorio oficial de Microsoft. Así se actualizará junto con el resto del sistema cada vez que hagas sudo apt upgrade.

Crea primero la carpeta de la práctica:

mkdir -p ~/ut02p03 && cd ~/ut02p03

Paso 1: Actualizar el sistema e instalar las herramientas necesarias

sudo apt update && sudo apt upgrade -y
sudo apt install -y wget gpg apt-transport-https

Paso 2: Añadir la clave de Microsoft

wget -qO- https://packages.microsoft.com/keys/microsoft.asc | sudo gpg --dearmor -o /usr/share/keyrings/microsoft.gpg

Paso 3: Añadir el repositorio de VS Code

Crea el fichero /etc/apt/sources.list.d/vscode.sources con este contenido:

sudo tee /etc/apt/sources.list.d/vscode.sources > /dev/null <<'EOF'
Types: deb
URIs: https://packages.microsoft.com/repos/code
Suites: stable
Components: main
Architectures: amd64,arm64,armhf
Signed-By: /usr/share/keyrings/microsoft.gpg
EOF

Paso 4: Instalar VS Code

sudo apt update
sudo apt install -y code

Paso 5: Comprobar la instalación y el comando code

code --version
which code

Al instalar con apt, el ejecutable queda enlazado en /usr/bin/code, una carpeta que ya está en el PATH, así que el comando code funciona sin hacer nada más.

sudo apt install ./code_*.deb

2. Instalación en Windows 11

Paso 1: Descargar el instalador

Entra en code.visualstudio.com/download y descarga el User Installer de Windows x64. Se instala solo para tu usuario y no necesita permisos de administrador.

Paso 2: Ejecutar el instalador

En la pantalla Seleccione las tareas adicionales, marca estas opciones:

winget install Microsoft.VisualStudioCode

Paso 3: Comprobar la instalación y el comando code

Abre una nueva ventana de PowerShell (las variables de entorno se leen al abrir la terminal):

code --version
where.exe code

3. Primer arranque y uso del comando code

Paso 1: Abrir VS Code desde la terminal

El comando code abre VS Code directamente en una carpeta o fichero. En los dos sistemas, desde la carpeta de la práctica:

Ejecuta code . dentro de ut02p03. La primera vez, VS Code te preguntará si confías en los autores de la carpeta: responde que sí, porque es tu propia carpeta.

Paso 2: Poner VS Code en castellano

1. Pulsa Ctrl+Shift+P para abrir la paleta de comandos.
2. Escribe Configure Display Language y selecciona Español.
3. Si no aparece, VS Code te ofrecerá instalar el paquete de idioma Spanish Language Pack for Visual Studio Code. Instálalo y reinicia cuando te lo pida.

Paso 3: Elegir un tema

Abre la paleta de comandos y busca Preferencias: Tema de color. Elige el que prefieras; puedes cambiarlo cuando quieras.

4. Extensiones: añadir y eliminar módulos

Paso 1: Instalar el Extension Pack for Java

1. Pulsa el icono Extensiones de la barra de actividad (o Ctrl+Shift+X).
2. Busca Extension Pack for Java (publicado por Microsoft, identificador vscjava.vscode-java-pack).
3. Pulsa Instalar.

Este paquete instala de una vez varias extensiones:

Comprueba desde la terminal qué extensiones tienes instaladas:

code --list-extensions

Paso 2: Instalar y desinstalar una extensión desde la terminal

Instala la extensión Markdown All in One, que te será útil para escribir la documentación de las prácticas:

code --install-extension yzhang.markdown-all-in-one
code --list-extensions

Ahora desinstálala y vuelve a comprobarlo:

code --uninstall-extension yzhang.markdown-all-in-one
code --list-extensions

Vuelve a instalarla (desde la terminal o desde la vista Extensiones); la usarás en el entregable.

5. Indicar a VS Code qué JDK debe usar

La extensión de Java busca el JDK en JAVA_HOME y en el PATH. Si hiciste bien la práctica 02, ya encontrará Temurin 21. Aun así, vamos a comprobarlo y a fijarlo en la configuración.

Paso 1: Comprobar el JDK detectado

Abre la paleta de comandos y ejecuta Java: Configure Java Runtime. En la pestaña Project JDKs debe aparecer el JDK 21 de Temurin.

Paso 2: Fijar el JDK en la configuración de usuario

Abre la paleta de comandos y ejecuta Preferencias: Abrir configuración de usuario (JSON). Añade la configuración de tu sistema dentro de las llaves { } (si ya hay otras líneas, separa cada entrada con una coma).

En Xubuntu:

"java.configuration.runtimes": [
    {
        "name": "JavaSE-21",
        "path": "/usr/lib/jvm/temurin-21-jdk-amd64",
        "default": true
    }
]

En Windows (las barras \ se escriben dobles en JSON):

"java.configuration.runtimes": [
    {
        "name": "JavaSE-21",
        "path": "C:\\Program Files\\Eclipse Adoptium\\jdk-21.0.x.y-hotspot",
        "default": true
    }
]

6. Crear, ejecutar y depurar un proyecto Java

Paso 1: Crear el proyecto

1. Abre la paleta de comandos y ejecuta Java: Create Java Project…
2. Elige No build tools (sin Maven ni Gradle; los veremos en la UT03).
3. Selecciona como ubicación la carpeta ut02p03 y llama al proyecto hola-vscode.

VS Code crea esta estructura:

hola-vscode/
├── .vscode/settings.json   ← configuración del proyecto
├── bin/                    ← ficheros .class compilados
├── lib/                    ← librerías .jar externas
├── src/App.java            ← código fuente
└── README.md

Paso 2: Escribir el programa

Sustituye el contenido de src/App.java por este:

public class App {
    public static void main(String[] args) {
        String nombre = "tu nombre";   // Cambia por tu nombre
        int suma = 0;

        // Sumamos los números del 1 al 5 para poder seguir el bucle con el depurador
        for (int i = 1; i <= 5; i++) {
            suma = suma + i;
        }

        System.out.println("Hola, " + nombre + ", desde VS Code");
        System.out.println("La suma del 1 al 5 es " + suma);
        System.out.println("Versión de Java: " + System.getProperty("java.version"));
    }
}

Paso 3: Ejecutar

Pulsa Run (encima del método main) o el botón ▷ de la esquina superior derecha. La salida aparece en el terminal integrado.

Paso 4: Depurar

1. Haz clic a la izquierda del número de la línea suma = suma + i; para poner un punto de ruptura (aparece un círculo rojo).
2. Pulsa Debug encima del método main (o F5).
3. El programa se detiene en el punto de ruptura. En la vista Variables observa los valores de i y suma.
4. Avanza con Paso a paso por procedimiento (F10) hasta terminar el bucle.

7. Personalizar y automatizar el editor

Abre la configuración de usuario en JSON (como en el apartado 5) y añade estas opciones:

"editor.fontSize": 16,
"editor.formatOnSave": true,
"files.autoSave": "afterDelay",
"editor.minimap.enabled": false

Comprueba que funciona: desordena la sangría de App.java, guarda con Ctrl+S y observa cómo se corrige sola.

8. Configurar las actualizaciones

Abre Configuración (Ctrl+,) y busca update:

Deja extensions.autoUpdate activado y revisa el valor de update.mode en cada sistema.

📑 Entregables

Carpeta ut02p03 comprimida en un fichero llamado ut02p03_NRE.zip con:

• El proyecto hola-vscode completo (de uno de los dos sistemas).
• Un documento ut02p03.md, escrito en VS Code con Markdown All in One, con las siguientes capturas y una breve explicación de cada una:
  • Captura 1 (Xubuntu): salida de code --version y which code.
  • Captura 2 (Windows): salida de code --version y where.exe code.
  • Captura 3: salida de code --list-extensions antes y después de desinstalar Markdown All in One.
  • Captura 4: ventana Java: Configure Java Runtime mostrando Temurin 21.
  • Captura 5: ejecución de App.java en el terminal integrado (en los dos sistemas).
  • Captura 6: depurador detenido en el punto de ruptura, con la vista Variables visible.
  • Captura 7: tu settings.json de usuario.
  • Captura 8: valor de update.mode y extensions.autoUpdate en cada sistema.
• Un último apartado en ut02p03.md: «Diferencias entre la instalación en Xubuntu y en Windows» (instalación, PATH y actualizaciones).
• Foto de las páginas del cuaderno: esquema de la ventana de VS Code y traza del bucle.

✅ Criterios de corrección