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
Utilice el frontend que corresponda a su proyecto.
| Opción | Arquetipo | Úselo cuando |
|---|---|---|
| AngularJS | awe-boot-angular-archetype | Quiere la pila clásica de AWE con AngularJS |
| React | awe-boot-react-archetype | Quiere el proyecto inicial de AWE con React |
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