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:

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.

TIP
Stellen Sie sicher, dass Sie immer die neueste Version des CIF-Add-ons verwenden.

Lokales Setup

Gehen Sie für die lokale CIF-Add-on-Entwicklung mit dem AEM as a Cloud Service-SDK wie folgt vor:

  1. Laden Sie das aktuelle AEM as a Cloud Service-SDK.

  2. 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
    
  3. Erstellen Sie einen crx-quickstart/install-Ordner.

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

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

  6. (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.

  7. Starten Sie das AEM as a Cloud Service-SDK.

NOTE
Stellen Sie sicher, dass Sie das AEM as a Cloud Service-SDK im selben Terminal-Fenster starten, in dem die Umgebungsvariable in Schritt 5 festgelegt wurde. Wenn Sie es in einem separaten Terminal-Fenster oder durch Doppelklicken auf die JAR-Datei starten, stellen Sie sicher, dass die Umgebungsvariable sichtbar ist.

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

TIP
Verwenden Sie immer die neueste Version des AEM-Projektarchetyps, um das Projekt zu generieren.

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.

NOTE
Das Venia Reference Store-Projekt enthält zwei Build-Profile für AEM as a Cloud Service und AEM 6.5. Schauen Sie sich die Datei readme.md des Projekts an, um zu sehen, wie sie verwendet werden.

Zusätzliche Ressourcen

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab