Entwickeln von AEM Commerce für AEM as a Cloud Service develop
Die Entwicklung von AEM Commerce-Projekten basierend auf dem Commerce Integration Framework (CIF) für AEM as a Cloud Service folgt denselben Regeln und Best Practices wie andere AEM-Projekte für AEM as a Cloud Service. Überprüfen Sie zunächst die folgenden Punkte:
Lokale Entwicklung mit dem AEM as a Cloud Service-SDK local
Für die Arbeit mit CIF-Projekten wird eine lokale Entwicklungsumgebung empfohlen. Das für AEM as a Cloud Service bereitgestellte CIF-Add-on ist auch für die lokale Entwicklung verfügbar. Es kann vom Software Distribution-Portal heruntergeladen werden.
Das CIF-Add-on wird als Sling Feature-Archiv bereitgestellt. Die im Software Distribution-Portal verfügbare Zip-Datei enthält zwei Sling Feature-Archivdateien, eine für AEM-Autoren- und eine für AEM-Veröffentlichungsinstanzen.
Neu bei AEM as a Cloud Service? Sehen Sie sich eine detaillierte Anleitung zum Einrichten einer lokalen Entwicklungsumgebung mit dem AEM as a Cloud Service-SDK an.
Erforderliche Software
Folgendes sollte lokal installiert werden:
- AEM as a Cloud Service-SDK
- Java™ 11
- Apache Maven (3.3.9 oder höher)
- Node.js v10+
- npm 6+
- Git
Zugriff auf das CIF-Add-on
Das CIF-Add-on kann als ZIP-Datei vom Software Distribution-Portal heruntergeladen werden. Die ZIP-Datei enthält das CIF-Add-on als Sling Feature-Archiv. Es ist kein AEM-Paket. Auf SDK-Listen kann über eine AEM as a Cloud Service Lizenz zugegriffen werden.
Lokales Setup
Gehen Sie für die lokale CIF-Add-on-Entwicklung mit dem AEM as a Cloud Service-SDK wie folgt vor:
-
Laden Sie das aktuelle AEM as a Cloud Service-SDK.
-
Entpacken Sie die AEM-.jar-Datei, damit Sie den Ordner
crx-quickstart
erstellen können, und führen Sie sie aus:code language-bash java -jar <jar name> -unpack
-
Erstellen Sie einen
crx-quickstart/install
-Ordner. -
Kopieren Sie die richtige Sling Feature-Archivdatei des CIF-Add-ons in den
crx-quickstart/install
-Ordner.Die CIF-Add-on-ZIP-Datei enthält zwei Sling Feature-Archivdateien (
.far
). Stellen Sie sicher, dass Sie die richtige Version für die AEM-Autoren- oder AEM-Veröffentlichungsumgebung verwenden, je nachdem, wie Sie das lokale AEM as a Cloud Service-SDK ausführen möchten. -
Erstellen Sie eine lokale Betriebssystem-Umgebungsvariable mit dem Namen
COMMERCE_ENDPOINT
, die den Adobe Commerce GraphQL-Endpunkt beinhaltet.Beispiel für macOS X:
code language-bash export COMMERCE_ENDPOINT=https://<yourcommercesystem>/graphql
Beispiel für Windows:
code language-bash set COMMERCE_ENDPOINT=https://<yourcommercesystem>/graphql
Diese Variable wird von AEM verwendet, um eine Verbindung zu Ihrem E-Commerce-System herzustellen. Darüber hinaus enthält das CIF-Add-on einen lokalen Reverse-Proxy, um den Commerce-GraphQL-Endpunkt lokal verfügbar zu machen. Dieser Proxy wird von den CIF-Authoring-Tools (Produktkonsole und Auswahl) und für die Client-seitigen CIF-Komponenten verwendet, die direkte GraphQL-Aufrufe durchführen.
Diese Variable muss auch für die AEM as a Cloud Service-Umgebung eingerichtet werden. Weitere Informationen zu Variablen finden Sie unter Konfigurieren von OSGi für AEM as a Cloud Service.
-
(Optional) Um Funktionen für gestaffelte Katalogdaten zu aktivieren, müssen Sie ein Integrations-Token für Ihre Adobe Commerce-Instanz erstellen. Führen Sie die Schritte unter Erste Schritte aus, um das Token zu erstellen.
Setzen Sie ein OSGi-Geheimnis mit dem Namen
COMMERCE_AUTH_HEADER
auf den folgenden Wert:code language-xml Authorization: Bearer <Access Token>
Weitere Informationen zu Geheimnissen finden Sie unter Konfigurieren von OSGi für AEM as a Cloud Service.
-
Starten Sie das AEM as a Cloud Service-SDK.
Überprüfen Sie das Setup über die OSGi-Konsole: http://localhost:4502/system/console/osgi-installer
. Die Liste sollte die mit dem CIF-Add-on zusammenhängenden Pakete, Content-Pakete und OSGi-Konfigurationen enthalten, wie sie in der Feature-Modelldatei definiert sind.
Projekt-Setup project
Es gibt zwei Möglichkeiten für das Bootstrapping Ihres CIF-Projekts für AEM as a Cloud Service.
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 org.apache.maven.plugins:maven-archetype-plugin:3.2.1:generate \
-D archetypeGroupId=com.adobe.aem \
-D archetypeArtifactId=aem-project-archetype \
-D archetypeVersion=35 \
-D appTitle="My Site" \
-D appId="mysite" \
-D groupId="com.mysite" \
-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 das Git-Repository und passen Sie das Projekt an Ihre Bedürfnisse an.