Entwicklung für AEM Commerce develop

Für die Entwicklung von AEM Commerce-Projekten auf der Grundlage von Commerce integration framework (CIF) für AEM gelten dieselben Regeln und Best Practices wie für andere AEM-Projekte. Überprüfen Sie zunächst die folgenden Punkte:

Lokale Entwicklung für AEM Commerce local

Für die Arbeit mit CIF-Projekten wird eine lokale Entwicklungsumgebung empfohlen.

Das als CIF-Add-on bezeichnete AEM Commerce-Add-on für AEM ist auch für die lokale Entwicklung verfügbar und wird als AEM-Paket bereitgestellt. Sie können es über das Software Distribution-Portal als Feature Pack herunterladen.

Erforderliche Software

Folgendes sollte lokal installiert werden:

Zugriff auf das CIF-Add-on

Das CIF-Add-on kann über das Software Distribution-Portal heruntergeladen werden. Suchen Sie nach AEM Commerce add-on.

Lokales Setup

Gehen Sie für die lokale CIF-Projektentwicklung mit AEM und dem Add-on CIF wie folgt vor:

Überprüfen Sie das Setup über die OSGi-Konsole: http://localhost:4502/system/console/osgi-installer. Die Liste sollte die CIF-Add-on-bezogenen Bundles, Inhaltspakete und OSGi-Konfigurationen enthalten. Stellen Sie sicher, dass alle Pakete gestartet sind.

Projekt-Setup project

Es gibt zwei Möglichkeiten, Ihr AEM Commerce-Projekt unter Verwendung von CIF zu starten.

Verwenden des AEM-Projektarchetyps

Der AEM-Projektarchetyp ist das wichtigste Tool für das Bootstrapping eines vorkonfigurierten Projekts, um mit CIF zu beginnen. Die CIF-Kernkomponenten und alle erforderlichen Konfigurationen können mit einer zusätzlichen Option in ein generiertes Projekt aufgenommen werden.

Weitere Informationen zum Generieren eines AEM-Projekts finden Sie in den Anweisungen zur Verwendung des AEM-Projektarchetyps. Verwenden Sie die Option includeCommerce, um CIF in das Projekt aufzunehmen.

Beispiel:

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

Sie können CIF-Kernkomponenten in jedem Projekt verwenden. Schließen Sie einfach das bereitgestellte all ein oder verwenden Sie das CIF-Inhaltspaket und die zugehörigen OSGi-Bundles einzeln. Fügen Sie einem Projekt manuell CIF-Kernkomponenten hinzu, indem Sie die folgenden Abhängigkeiten verwenden:

<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>

AEM Venia-Referenzspeicher verwenden

Eine zweite Möglichkeit, ein CIF-Projekt zu starten, besteht darin, den AEM Venia Reference Store zu klonen und zu verwenden. Der AEM Venia Reference Store ist ein Beispiel-Referenz-Storefront-Programm, das die Verwendung von CIF-Kernkomponenten für AEM demonstriert. Sie ist sowohl als Satz von Best Practice-Beispielen als auch als möglicher Ausgangspunkt für die Entwicklung Ihrer eigenen Funktionalität gedacht.

Beginnen Sie mit dem Venia Reference Store, indem Sie das Git-Repository klonen und das Projekt an Ihre Anforderungen anpassen.

Verbinden von AEM mit dem Commerce-System

Um Ihr Projekt mit dem Commerce-System zu verbinden, muss AEM mit dem GraphQL-Endpunkt Ihres Commerce-Systems konfiguriert werden.

Sowohl ein vom AEM-Projektarchetyp als auch ein vom AEM Venia Reference Store erstelltes Projekt enthalten bereits eine Standardkonfiguration, die angepasst werden muss.

Ersetzen Sie den Wert der url in com.adobe.cq.commerce.graphql.client.impl.GraphqlClientImpl~default.cfg.json mit dem GraphQL-Endpunkt Ihres vom Projekt verwendeten Commerce-Systems.

Das AEM Commerce-Add-on und die CIF-Kernkomponenten stellen über den AEM-Server eine Verbindung zum Commerce GraphQL-Endpunkt her. Oder direkt über den Browser. Client-seitige CIF-Kernkomponenten und Authoring-Tools für CIF-Add-ons stellen standardmäßig eine Verbindung zu /api/graphql her. Bei Bedarf können Sie sie über die CIF Cloud Service-Konfiguration anpassen (siehe unten).

Das CIF-Add-on stellt ein GraphQL-Proxy-Servlet unter /api/graphql bereit. Wenn Sie nicht vorhaben, eine lokale AEM Dispatcher-Version zu verwenden, wird empfohlen, auch das GraphQL-Proxy-Servlet zu konfigurieren.

Navigieren Sie zu http://localhost:4502/system/console/configMgr und erstellen Sie eine OSGi-Konfiguration für den Adobe CIF GraphQL Proxy Configuration-Service. Verwenden Sie denselben GraphQL-Endpunkt Ihres Commerce-Systems wie für den GraphQL-Client oben.

Zusätzliche Ressourcen