Ontwikkelen AEM Commerce voor AEM as a Cloud Service develop
Voor de ontwikkeling AEM Commerce-projecten, gebaseerd op Commerce integration framework (CIF) voor AEM as a Cloud Service, gelden dezelfde regels en beste praktijken als voor andere AEM projecten op AEM as a Cloud Service. Lees eerst het volgende:
Lokale ontwikkeling met AEM as a Cloud Service SDK local
Een lokale ontwikkelomgeving wordt aanbevolen voor CIF projecten. De CIF invoegtoepassing voor AEM as a Cloud Service is ook beschikbaar voor lokale ontwikkeling. Het kan van het portaal van de Distributie van de Software worden gedownload.
De CIF Add-On wordt geleverd als een archief met verkoopfuncties. Het ZIP-bestand dat beschikbaar is op de portal Softwaredistributie bevat twee Sling Feature-archiefbestanden: een voor AEM auteur en een voor AEM publicatie-instanties.
Nieuw aan AEM as a Cloud Service? Controle uit een meer gedetailleerde gids aan vestiging een lokale ontwikkelomgeving gebruikend AEM as a Cloud Service SDK.
Vereiste software
Het volgende moet lokaal worden geïnstalleerd:
- AEM as a Cloud Service SDK
- Java™ 11
- Apache Maven(3.3.9 of nieuwer)
- Node.js v10+
- npm 6+
- Git
Toegang tot de CIF
CIF toe:voegen-op kan als zip dossier van het portaal van de Distributie van de Softwareworden gedownload. Het zip dossier bevat CIF toe:voegen-op als het Sling archief van de Eigenschap, is het geen AEM pakket. Aanbiedingen in SDK zijn toegankelijk met een AEM as a Cloud Service-licentie.
Lokale instelling
Voor ontwikkeling van lokale CIF Add-on met de AEM as a Cloud Service SDK gaat u als volgt te werk:
-
De nieuwste AEM as a Cloud Service SDK ophalen
-
Pak de AEM .jar uit zodat u de
crx-quickstart
-map kunt maken, voer dan de volgende handelingen uit:code language-bash java -jar <jar name> -unpack
-
Een
crx-quickstart/install
-map maken -
Kopieer het juiste archiefbestand voor de verkoopfunctie van de CIF add-on naar de map
crx-quickstart/install
.Het ZIP-bestand met CIF add-on bevat twee archiefbestanden voor de verkoopfunctie
.far
. Zorg ervoor dat u de juiste naam gebruikt voor AEM auteur of AEM Publish, afhankelijk van hoe u de lokale AEM as a Cloud Service SDK wilt uitvoeren. -
Maak een lokale besturingssysteemomgevingsvariabele met de naam
COMMERCE_ENDPOINT
die het Adobe Commerce GraphQL-eindpunt vasthoudt.Voorbeeld macOS X:
code language-bash export COMMERCE_ENDPOINT=https://<yourcommercesystem>/graphql
Voorbeeld van Windows:
code language-bash set COMMERCE_ENDPOINT=https://<yourcommercesystem>/graphql
Deze variabele wordt gebruikt door AEM om met uw handelssysteem te verbinden. Bovendien bevat de CIF add-on een lokale reverse-proxy waarmee het Commerce GraphQL-eindpunt lokaal beschikbaar wordt gemaakt. Deze volmacht wordt gebruikt door de CIF auteurshulpmiddelen (productconsole en plukkers) en voor de CIF cliënt-zijcomponenten die directe vraag van GraphQL doen.
Deze variabele moet ook voor de AEM as a Cloud Service-omgeving worden ingesteld. Voor meer informatie over variabelen, zie het Vormen OSGi voor AEM as a Cloud Service.
-
(Optioneel) Als u niet-actieve catalogusfuncties wilt inschakelen, moet u een integratietoken maken voor uw Adobe Commerce-instantie. Volg de stappen bij Begonnen het wordenom het teken tot stand te brengen.
Stel een geheim OSGi met de naam
COMMERCE_AUTH_HEADER
in op de volgende waarde:code language-xml Authorization: Bearer <Access Token>
Voor meer informatie over geheimen, zie Vormend OSGi voor AEM as a Cloud Service.
-
De SDK van AEM as a Cloud Service starten
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, zoals gedefinieerd in het bestand met het functiemodel.
Projectinstelling project
Er zijn twee manieren om uw CIF project voor AEM as a Cloud Service te Bootstrappen.
Projectarchetype AEM gebruiken
Het AEM Archetype van het Projectis het belangrijkste hulpmiddel om een vooraf gevormd project te Bootstrappen om met CIF begonnen te worden. 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 in het project wilt opnemen, gebruikt u de optie includeCommerce
.
Bijvoorbeeld:
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 Core Components kunnen in elk project worden gebruikt door het meegeleverde all
-pakket op te nemen of afzonderlijk met behulp van het pakket met CIF inhoud en verwante OSGI-bundels. Om CIF de Componenten van de Kern aan een project manueel toe te voegen, gebruik 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 aan de slag te gaan met de Venia Reference Store, kloont u de Git-opslagplaats en begint u het project aan te passen aan uw behoeften.