aem core cif components
CI
El proyecto AEM CIF Core Components sirve como acelerador para comenzar con proyectos utilizando AEM, CIF y Adobe Commerce. El proyecto contiene componentes centrales de comercio reutilizables que combinan componentes AEM renderizados del lado del servidor con componentes de comercio React (MPA) del lado del cliente para experiencias / datos dinámicos.
Este proyecto está destinado a usarse junto con los componentes centrales de los sitios AEM. Los componentes centrales AEM CIF usan los componentes centrales de los sitios AEM como base cuando sea posible y extiéndolos.
Para comenzar un nuevo proyecto, eche un vistazo a nuestro proyecto Archetype. También eche un vistazo a nuestro proyecto de muestra de Venia que utiliza los componentes centrales WCM y CIF para ofrecer una impresionante experiencia frente a la tienda.
Consulte la documentación de contenido y comercio AEM para obtener instrucciones de uso y configuración de los componentes centrales AEM CIF e introducción al desarrollo de componentes AEM.
Los componentes que están en la vista previa técnica pueden cambiar de una manera compatible con versiones anteriores en cualquier momento. Esto incluye todos los ASEPECTS y, en particular, la estructura de contenido, API, marcado y estilo si corresponde. No use estos componentes en la producción.
La última versión de los componentes centrales AEM CIF requiere los requisitos mínimos de sistema mínimos a continuación:
| Componentes del núcleo CIF | AEM como servicio en la nube | AEM 6.5 | Complemento de comercio AEM | Adobe Commerce | Java |
|---|---|---|---|---|---|
| 2.15.0 | Continuo | 6.5.18 | V2022.08.02.00 | 2.4.2 EE | 11 |
Para obtener una lista de requisitos para versiones anteriores, consulte los requisitos del sistema histórico.
Para AEM como implementaciones de servicio en la nube, este proyecto requiere el complemento CIF aprovisionado en cada AEM como un entorno de servicio en la nube. El complemento CIF se instala automáticamente, no se necesita implementación adicional. El complemento CIF también está disponible para el desarrollo local con AEM SDK del portal de distribución de software.
Para las instalaciones AEM en las primeras, este proyecto requiere que el complemento AEM Commerce para AEM 6.5 mejore la experiencia de autorización aprovechando los recolectores de productos, la vista de los activos del producto y las consolas de productos proporcionadas por el paquete de conector. El complemento AEM Commerce para AEM 6.5 también está disponible en el portal de distribución de software. Debe instalarse por separado.
Este proyecto se basa en los componentes centrales de los sitios AEM. Por lo general, se instalan como parte de AEM. Si instala AEM sin la opción de contenido de muestra, debe implementarlos manualmente antes de usar los componentes del núcleo AEM CIF.
Comenzando con 2.3.2, Adobe Commerce admite solicitudes de GraphQL de caché y comenzando con la versión 0.2.1 Los componentes CIF Core lo usarán de forma predeterminada. Para que los componentes funcionen con Adobe Commerce 2.3.1, puede deshabilitar manualmente esta función en las siguientes ubicaciones:
mvn clean install en la carpeta raíz para instalar los artefactos en su repositorio maven local.all el proyecto y ejecute un mvn clean install content-package:install .Aquí hay un recorrido de video completo del proceso de configuración.
Si desea construir todos los módulos usted mismo y obtener todos los últimos (aún) cambios inéditos , simplemente cree e instale todos los módulos con el siguiente comando en la raíz del repositorio:
mvn clean install -PautoInstallAll
Esto instala todo de forma predeterminada a localhost:4502 sin ninguna ruta de contexto. También puede configurar la ubicación de instalación con las siguientes propiedades de Maven:
aem.host : el nombre de la instancia de AEMaem.port : el número de puerto de la instancia de AEMaem.contextPath : la ruta de contexto de su instancia de AEM (si no / ) Este proyecto se basa en el AEM 6.5.7 cq-quickstart Uberjar. Esto está disponible públicamente en https://repo.adobe.com
Para obtener más detalles sobre el Uberjar, diríjase a cómo construir proyectos AEM utilizando la página de documentación Apache Maven.
La versión lanzada de los componentes centrales AEM CIF está disponible en el repositorio central Maven. Para incluir el paquete AEM CIF Core Components en su propio proyecto Maven Build, puede agregar la dependencia
<dependency>
<groupId>com.adobe.commerce.cif</groupId>
<artifactId>core-cif-components-all</artifactId>
<type>zip</type>
<version>x.y.z</version>
</dependency>
y sección de subpqueas
<subPackage>
<groupId>com.adobe.commerce.cif</groupId>
<artifactId>core-cif-components-all</artifactId>
<filter>true</filter>
</subPackage>
al content-package-maven-plugin .
Para conectar los componentes centrales AEM CIF con su entorno de comercio de Adobe o una implementación de comercio de terceros, siga los pasos de configuración. Para una configuración múltiple / configuración del sitio, se necesitan pasos adicionales para vincular un sitio AEM a una configuración de Vista de almacenamiento de Adobe Commerce.
Para personalizar los componentes CIF Core, proporcionamos casos de uso y ejemplos en nuestra documentación en la personalización de los componentes del CIF Core.
El código JavaScript del lado del cliente de los componentes se cubre utilizando pruebas unitarias Mocha ejecutadas con Karma. Asegúrese de que para cada contribución, el nuevo código del lado del cliente esté cubierto por las pruebas y que todas las pruebas pasen.
cd ui.apps
npm install
npm testEl karma probará con Chrome y Firefox. Asegúrese de tener ambos navegadores instalados.
Puede encontrar las reglas de formato de código en el archivo eclipse-formatter.xml . El formato del código se verifica automáticamente para cada compilación. Para formatear automáticamente su código, ejecute:
mvn clean install -Pformat-code Para formatear JavaScript y CSS usamos Prettier. El formato se verifica automáticamente al ejecutar npm test en el proyecto ui.apps . Para formatear automáticamente su código, ejecute el siguiente comando en ui.apps :
npm run prettier:fix Las versiones de este proyecto se activan ejecutando manualmente mvn release:prepare release:clean en la rama master en la carpeta raíz de este repositorio. Una vez que elige la versión y las próximas versiones de instantáneas, esto confirma el cambio junto con una etiqueta Git de lanzamiento como, por ejemplo core-cif-components-reactor-xyz . Tenga en cuenta que las confirmaciones no se empujan automáticamente al repositorio GIT, por lo que tiene tiempo para verificar sus cambios y luego presionarlos manualmente. El empuje luego desencadena una construcción CircleCI dedicada que realiza el despliegue del artefacto etiquetado para Maven Central.
IMPORTANTE : Este proyecto se mueve las liberaciones de reactores, ¡ no active las liberaciones de los submódulos!
Nota: En caso de que sea necesario actualizar la versión de un paquete Java debido a los cambios de API y al versiones semánticas, se puede actualizar fácilmente la versión POM principal y todos los POM que hacen referencia a la versión POM principal ejecutando el siguiente comando en la carpeta del proyecto principal: mvn versions:set -DnewVersion=xyz-SNAPSHOT . Esto asegurará que todos los proyectos tengan la misma versión.
¡Las contribuciones son bienvenidas! Lea la guía contribuyente para obtener más información.
Este proyecto tiene licencia bajo la licencia Apache V2. Vea la licencia para más información.
