Entwicklung in AEM Commerce develop

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:

Lokale Entwicklung für AEM Commerce local

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

NOTE
Die folgenden Anweisungen helfen Ihnen beim Einrichten einer lokalen AEM-Entwicklungsumgebung für AEM Commerce mithilfe von CIF und mit Schwerpunkt auf AEM 6.5. Wenn Sie AEM as a Cloud Service verwenden, lesen Sie die Dokumentation zu AEM Commerce as a Cloud Service.

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:

Zugriff auf das CIF-Add-on

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

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

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. Adobe empfiehlt 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:

    code language-bash
    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.

TIP
Alternativ kann das CIF-Add-On-Paket auch über den Package Manager installiert werden.
  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 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.

TIP
Verwenden Sie AEM-Projektarchetyp 25 oder höher, um das Projekt zu erstellen.

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.

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. Für AEM 6.5 verwenden Sie das Profil classic.

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

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2