Desarrollo de AEM Commerce develop
El desarrollo de proyectos de AEM Commerce basados en Commerce integration framework (CIF) para AEM sigue las mismas reglas y prácticas recomendadas que en otros proyectos de AEM. Revise primero lo siguiente:
Desarrollo local para AEM Commerce local
Se recomienda un entorno de desarrollo local para trabajar con proyectos de CIF.
El complemento AEM Commerce para AEM, conocido como complemento CIF, también está disponible para el desarrollo local y se proporciona como paquete AEM. Se puede descargar del Portal de distribución de software como paquete de funciones.
Software necesario
Lo siguiente debe instalarse de manera local:
- AEM local 6.5 LTS
- Java 17/Java 21
- Apache Maven (3.3.9 o posterior)
- Nodo LTS
- npm 6+
- Git
Acceso al complemento de CIF
El complemento de CIF se puede descargar del Portal de distribución de software, busque AEM Commerce add-on.
Configuración local
Para el desarrollo de proyectos locales de CIF mediante AEM y el complemento CIF, haga lo siguiente:
-
Desempaquete el archivo .jar de AEM para crear la carpeta
crx-quickstart, ejecute:code language-bash java -jar <jar name> -unpack -
Cree una carpeta
crx-quickstart/install. -
Copie todo el paquete del complemento de CIF, descargado del Portal de distribución de software, en la carpeta
crx-quickstart/install.
- Inicio rápido de AEM
Compruebe la configuración a través de la consola OSGI: http://localhost:4502/system/console/osgi-installer. La lista debe incluir los paquetes relacionados con el complemento de CIF, el paquete de contenido y las configuraciones de OSGI. Asegúrese de que todos los paquetes estén iniciados.
Configuración del proyecto project
Existen dos maneras de iniciar el proyecto de AEM Commerce con CIF.
Uso del tipo de archivo del proyecto AEM
El tipo de archivo del proyecto AEM es la herramienta principal para Bootstrap en un proyecto preconfigurado para comenzar con CIF. Los componentes principales de CIF y todas las configuraciones requeridas se pueden incluir en un proyecto generado con una opción adicional.
Consulte las instrucciones de uso del tipo de archivo del proyecto AEM para saber cómo generar un proyecto AEM. Para incluir CIF en el proyecto, use la opción includeCommerce.
Por ejemplo:
mvn -B archetype:generate \
-D archetypeGroupId=com.adobe.granite.archetypes \
-D archetypeArtifactId=aem-project-archetype \
-D aemVersion=6.5.5 \
-D appTitle="My Site" \
-D appId="mysite" \
-D groupId="com.mysite" \
-D frontendModule=general \
-D includeExamples=n \
-D includeCommerce=y
Puede utilizar los componentes principales de CIF en cualquier proyecto. Solo tiene que incluir el paquete all proporcionado o usar el paquete de contenido de CIF y los paquetes OSGi relacionados individualmente. Agregue los componentes principales de CIF a un proyecto manualmente mediante las siguientes dependencias:
<dependency>
<groupId>com.adobe.commerce.cif</groupId>
<artifactId>core-cif-components-apps</artifactId>
<type>zip</type>
<version>x.y.z</version>
</dependency>
<dependency>
<groupId>com.adobe.commerce.cif</groupId>
<artifactId>core-cif-components-config</artifactId>
<type>zip</type>
<version>x.y.z</version>
</dependency>
<dependency>
<groupId>com.adobe.commerce.cif</groupId>
<artifactId>core-cif-components-core</artifactId>
<version>x.y.z</version>
</dependency>
<dependency>
<groupId>com.adobe.commerce.cif</groupId>
<artifactId>graphql-client</artifactId>
<version>x.y.z</version>
</dependency>
<dependency>
<groupId>com.adobe.commerce.cif</groupId>
<artifactId>magento-graphql</artifactId>
<version>x.y.z</version>
</dependency>
Tienda de referencia Venia en AEM
Una segunda opción para el inicio de un proyecto CIF es clonar y utilizar la Tienda de referencia de Venia de AEM. AEM Venia Reference Store es una aplicación de escaparate de referencia que muestra el uso de los componentes principales del CIF de AEM. Está diseñada como un conjunto de ejemplos de prácticas recomendadas y un punto de partida potencial para desarrollar su propia funcionalidad.
Empiece con la Tienda de referencia de Venia clonando el repositorio Git y empiece a personalizar el proyecto según sus necesidades.
classic.Conexión de AEM al sistema de Commerce
Para conectar el proyecto al sistema de comercio, AEM debe configurarse con el punto final GraphQL del sistema de comercio.
Ambos, un proyecto generado por el Arquetipo de proyecto de AEM o la Tienda de referencia de Venia en AEM, ya incluyen una configuración predeterminada que debe ajustarse.
Reemplace el valor de url en com.adobe.cq.commerce.graphql.client.impl.GraphqlClientImpl~default.cfg.json con el extremo GraphQL de su sistema comercial utilizado por el proyecto.
El complemento de AEM Commerce y los componentes principales de CIF se conectan al extremo de Commerce GraphQL a través del servidor de AEM. O bien, directamente desde el explorador. Los componentes principales de CIF del lado del cliente y las herramientas de creación de complementos de CIF se conectan de forma predeterminada a /api/graphql. Si es necesario, puede ajustarlo mediante la configuración de CIF Cloud Service (consulte a continuación).
El complemento de CIF proporciona un servlet proxy de GraphQL en /api/graphql. Si no planea utilizar un Dispatcher de AEM local, se recomienda configurar también el servlet proxy de GraphQL.
Vaya a http://localhost:4502/system/console/configMgr y cree una configuración OSGI para el servicio Adobe CIF GraphQL Proxy Configuration. Utilice el mismo punto final de GraphQL de su sistema comercial que se utilizó para el cliente de GraphQL anterior.