Utveckla AEM Commerce för AEM as a Cloud Service develop
Utveckla AEM Commerce-projekt, som bygger på Commerce integration framework (CIF) for 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-projekt. CIF Add-On för AEM as a Cloud Service finns också för lokal utveckling. Den kan hämtas från portalen för programvarudistribution.
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-författare och en för AEM publiceringsinstanser.
Ny på AEM as a Cloud Service? 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:
- SDK för AEM as a Cloud Service
- Java™ 11
- Apache Maven (3.3.9 eller senare)
- Node.js v10+
- npm 6+
- Git
Åtkomst till CIF-tillägget
CIF-tillägget kan laddas ned som en zip-fil från programdistributionsportalen. ZIP-filen innehåller CIF-tillägget som Sling Feature archive, det är inte ett AEM-paket. SDK-listor kan köpas med en AEM as a Cloud Service-licens.
Lokal installation
Så här utvecklar du CIF Add-on lokalt med AEM as a Cloud Service SDK:
-
Skaffa de senaste AEM as a Cloud Service SDK
-
Packa upp AEM .jar så att du kan skapa mappen
crx-quickstart
, kör:code language-bash java -jar <jar name> -unpack
-
Skapa en
crx-quickstart/install
-mapp -
Kopiera rätt fil för Sling Feature archive för CIF-tillägget till mappen
crx-quickstart/install
.ZIP-filen för CIF-tillägget innehåller två Sling Feature-arkiv
.far
. Se till att du använder rätt för AEM Author eller AEM Publish, beroende på hur du tänker köra AEM as a Cloud Service SDK lokalt. -
Skapa en lokal systemmiljövariabel med namnet
COMMERCE_ENDPOINT
som innehå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. CIF-tillägget innehåller också en lokal omvänd proxy som gör Commerce GraphQL-slutpunkten tillgänglig lokalt. Den här proxyn används av CIF utvecklingsverktyg (produktkonsol och väljare) och för CIF klientkomponenter som gör direkta GraphQL-anrop.
Den här variabeln måste även ställas in för AEM as a Cloud Service-miljön. Mer information om variabler finns i Konfigurera OSGi för AEM as a Cloud Service.
-
(Valfritt) Om du vill aktivera funktioner för mellanlagrade kataloger måste du skapa en integreringstoken för din Adobe Commerce-instans. Skapa token genom att följa stegen på Komma igång.
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.
-
Starta AEM as a Cloud Service SDK
Verifiera konfigurationen via OSGI-konsolen: http://localhost:4502/system/console/osgi-installer
. Listan ska innehålla de CIF-tilläggspaket, innehållspaket och OSGI-konfigurationer som definieras i funktionsmodellfilen.
Projektinställningar project
Det finns två sätt att Bootstrap ditt CIF-projekt för AEM as a Cloud Service.
Använd AEM Project Archetype
AEM Project Archetype är huvudverktyget för Bootstrap, ett förkonfigurerat projekt för att komma igång med CIF. CIF Core Components och alla nödvändiga konfigurationer kan inkluderas i ett genererat projekt med ytterligare ett alternativ.
Se användningsinstruktioner för AEM Project Archetype om hur du genererar ett AEM-projekt. Använd alternativet includeCommerce
om du vill inkludera CIF i projektet.
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 Core Components kan användas i alla projekt, antingen genom att inkludera det tillhandahållna all
-paketet eller individuellt med CIF innehållspaket och relaterade OSGI-paket. Om du vill lägga till CIF Core-komponenter 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 Venia Reference Store. AEM Venia Reference Store är ett exempel på hur CIF Core Components används för 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.