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: Uso del módulo de compilació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: Bootstrap 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 esté listo para su lanzamiento.
• Preparado para la nube: si lo desea, utilice AEM as a Cloud Service para empezar a utilizarlo 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 cómo se reflejan 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 burlarse de AEM páginas y crear bibliotecas de cliente con Webpack, TypeScript y SASS.
• Preparado para la aplicación web: para sitios que utilizan el Angular de Reactor, utilice el SPA SDK para mantener la creación en contexto de la aplicación.
• Comercio habilitado: para proyectos que desean integrar AEM comercio con soluciones de comercio como Magentousing the Commerce Core Components.
• 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 las mejoras!

Uso

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

mvn -B archetype:generate \
 -D archetypeGroupId=com.adobe.aem \
 -D archetypeArtifactId=aem-project-archetype \
 -D archetypeVersion=26 \
 -D appTitle="My Site" \
 -D appId="mysite" \
 -D groupId="com.mysite" \

• Configure aemVersion=cloud para AEM como Cloud Service;
  Configure aemVersion=6.5.0 para Adobe Managed Services o local.
  La dependencia de componentes principales solo se agrega para versiones de aem que no sean de nube, ya que los componentes principales se proporcionan como OOTB para AEM como 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

| appTitle | | El título de la aplicación se utilizará para el título del sitio web y los grupos de componentes (p. ej. "My Site"). |
| appId | | Nombre técnico, se utilizará para nombres de componentes, configuración y carpetas de contenido, así como nombres de bibliotecas de cliente (p. ej. "mysite"). |
| artifactId | ${appId} | ID del artefacto de Maven base (p. ej. "mysite"). |
| groupId | | ID del grupo Maven base (p. ej. "com.mysite"). |
| package | ${groupId} | Paquete de fuentes Java (p. ej. "com.mysite"). |
| version | 1.0-SNAPSHOT | Versión del proyecto (p. ej. 1.0-SNAPSHOT). |
| aemVersion | cloud | Versión de AEM de destino (puede ser cloud para AEM como Cloud Service; o 6.5.0 o 6.4.4 para Adobe Managed Services o local). |
| sdkVersion | latest | Cuando aemVersion=cloud se puede especificar una versión de SDK (p. ej. 2020.02.2265.20200217T222518Z-200130). |
| includeDispatcherConfig | y | Incluye una configuración de Dispatcher para cloud o para AMS/on-premise, según el valor de aemVersion (puede ser y o n). |
| frontendModule | general | Incluye un módulo de compilación de front-end de Webpack que genera las bibliotecas de cliente (puede ser general o none para sitios normales; puede ser angular o react para una aplicación de una sola página que implementa el SPA Editor). |
| language | en | Código de idioma (ISO 639-1) desde el que se crea la estructura de contenido (p. ej. en, deu). |
| country | us | Código de país (ISO 3166-1) desde el que crear la estructura de contenido (p. ej. US). |
| singleCountry | y | Incluye una estructura de contenido maestra de idioma (puede ser y o n). |
| includeExamples | n | Incluye un sitio de ejemplo de Biblioteca de componentes (puede ser y o n). |
| includeErrorHandler | n | Incluye una página de respuesta 404 personalizada que será global para toda la instancia (puede ser y o n). |
| includeCommerce | n | Incluye dependencias Componentes principales del CIF y genera los artefactos correspondientes. |
| commerceEndpoint | | Necesario solo para CIF. Punto final opcional del servicio GraphQL del sistema de comercio que se va a utilizar (p. ej. https://hostname.com/grapql). |
| datalayer | y | Active la integración con Adobe Client Data Layer. |
| amp | n | Habilite la compatibilidad con AMP para plantillas de proyecto generadas. |

Requisitos del sistema

Configure su entorno de desarrollo local para AEM como SDK de Cloud Service 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).

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 Uso del tipo de archivo.