Utveckla AEM Commerce för AEM as a Cloud Service develop

Utveckla AEM Commerce-projekt, som bygger på Commerce integration framework (CIF) för AEM as a Cloud Service, följer samma regler och bästa praxis som andra AEM projekt på AEM as a Cloud Service. Granska följande först:

Lokal utveckling med AEM as a Cloud Service SDK local

En lokal utvecklingsmiljö rekommenderas för CIF. CIF Add-On för AEM as a Cloud Service är också tillgänglig för lokal utveckling. Den kan laddas ned från Programdistributionsportal.

CIF Add-On finns som arkiv för Sling Feature. ZIP-filen som finns på Software Distribution Portal innehåller två Sling Feature-arkivfiler, en för AEM och en för AEM.

Är du inte AEM as a Cloud Service? Checka ut en mer detaljerad guide till hur du konfigurerar en lokal utvecklingsmiljö med AEM as a Cloud Service SDK.

Nödvändig programvara

Följande bör installeras lokalt:

Åtkomst till CIF

Tillägget CIF kan laddas ned som en zip-fil från Programdistributionsportal. ZIP-filen innehåller CIF som Arkiv med försäljningsfunktioner, det är inte ett AEM paket. SDK-listor är tillgängliga med en AEM as a Cloud Service licens.

TIP
Se till att du alltid använder den senaste CIF Add-On-versionen.

Lokal installation

För lokal CIF-tilläggsutveckling med AEM as a Cloud Service SDK:

  1. Hämta den senaste AEM as a Cloud Service SDK

  2. Packa upp AEM .jar så att du kan skapa crx-quickstart mapp, kör:

    code language-bash
    java -jar <jar name> -unpack
    
  3. Skapa en crx-quickstart/install mapp

  4. Kopiera rätt fil för Sling Feature archive för CIF i crx-quickstart/install mapp.

    Den CIF ZIP-tilläggsfilen innehåller två Sling Feature-arkiv .far filer. Se till att du använder rätt för AEM författare eller AEM publicering, beroende på hur du tänker köra den lokala AEM as a Cloud Service SDK:n.

  5. Skapa en lokal systemmiljövariabel med namnet COMMERCE_ENDPOINT håller slutpunkten för Adobe Commerce GraphQL.

    Exempel på macOS X:

    code language-bash
    export COMMERCE_ENDPOINT=https://<yourcommercesystem>/graphql
    

    Exempelfönster:

    code language-bash
    set COMMERCE_ENDPOINT=https://<yourcommercesystem>/graphql
    

    Den här variabeln används av AEM för att ansluta till ditt handelssystem. Tillägget CIF innehåller också en lokal omvänd proxy som gör slutpunkten för Commerce GraphQL tillgänglig lokalt. Den här proxyn används av CIF (produktkonsol och väljare) och för de komponenter på klientsidan som utför direkta GraphQL-anrop CIF.

    Den här variabeln måste även ställas in för den AEM as a Cloud Service miljön. Mer information om variabler finns i Konfigurera OSGi för AEM as a Cloud Service.

  6. (Valfritt) Om du vill aktivera funktioner för mellanlagrade kataloger måste du skapa en integreringstoken för din Adobe Commerce-instans. Följ stegen på Komma igång för att skapa token.

    Ange en OSGi-hemlighet med namnet COMMERCE_AUTH_HEADER till följande värde:

    code language-xml
    Authorization: Bearer <Access Token>
    

    Mer information om hemligheter finns i Konfigurera OSGi för AEM as a Cloud Service.

  7. Starta AEM as a Cloud Service SDK

NOTE
Se till att du startar AEM as a Cloud Service SDK i samma terminalfönster som systemvariabeln var inställd i steg 5. Om du startar det i ett separat terminalfönster, eller om du dubbelklickar på .jar-filen, kontrollerar du att systemvariabeln är synlig.

Verifiera konfigurationen via OSGI-konsolen: http://localhost:4502/system/console/osgi-installer. Listan ska innehålla de CIF tilläggspaketen, innehållspaketet och OSGI-konfigurationer som definieras i funktionsmodellfilen.

Projektinställningar project

Det finns två sätt att göra ditt CIF as a Cloud Service AEM Bootstrap.

Använd AEM projekttyp

The AEM Project Archettype är huvudverktyget för ett förkonfigurerat projekt för att komma igång med CIF Bootstrap. CIF kärnkomponenter och alla nödvändiga konfigurationer kan inkluderas i ett genererat projekt med ytterligare ett alternativ.

TIP
Använd alltid den senaste versionen av AEM Project Archettype så att du kan generera projektet.

Se AEM Project Archetype användningsinstruktioner om hur du skapar ett AEM projekt. Om du vill inkludera CIF i projektet använder du includeCommerce alternativ.

Till exempel:

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 kärnkomponenter kan användas i alla projekt, antingen med de medföljande all paketera eller individuellt med hjälp av CIF och tillhörande OSGI-paket. Använd följande beroenden om du vill lägga till CIF kärnkomponenter manuellt i ett projekt:

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

Använd AEM Venia Reference Store

Ett andra alternativ för att starta ett CIF är att klona och använda AEM Venia Reference Store. AEM Venia Reference Store är ett exempel på referensarkivprogram som demonstrerar användningen av CIF Core Components for AEM. Det är avsett som en uppsättning med metodtips och en potentiell utgångspunkt för att utveckla din egen funktionalitet.

Börja med att klona Git-databasen och börja anpassa projektet efter dina behov.

NOTE
Projektet Venia Reference Store innehåller två byggprofiler för AEM as a Cloud Service och AEM 6.5. Kontrollera project readme.md så att du kan se hur de används.

Ytterligare resurser

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