Utveckla AEM Commerce develop

Utveckla AEM Commerce-projekt baserade på Commerce integration framework (CIF) för AEM följer samma regler och bästa praxis som andra AEM projekt. Granska dessa först:

Local Development for AEM Commerce local

En lokal utvecklingsmiljö rekommenderas för CIF.

NOTE
Följande instruktioner hjälper dig att konfigurera en lokal AEM för AEM Commerce med CIF med fokus för AEM 6.5). Om du använder AEM as a Cloud Service läser du AEM Commerce as a Cloud Service -dokumentationen.

AEM Commerce Add-On för AEM 6.5 alias. CIF Add-On finns även för lokal utveckling och tillhandahålls som ett AEM. Den kan hämtas från Software Distribution Portal som ett funktionspaket.

Nödvändig programvara

Följande bör installeras lokalt:

Åtkomst till CIF

Det CIF tillägget kan hämtas från portalen för programvarudistribution. Sök efter AEM Commerce-tillägg.

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

Lokal installation

För lokal CIF projektutveckling med AEM och CIF steg:

  1. Hämta AEM 6.5 och installera AEM 6.5 Service Pack. AEM 6.5 Service Pack 7 krävs, men Adobe rekommenderar att du installerar det senaste tillgängliga Service Pack-paketet.

  2. Packa upp AEM .jar för att skapa mappen crx-quickstart. Kör:

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

  4. Kopiera CIF-tillägget för alla paket som hämtats från portalen för programdistribution till mappen crx-quickstart/install.

TIP
CIF tilläggspaket kan också installeras via Package Manager.
  1. Starta AEM snabbstart

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. Se till att alla paket har startats.

Projektinställningar project

Det finns två sätt att starta AEM Commerce-projekt med CIF.

Använd AEM projekttyp

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

TIP
Använd AEM Project Archetype 25 eller senare för att generera projektet.

Se AEM användningsinstruktioner om hur du genererar ett AEM projekt. Använd alternativet includeCommerce om du vill inkludera CIF i projektet.

Till exempel:

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 kärnkomponenter kan användas i alla projekt, antingen genom att inkludera det angivna all-paketet eller genom att använda det CIF innehållspaketet och relaterade OSGI-paket. Om du vill lägga till CIF kärnkomponenter manuellt i ett projekt använder du följande beroenden:

<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 projekt är att klona och använda AEM Venedig 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 för att se hur de används. För AEM 6.5 använder du profilen classic.

Anslut AEM till Commerce System

För att ansluta ditt projekt till e-handelssystemet måste AEM konfigureras med GraphQL slutpunkt i e-handelssystemet.

Båda, ett projekt som genererats av AEM Project Archetype eller AEM Venia Reference Store, innehåller redan en standardkonfiguration som måste justeras.

Ersätt värdet för url i com.adobe.cq.commerce.graphql.client.impl.GraphqlClientImpl~default.cfg.json med GraphQL-slutpunkten för det e-handelssystem som används av projektet.

AEM Commerce Add-On och CIF Core Components ansluter till GraphQL-slutpunkten via AEM och direkt via webbläsaren. Klientsidan CIF kärnkomponenter och redigeringsverktygen för CIF tillägg ansluter som standard till /api/graphql. Vid behov kan detta justeras via CIF Cloud Service-konfigurationen (se nedan).

CIF tillhandahåller en GraphQL-proxyserver på /api/graphql. Om du inte tänker använda en lokal AEM Dispatcher rekommenderar vi att du även konfigurerar GraphQL proxyserver.

Navigera till http://localhost:4502/system/console/configMgr och skapa en OSGI-konfiguration för tjänsten Adobe CIF GraphQL Proxy Configuration. Använd samma GraphQL-slutpunkt i e-handelssystemet som för GraphQL-klienten ovan.

Ytterligare resurser

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