Con el entorno configurado en PPAC, el siguiente paso es preparar tu máquina de desarrollo. Aquí vamos a instalar Node.js, Git y VS Code, y configurar las extensiones que más van a facilitar tu trabajo día a día con Code Apps.
Objetivos de aprendizaje
- Instalar Node.js LTS y verificar la instalación correctamente
- Instalar Git y configurar lo básico
- Configurar VS Code con las extensiones esenciales para Code Apps
- Entender qué hace cada extensión y por qué la necesitas
Node.js: la base de todo
Node.js es el runtime de JavaScript que necesita el toolchain de Code Apps para funcionar. Cuando instalas dependencias con npm, cuando ejecutas el servidor de desarrollo local, cuando haces build del proyecto... todo eso pasa a través de Node.js.
La regla es simple: siempre instala la versión LTS (Long Term Support) de Node.js, no la versión "current". La versión LTS es más estable y recibe soporte durante más tiempo. Puedes descargarla desde nodejs.org.
Para verificar que la instalación es correcta, abre una terminal y ejecuta:
node --version
npm --version
Ambos comandos deben devolver un número de versión. Si obtienes un error de "comando no encontrado", cierra y vuelve a abrir la terminal (o incluso reinicia el sistema) para que el PATH se actualice correctamente.
nvm: gestión de múltiples versiones (opcional pero recomendado)
Si trabajas en varios proyectos que requieren versiones diferentes de Node.js, considera instalar nvm (Node Version Manager) en lugar de instalar Node.js directamente. Con nvm puedes tener varias versiones instaladas y cambiar entre ellas fácilmente:
# Instalar una versión específica
nvm install 20.18.0
# Usar una versión específica
nvm use 20.18.0
# Establecer la versión por defecto
nvm alias default 20.18.0
Git: control de versiones
Git es imprescindible para cualquier proyecto profesional. Puedes descargarlo desde git-scm.com. Una vez instalado, configura tu identidad:
git config --global user.name "Tu Nombre"
git config --global user.email "tu@email.com"
VS Code y las extensiones esenciales
Visual Studio Code es el IDE de referencia para Code Apps. Descárgalo desde code.visualstudio.com.
Una vez instalado, estas son las extensiones que recomiendo instalar:
Power Platform Tools (imprescindible)
Esta extensión instala el PAC CLI directamente en el terminal integrado de VS Code. Además, proporciona una vista de los entornos de Power Platform, permite gestionar soluciones directamente desde VS Code, y ofrece contexto específico para trabajar con proyectos de Power Platform.
Búscala como: Power Platform Tools (publisher: Microsoft)
ESLint
Linter de JavaScript/TypeScript que detecta errores de código en tiempo real. El proyecto de Code Apps viene con una configuración de ESLint preconfigurada. Esta extensión muestra los errores directamente en el editor mientras escribes.
Prettier - Code Formatter
Formateador automático de código. Mantiene el código consistente en todo el equipo. Configúralo como el formateador por defecto y activa el formateo al guardar.
TypeScript (ya incluida, pero actualízala)
VS Code incluye TypeScript, pero puede que no sea la última versión. En proyectos de Code Apps, usa la versión de TypeScript del proyecto (la que está en node_modules) en lugar de la incluida en VS Code. Esto evita inconsistencias.
Git Graph o GitLens
Para visualizar el historial de Git directamente en VS Code. Muy útil cuando trabajas en equipo y necesitas ver quién cambió qué y cuándo.
.vscode/extensions.json en tu proyecto con la lista de extensiones recomendadas. Cuando otro miembro del equipo abra el proyecto, VS Code le sugerirá automáticamente instalarlas.
Puntos clave
- Instala siempre la versión LTS de Node.js, nunca la versión "current"
- Considera nvm si trabajas con múltiples proyectos que requieren versiones distintas de Node.js
- La extensión "Power Platform Tools" de VS Code instala el PAC CLI automáticamente
- ESLint y Prettier son esenciales para mantener calidad de código en equipos