Saltar al contenido principal

Proyectos

Un proyecto agrupa todos los archivos de tu aplicación: código, imágenes y sprites. Esta guía te explica cómo crear, abrir y gestionar tus proyectos en JARU IDE.

Pantalla de inicio​

Al abrir JARU IDE verás la pantalla de inicio del asistente de proyectos.

Pantalla de inicio del asistente de proyectos de JARU IDE con proyectos recientes y ejemplos

Desde aquí puedes:

  • Abrir un proyecto reciente: En la lista de la izquierda aparecen los proyectos en los que has trabajado recientemente. Haz doble clic en uno para abrirlo.

  • Crear un proyecto desde un ejemplo: En la lista de la derecha encontrarás proyectos de ejemplo listos para usar. Al hacer doble clic, se creará una copia en tu carpeta de proyectos que podrás modificar libremente.

  • Crear un proyecto nuevo: Haz clic en el botón Nuevo Proyecto para empezar desde cero.

  • Abrir otro proyecto: Haz clic en el botón Cargar Proyecto para buscar un proyecto en cualquier ubicación de tu ordenador.

Crear un proyecto nuevo​

Cuando hagas clic en Nuevo Proyecto, verás el formulario de configuración.

Formulario de nuevo proyecto en JARU IDE con nombre, directorio, autor, versión y opciones de README

Información del proyecto​

Rellena los siguientes campos:

  • Nombre del proyecto: Elige un nombre que identifique tu proyecto. El nombre debe empezar por una letra y no puede contener espacios ni caracteres especiales.

  • Directorio: La carpeta donde se guardará el proyecto. Por defecto se usa Documentos\Projects, pero puedes cambiarla con el botón de explorar.

  • Autor: Tu nombre. Se incluirá en los comentarios del código.

  • Versión: La versión inicial de tu proyecto (por defecto 1.0.0).

  • Descripción: Una breve descripción de lo que hace tu proyecto (opcional).

Opciones adicionales​

Puedes activar estas opciones según tus necesidades:

  • Crear README.md: Añade un archivo de documentación con información básica del proyecto.

  • Crear LICENSE: Incluye un archivo de licencia. Al activarlo podrás elegir el tipo de licencia (MIT, Apache, GPL, etc.).

  • Inicializar repositorio Git: Crea un repositorio Git para controlar las versiones de tu código. Requiere tener Git instalado en tu sistema.

Finalizar​

Cuando todo esté listo, haz clic en Finalizar. El IDE creará el proyecto y lo abrirá automáticamente.

Estructura de un proyecto​

En el explorador de proyectos​

El explorador muestra tres carpetas donde organizarás tu trabajo:

Explorador de proyectos vacío de JARU IDE con carpetas Code, Images y Sprites

  • Code: Tus archivos de código (.aru). El archivo principal se crea automáticamente con el nombre del proyecto.

  • Images: Las imágenes que usará tu aplicación (PNG, JPG, etc.).

  • Sprites: Las definiciones de sprites (.spr), que combinan imágenes con información de regiones y animación.

En el disco​

Al crear un proyecto, JARU IDE genera la siguiente estructura de carpetas y archivos:

mi-proyecto/
├── Code/
│   └── mi-proyecto.aru    ← Archivo principal
├── Images/
├── Sprites/
├── Resources/
├── Config/
├── Build/
├── mi-proyecto.jpr        ← Archivo de proyecto
├── README.md              ← (opcional)
├── LICENSE                ← (opcional)
└── .gitignore             ← (opcional)

Las carpetas Resources, Config y Build son de uso interno del IDE y no aparecen en el explorador de proyectos. La carpeta Build es donde se generan los archivos compilados cuando ejecutas tu programa.

El explorador de proyectos​

El panel izquierdo del IDE muestra todos los archivos de tu proyecto organizados en carpetas.

Explorador de proyectos de JARU IDE con árbol de carpetas, código, imágenes y sprites

Abrir un archivo​

Haz doble clic en cualquier archivo para abrirlo. El IDE abrirá el editor adecuado según el tipo de archivo:

  • Los archivos de código (.aru) se abren en el editor de código
  • Las imágenes se abren en el editor de imágenes
  • Los sprites (.spr) se abren en el editor de sprites

Crear archivos y carpetas​

Haz clic derecho en una carpeta para ver el menú con las opciones disponibles:

Menú contextual​

Haz clic derecho en el explorador para ver el menú de opciones:

Menú contextual del explorador de proyectos de JARU IDE para crear archivos, imágenes, sprites y carpetas

Crear nuevos elementos

  • New Source: Crea un nuevo archivo de código (.aru)
  • New Image: Importa una imagen al proyecto
  • New Sprite: Crea un nuevo archivo de sprite (.spr)
  • New Folder: Crea una subcarpeta

Otras opciones

  • Open in Explorer: Abre la ubicación del elemento en el explorador de Windows
  • Rename File: Cambia el nombre del archivo (no disponible para carpetas)
  • Delete File: Elimina el elemento seleccionado
Nota

Las opciones de renombrar y eliminar solo están disponibles cuando hay un elemento seleccionado. Renombrar solo funciona con archivos, no con carpetas.

Mover archivos​

Puedes arrastrar archivos de una carpeta a otra para reorganizar tu proyecto.

Nota

Si la carpeta de destino ya tiene un archivo con el mismo nombre, el IDE mostrará un error y no permitirá moverlo.

El archivo principal​

Todo proyecto tiene un archivo principal que es el punto de entrada de tu programa. Cuando ejecutas el proyecto, la ejecución comienza por este archivo.

Por defecto, el archivo principal se llama igual que tu proyecto y está en la carpeta Code. Por ejemplo, si tu proyecto se llama "MiJuego", el archivo principal será Code/MiJuego.aru.

// MiJuego
// Created: 2025-01-15
// Author: Tu nombre
// Version: 1.0.0

println('Hello World from MiJuego')

Desde el archivo principal puedes importar otros archivos usando import:

import "config.aru"
import "jugador.aru"
import "enemigos.aru"

// Tu código principal aquí

Guardar el proyecto​

El proyecto se guarda automáticamente cuando realizas cambios en la estructura (crear, renombrar o eliminar archivos). Los cambios en el contenido de los archivos se guardan cuando pulsas Ctrl+S o al cerrar el archivo.

Consejo

Si activaste Git al crear el proyecto, recuerda hacer commits regularmente para no perder tu trabajo.