Ontwikkeling AEM Commerce develop
Voor de ontwikkeling AEM Commerce-projecten op basis van Commerce integration framework (CIF) voor AEM gelden dezelfde regels en beste praktijken als voor andere AEM projecten. Bekijk eerst deze:
Lokale ontwikkeling voor AEM Commerce local
Een lokale ontwikkelomgeving wordt aanbevolen voor CIF projecten.
De AEM Commerce Add-On voor AEM 6.5 ook bekend. CIF Add-On is ook beschikbaar voor lokale ontwikkeling en wordt als een AEM pakket geleverd. Het kan van het portaal van de Distributie van de Softwareals eigenschappak worden gedownload.
Vereiste software
Het volgende moet lokaal worden geïnstalleerd:
- Lokale AEM 6.5
- AEM 6.5 Service Pack7 of later
- Java 11
- Apache Maven(3.3.9 of nieuwer)
- Knoop LTS
- npm 6+
- Git
Toegang tot de CIF
CIF toe:voegen-op kan van het portaal van de Distributie van de Software worden gedownload, onderzoek naar "AEM Commerce toe:voegen-op".
Lokale instellingen
Voor de ontwikkeling van lokale CIF projecten met behulp van de AEM en de CIF:
-
Krijg AEM 6.5 versie en installeer AEM 6.5 Service Pack. AEM 6.5 Service Pack 7 is vereist, nochtans adviseert de Adobe installerend het laatste beschikbare de dienstpak.
-
Pak de AEM .jar uit om de map
crx-quickstart
te maken en voer de volgende handelingen uit:code language-bash java -jar <jar name> -unpack
-
Een
crx-quickstart/install
-map maken -
Kopieer de CIF add-on alle pakketten, gedownload van de Software Distribution Portal, naar de map
crx-quickstart/install
.
- Start de AEM
Controleer de installatie via de OSGI-console: http://localhost:4502/system/console/osgi-installer
. De lijst moet de CIF add-on gerelateerde bundels, content-package en OSGI-configuraties bevatten. Zorg ervoor dat alle bundels zijn gestart.
Projectinstelling project
Er zijn twee manieren om uw AEM Commerce-project te starten met CIF.
Projectarchetype AEM gebruiken
Het AEM Archetype van het Projectis het belangrijkste hulpmiddel om een vooraf gevormd project op te starten om met CIF te beginnen. CIF de Componenten van de Kern en alle vereiste configuraties kunnen in een geproduceerd project met één extra optie worden omvat.
Zie AEM het gebruiksinstructies van de Archetype van het Project 🔗 op hoe te om een AEM project te produceren. Als u CIF wilt opnemen in het project, gebruikt u de optie includeCommerce
.
Bijvoorbeeld:
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 Core Components kunnen in elk project worden gebruikt door ofwel het meegeleverde all
-pakket op te nemen ofwel het individuele pakket met CIF inhoud en verwante OSGI-bundels. Om CIF de Componenten van de Kern aan een project manueel toe te voegen gebruiken de volgende gebiedsdelen:
<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 Reference Store gebruiken
Een tweede optie om een CIF project te beginnen is het AEM de Opslag van de Verwijzing van Veniate klonen en te gebruiken. De AEM Venia Reference Store is een voorbeeldtoepassing van de verwijzingsopslag die het gebruik van CIF Core Components voor AEM aantoont. Het is bedoeld als een set voorbeelden van best practices en een mogelijk beginpunt voor het ontwikkelen van uw eigen functionaliteit.
Om met de Opslag van de Verwijzing van Venia eenvoudig te beginnen klonen de bewaarplaats van het Giten beginnen het project overeenkomstig uw behoeften aan te passen.
classic
.AEM verbinden met het Commerce-systeem
Om uw project met het handelssysteem te verbinden AEM moet met het eindpunt van GraphQL van uw handelssysteem worden gevormd.
Zowel, omvat een project dat door het AEM Archieftype van het Projectof AEM de Opslag van de Verwijzing van Veniawordt geproduceerd, reeds a gebrek configdat moet worden aangepast.
Vervang de waarde van url
in com.adobe.cq.commerce.graphql.client.impl.GraphqlClientImpl~default.cfg.json
met het eindpunt van GraphQL van uw handelsysteem dat door het project wordt gebruikt.
De AEM toe:voegen-aan en CIFComponenten van de Kern verbinden met het handelsGraphQL eindpunt via de AEM server en direct via browser. Client-side CIF Core Components and CIF Add-on authoring tools by default connect to /api/graphql
. Indien nodig kan dit worden aangepast via de configuratie van de CIF Cloud Service (zie hieronder).
De CIF add-on biedt een GraphQL-proxyservlet op /api/graphql
. Als u niet van plan bent om een lokale AEM Dispatcher te gebruiken, wordt het geadviseerd om de volmachtsservlet van GraphQL eveneens te vormen.
Navigeer naar http://localhost:4502/system/console/configMgr en maak een OSGI-config voor de Adobe CIF GraphQL Proxy Configuration
-service. Gebruik hetzelfde GraphQL-eindpunt van uw handelssysteem als hierboven voor de GraphQL-client.