Primeros pasos
Comience aquí si quiere el camino más rápido desde cero hasta una aplicación AWE en ejecución. Esta guía muestra el camino principal y después le dirige a documentación de referencia más detallada.
Ruta rápida
- Instale Java 21+ y Maven 3.x.
- Elija el arquetipo de AngularJS o de React.
- Genere su proyecto con Maven.
- Ejecute la aplicación con Spring Boot.
- Confirme que la aplicación generada arranca en
http://localhost:18080.
Requisitos previos
- JDK 21 o superior
- Maven 3.x o superior
- Su IDE o editor preferido
Elija su arquetipo
React es el cliente moderno de AWE 5 y el recomendado para los proyectos nuevos. El cliente AngularJS sigue soportado en modo compatibilidad durante toda la línea 5.x, así que los proyectos AngularJS existentes lo mantienen al actualizar. Vea ADR 001: React es el cliente moderno de AWE 5.
| Opción | Arquetipo | Úselo cuando |
|---|---|---|
| React (recomendado) | awe-boot-react-archetype | Empieza un proyecto nuevo |
| AngularJS | awe-boot-angular-archetype | Mantiene la pila clásica de AWE con AngularJS, por ejemplo para coincidir con un proyecto existente |
Utilice la versión actual de AWE de Maven Central: 
Genere su proyecto
Proyecto AngularJS
mvn -B archetype:generate \
-DarchetypeGroupId=com.almis.awe \
-DarchetypeArtifactId=awe-boot-angular-archetype \
-DarchetypeVersion=[Archetype version] \
-DgroupId=com.mycompany.app \
-DartifactId=my-app \
-Dversion=1.0-SNAPSHOT
Proyecto React
mvn -B archetype:generate \
-DarchetypeGroupId=com.almis.awe \
-DarchetypeArtifactId=awe-boot-react-archetype \
-DarchetypeVersion=[Archetype version] \
-DgroupId=com.mycompany.app \
-DartifactId=my-app \
-Dversion=1.0-SNAPSHOT
Ejecute la aplicación generada
Desde el directorio del proyecto generado:
mvn spring-boot:run
Qué esperar
- El arquetipo crea una aplicación AWE basada en Maven.
- La aplicación generada está configurada para ejecutarse en el puerto
18080. - La configuración por defecto incluye la estructura estándar de una aplicación AWE en
src/main/resources/application/<your-acronym>/. - La configuración generada incluye un datasource HSQLDB embebido para que pueda empezar en local sin tener que conectar antes una base de datos externa.
Abra http://localhost:18080 tras el arranque y confirme que la aplicación carga sin errores.
Siguiente paso tras la primera ejecución
Continúe con awe-101 Su primera aplicación AWE para el primer tutorial práctico. Retoma esta guía rápida y le muestra cómo:
- entender las carpetas generadas de AWE,
- localizar pantallas y menús,
- y realizar una pequeña personalización visible.
Dónde continuar
Utilice estos documentos como referencia tras la primera ejecución:
- Estructura del proyecto para la disposición XML y las carpetas de AWE
- Herramientas XSD para el autocompletado y la validación de XML en IntelliJ IDEA y VS Code
- Contenedor de desarrollo para compilar y probar AWE desde VS Code sin instalar un conjunto de herramientas
- awe-101 Su primera aplicación AWE para el primer tutorial práctico tras la guía rápida
- Instalación para los detalles de configuración del servidor y del entorno
- Despliegue para las opciones de empaquetado en JAR, WAR, Docker y nube