Tipo de archivo del proyecto AEM

El Arquetipo de proyecto AEM es una plantilla Maven que crea un proyecto de Adobe Experience Manager (AEM) mínimo y basado en optimizaciones como punto de partida para su sitio web.

CONSEJO

El último arquetipo del proyecto de AEM se puede encontrar en GitHub.

Medios

  • Documentación de arquetipos (este documento): Visión general de la arquitectura de arquetipos y sus diferentes módulos.
  • Los siguientes tutoriales están basados en este arquetipo:

Características

  • Práctica recomendada: Bootstrap del sitio con todas las prácticas recomendadas más recientes de Adobe.
  • Código bajo: edite las plantillas, cree contenido, implemente su CSS y el sitio esté listo para su lanzamiento.
  • Preparado para la nube: si lo desea, utilice AEM como servicio de nube para activarse en pocos días y facilitar la escalabilidad y el mantenimiento.
  • Dispatcher: Un proyecto se completa únicamente con una configuración de Dispatcher que garantiza velocidad y seguridad.
  • Múltiples sitios: Si es necesario, el arquetipo 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: Monte prácticamente cualquier plantilla sin código y defina lo que los autores pueden editar.
  • Diseño adaptable: en plantillas o páginas individuales, defina el modo en que los elementos se redimensionan para los puntos de interrupción definidos.
  • Encabezado y pie de página: Monte y localícelos sin código, utilizando las funciones de localización de los componentes.
  • Sistema de estilos: evite crear componentes personalizados permitiendo a los autores aplicarles diferentes estilos.
  • Compilación front-end: los desarrolladores front-end pueden burlarse de las páginas y crear bibliotecas de cliente con Webpack, TypeScript y SASS.
  • Listo para WebApp: para sitios que utilizan Reactor Angular, utilice el SPA SDKpara conservar la creación en contexto de la aplicación.
  • Comercio habilitado: Para proyectos que deseen integrar AEM comercio con soluciones comerciales como Magentousing the Commerce Core Components.
  • Código de ejemplo: Cierre la compra del componente HelloWorld y de los modelos de muestra, servlets, filtros y Planificadoras.
  • Open Sourced: Si algo no es como debería, contribuya a sus mejoras.

Uso

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

mvn -B archetype:generate \
 -D archetypeGroupId=com.adobe.aem \
 -D archetypeArtifactId=aem-project-archetype \
 -D archetypeVersion=24 \
 -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 Servicios administrados de Adobe o in situ.
    La dependencia de Componentes principales solo se agrega para las versiones de Aem que no son de nube, ya que los Componentes principales se proporcionan 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 Maven artifactsId, los nombres de los componentes, la configuración y las carpetas de contenido, así como los nombres de las bibliotecas de clientes.
  • 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 desea ajustar.

Propiedades disponibles

Nombre Predeterminado Descripción
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 El nombre técnico se utilizará para los nombres de los componentes, la configuración y las carpetas de contenido, así como los nombres de las bibliotecas de cliente (p. ej. "mysite").
artifactId ${appId} ID de artefacto de la mueble base (p. ej. "mysite").
groupId ID de grupo de 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 Destinatario AEM versión (puede ser cloud para AEM como Cloud Service; o 6.5.0 o 6.4.4 para Servicios administrados de Adobe o in situ).
sdkVersion latest Cuando aemVersion=cloud se puede especificar una versión SDK (p. ej. 2020.02.2265.20200217T222518Z-200130).
includeDispatcherConfig y Incluye una configuración de distribuidor para cloud o para AMS/in situ, 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 bibliotecas de cliente (puede ser general o none para sitios regulares; puede ser angular o react para una aplicación de una sola página que implemente el Editor de SPA).
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 maestro-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 personalizada 404 que será global para toda la instancia (puede ser y o n).
includeCommerce n Incluye dependencias Componentes principales de CIF y genera artefactos correspondientes.
commerceEndpoint Necesario solo para CIF. Extremo 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 capa de datos del cliente de Adobe.
amp n Habilite la compatibilidad con AMP para plantillas de proyecto generadas.

Requisitos del sistema

Archetype AEM as a Cloud Service AEM 6.5 AEM 6.4 Java SE Maven
24 Continua 6.5.5.0+ 6.4.8.1+ 8, 11 3.3.9+

Configure el entorno de desarrollo local para AEM como un SDK de Cloud Service o para versiones anteriores de AEM.

Problemas conocidos

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

Cuando se ejecuta el arquetipo 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, lo que después repite las preguntas incluyendo las propiedades con valores predeterminados en las preguntas (consulte
ARCHETYPE-308 para obtener más información).

Lectura adicional

Para obtener más información sobre el uso del arquetipo, incluidos sus beneficios, opciones y cómo funcionan sus módulos, consulte el Uso del documento Archetype.

En esta página