Gestión de Proyectos

¿Qué es un proyecto?

Un proyecto en JARU IDE es una carpeta que contiene todos los archivos relacionados con tu aplicación: código fuente, recursos y configuración.

Crear un nuevo proyecto

1. Ve a Archivo > Nuevo Proyecto o Ctrl+Shift+N
2. Elige una plantilla:
   • Proyecto vacío - Solo la estructura básica
   • Hola Mundo - Ejemplo básico
   • ESP32 LED - Ejemplo con GPIO
   • Sensor IoT - Ejemplo completo con WiFi y MQTT
3. Introduce el nombre del proyecto
4. Selecciona la ubicación
5. Haz clic en "Crear"

Estructura de un proyecto

mi-proyecto/
├── src/
│   └── main.aru          # Archivo principal
├── lib/                   # Bibliotecas adicionales
├── data/                  # Archivos de datos
└── proyecto.jaruproj      # Configuración del proyecto

Abrir un proyecto existente

• Archivo > Abrir Proyecto o Ctrl+Shift+O
• Selecciona la carpeta del proyecto o el archivo .jaruproj

Explorador de proyectos

El panel lateral izquierdo muestra el árbol de archivos:

• Doble clic en un archivo para abrirlo
• Clic derecho para ver opciones:
  • Nuevo archivo
  • Nueva carpeta
  • Renombrar
  • Eliminar
  • Abrir en explorador

Archivo principal

El archivo main.aru es el punto de entrada de tu programa. La ejecución comienza aquí.

// main.aru
print("¡Mi proyecto JARU!")

// Importar otros archivos
use "utils.aru"
use "sensores.aru"

Múltiples archivos

Para proyectos grandes, organiza tu código en varios archivos:

src/
├── main.aru
├── config.aru
├── sensores.aru
└── comunicacion.aru

Importar archivos

Usa use para importar otros archivos:

// En main.aru
use "config.aru"
use "sensores.aru"

Configuración del proyecto

El archivo proyecto.jaruproj contiene la configuración:

{
  "nombre": "mi-proyecto",
  "version": "1.0.0",
  "main": "src/main.aru",
  "target": "esp32",
  "autor": "Tu nombre"
}

Opciones de configuración

Opción	Descripción
nombre	Nombre del proyecto
version	Versión del proyecto
main	Archivo de entrada
target	Plataforma destino (windows, esp32, riscv)
autor	Autor del proyecto

Ejecutar el proyecto

• Presiona F5 para ejecutar
• O usa el botón ▶️ en la barra de herramientas

El proyecto se ejecutará en la VM de Windows para desarrollo.

Despliegue a ESP32

Para desplegar tu proyecto a un ESP32:

1. Conecta tu ESP32 por USB
2. Ve a Proyecto > Desplegar o Ctrl+D
3. Selecciona el puerto COM
4. Haz clic en "Desplegar"

JARU Tools

Para configuración avanzada del ESP32, usa JARU Tools.

Plantillas de proyecto

Proyecto vacío

Estructura mínima para empezar desde cero.

Hola Mundo

// main.aru
println("¡Hola Mundo desde JARU!")

ESP32 LED

// main.aru
use GPIO

var led = GPIO.pin(2, GPIO.OUTPUT)

while true
    led.write(GPIO.HIGH)
    pause(500)
    led.write(GPIO.LOW)
    pause(500)
end

Sensor IoT

Proyecto completo con:

• Conexión WiFi
• Lectura de sensores
• Envío de datos por MQTT

Buenas prácticas

Organización

• Usa nombres descriptivos para archivos y carpetas
• Separa la lógica en módulos (sensores, comunicación, UI)
• Mantén main.aru simple, delegando a otros archivos
• Comenta tu código

Control de versiones

Si usas Git, añade a .gitignore:

*.jaruproj.user
build/
.jaru-cache/