Entwicklung in AEM Commerce

Die Entwicklung von AEM Commerce-Projekten auf der Grundlage des Commerce Integration Framework (CIF) für AEM folgt denselben Regeln und Best Practices wie andere AEM Projekte. Sehen Sie sich zuerst die folgenden Artikel an:

• AEM 6.5-Entwickleranleitung
• Grundlegende AEM-Konzepte
• AEM-Entwicklung – Richtlinien und Best Practices
• Erstellen von AEM-Projekten mit Apache Maven

Lokale Entwicklung für AEM Commerce

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

Das AEM Commerce-Add-on für AEM 6.5 alias. Das CIF-Add-on steht auch für die lokale Entwicklung zur Verfügung und wird als AEM-Paket bereitgestellt. Sie können es über Software Distribution als Feature Pack herunterladen.

Erforderliche Software

Folgendes sollte lokal installiert werden:

• Lokales AEM 6.5
• AEM 6.5 Service Pack 7 oder höher
• Java 11
• Apache Maven (3.3.9 oder höher)
• Node LTS
• npm 6+
• Git

Zugriff auf das CIF-Add-on

Das CIF-Add-on kann über Software Distribution heruntergeladen werden. Suchen Sie nach „AEM Commerce-Add-on“.

Lokales Setup

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

1. Laden Sie AEM Version 6.5 herunter und installieren Sie das AEM 6.5 Service Pack. Das AEM 6.5 Service Pack 7 ist erforderlich. Wir empfehlen jedoch, das letzte verfügbare Service Pack zu installieren.

2. Entpacken Sie die AEM.jar, um den crx-quickstart-Ordner zu erstellen, und führen Sie Folgendes aus:

   java -jar <jar name> -unpack
   

3. Erstellen Sie einen crx-quickstart/install-Ordner.

4. Kopieren Sie das von Software Distribution heruntergeladene CIF-Add-on für alle Pakete in den Ordner crx-quickstart/install.

1. Starten Sie den AEM-Schnellstart

Ü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 Bundles gestartet sind.

Projekt-Setup

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

CIF-Kernkomponenten können in jedem Projekt verwendet werden, indem entweder das bereitgestellte all-Paket oder sie einzeln mithilfe des CIF-Inhaltspakets und den zugehörigen OSGi-Paketen hinzugefügt werden. Verwenden Sie die folgenden Abhängigkeiten, um einem Projekt manuell CIF-Kernkomponenten hinzuzufügen:

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

Verwenden des AEM Venia Reference Store

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.

Um mit dem Venia Referenz-Store zu beginnen, klonen Sie einfach das Git-Repository und passen Sie das Projekt an Ihre Bedürfnisse an.

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 mit dem AEM Venia-Referenz-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 und direkt über den Browser eine Verbindung zum Commerce-GraphQL-Endpunkt her. Client-seitige CIF-Kernkomponenten und CIF-Add-On-Authoring-Tools stellen standardmäßig eine Verbindung zu /api/graphql her. Bei Bedarf kann dies über die CIF-Cloud Service-Konfiguration angepasst werden (siehe unten).

Das CIF-Add-on stellt ein GraphQL-Proxy-Servlet unter /api/graphql bereit. Wenn Sie nicht planen, einen lokalen AEM Dispatcher 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

• AEM-Projektarchetyp
• AEM Venia Reference Store

Ressourcen für Business.Adobe.com