Tipo de archivo del proyecto AEM

El tipo de archivo del proyecto de AEM es una plantilla de Maven que crea un proyecto mínimo de Adobe Experience Manager (AEM) basado en las prácticas recomendadas como punto de partida para su sitio web.

Medios

• Documentación de tipo de archivo (este documento): Información general sobre la arquitectura de tipo de archivo y sus distintos módulos.
  • Uso del tipo de archivo: Más información sobre el uso del tipo de archivo y los módulos disponibles
  • ui.frontend: Cómo usar el módulo de versión del front-end
• Los siguientes tutoriales están basados en este tipo de archivo:
  • Sitio WKND: Aprenda a iniciar un nuevo sitio web.
  • Aplicación de una sola página WKND: Aprenda a crear una aplicación web de React o Angular totalmente legible en AEM.

Características

• Práctica recomendada: inicie su sitio con todas las prácticas recomendadas más recientes de Adobe.
• Código bajo: edite sus plantillas, cree contenido, implemente su CSS y el sitio estará listo para su publicación.
• Preparado para la nube: si lo desea, utilice AEM as a Cloud Service para publicarlo en pocos días y facilitar la escalabilidad y el mantenimiento.
• Dispatcher: un proyecto se completa solamente con una configuración de Dispatcher que garantice la velocidad y la seguridad.
• Varios sitios: si es necesario, el tipo de archivo genera la estructura de contenido para una configuración de varios idiomas y regiones.
• Componentes principales: los autores pueden crear casi cualquier diseño con nuestro versátil conjunto de componentes estandarizados.
• Plantillas editables: combine prácticamente cualquier plantilla sin código y defina lo que los autores pueden editar.
• Diseño interactivo: en plantillas o páginas individuales, defina el reflujo de los elementos para los puntos de interrupción definidos.
• Encabezado y pie de página: reúna y localícelos sin código, utilizando las funciones de localización de los componentes.
• Sistema de estilos: evite crear componentes personalizados al permitir que los autores les apliquen estilos diferentes.
• Compilación front-end: los desarrolladores de front-end pueden burlar las páginas de AEM y crear bibliotecas de cliente con Webpack, TypeScript y SASS.
• Preparado para aplicaciones web: para sitios que utilizan el React o Angular, utilice el SPA SDK para mantener la autoría en el contexto de la aplicación.
• Comercio habilitado: para proyectos que desean integrar AEM Commerce con soluciones de comercio como Magento utilizando componentes principales de comercio.
• Código de ejemplo: cierre la compra del componente HelloWorld y de los modelos, servlets, filtros y programadores de ejemplo.
• Abrir fuente: si algo no funciona como debería, contribuya con sus mejoras.

Uso

Para generar un proyecto, ajuste la siguiente línea de comandos según sus necesidades:

mvn -B org.apache.maven.plugins:maven-archetype-plugin:3.2.1:generate \
 -D archetypeGroupId=com.adobe.aem \
 -D archetypeArtifactId=aem-project-archetype \
 -D archetypeVersion=XX \
 -D appTitle="My Site" \
 -D appId="mysite" \
 -D groupId="com.mysite" \

• Sustituya XX por el último número de versión del tipo de archivo.
• Configure aemVersion=cloud para AEM as a Cloud Service;
  Configure aemVersion=6.5.0 para Adobe Managed Services o en línea.
  La dependencia de componentes principales solo se agrega para versiones de AEM que no sean en la nube, ya que los componentes principales se proporcionan como OOTB para AEM as a Cloud Service.
• Ajuste appTitle="My Site" para definir el título del sitio web y los grupos de componentes.
• Ajuste appId="mysite" para definir los nombres de Maven artifactId, los componentes, la configuración y las carpetas de contenido, así como los nombres de las bibliotecas de cliente.
• Ajuste groupId="com.mysite" para definir el groupId de Maven y el paquete de origen de Java.
• Busque la lista de propiedades disponibles para ver si hay más que desee ajustar.

Propiedades disponibles

Requisitos del sistema

Configure su entorno de desarrollo local para AEM as a Cloud Service SDK o para versiones anteriores de AEM.

Problemas conocidos

Cuando se ejecuta en Windows y genera la configuración de Dispatcher, debe estar ejecutando un símbolo del sistema elevado o el Subsistema de Windows para Linux (consulte #329).

Al ejecutar el tipo de archivo en modo interactivo (sin el parámetro -B), las propiedades con valores predeterminados no se pueden cambiar, a menos que se descarte la confirmación final, que después repite las preguntas incluyendo las propiedades con valores predeterminados en las preguntas (consulte
ARCHETYPE-308 para más detalles).

No se puede usar este tipo de archivo en Eclipse al iniciar un nuevo proyecto con File -> New -> Maven Project, ya que el script de generación posterior archetype-post-generate.groovy no se ejecutará debido a un problema con Eclipse. La solución es usar la línea de comandos anterior y luego usar Eclipse File -> Import -> Existing Maven Project.

Lectura adicional

Para obtener más información sobre el uso del tipo de archivo, incluidas sus ventajas, opciones y cómo funcionan sus módulos, consulte el documento Utilizar el tipo de archivo.