Sviluppare AEM Commerce per AEM as a Cloud Service develop
Lo sviluppo di progetti AEM-Commerce, basati su Commerce integration framework (CIF) per AEM as a Cloud Service, segue le stesse regole e best practice di altri progetti AEM su AEM as a Cloud Service. Rivedi prima quanto segue:
Sviluppo locale con SDK di AEM as a Cloud Service local
Si consiglia di utilizzare un ambiente di sviluppo locale con progetti CIF. Il componente aggiuntivo CIF fornito per AEM as a Cloud Service è disponibile anche per lo sviluppo locale. Può essere scaricato dal portale di distribuzione software.
Il componente aggiuntivo CIF viene fornito come archivio di Sling Feature. Il file zip disponibile nel portale di distribuzione software include due file di archivio Sling Feature, uno per l’istanza AEM di authoring e uno per quella di pubblicazione.
Ti avvicini adesso ad AEM as a Cloud Service? Consulta una guida più dettagliata per configurare un ambiente di sviluppo locale utilizzando l'SDK di AEM as a Cloud Service.
Software richiesto
È necessario installare localmente quanto segue:
- SDK di AEM as a Cloud Service
- Java™ 11
- Apache Maven (3.3.9 o successivo)
- Node.js v10+
- npm 6+
- Git
Accesso al componente aggiuntivo CIF
Il componente aggiuntivo CIF può essere scaricato come file zip dal portale di distribuzione software. Il file zip contiene il componente aggiuntivo CIF come archivio Sling Feature, non è un pacchetto AEM. Le inserzioni SDK sono accessibili con una licenza AEM as a Cloud Service.
Configurazione locale
Per lo sviluppo locale del componente aggiuntivo CIF utilizzando l’SDK di AEM as a Cloud Service, è necessario procedere seguendo questi passaggi:
-
Scarica il più recente SDK di AEM as a Cloud Service.
-
Decomprimi il file .jar dell'AEM in modo da poter creare la cartella
crx-quickstart
ed esegui:code language-bash java -jar <jar name> -unpack
-
Crea una cartella
crx-quickstart/install
. -
Copia il file di archivio Sling Feature corretto del componente aggiuntivo CIF nella cartella
crx-quickstart/install
.Il file ZIP del componente aggiuntivo CIF contiene due file di archivio Sling Feature
.far
. Usa sempre quello corretto per AEM Author o AEM Publish, a seconda di come verrà eseguito l’SDK locale di AEM as a Cloud Service. -
Creare una variabile di ambiente del sistema operativo locale denominata
COMMERCE_ENDPOINT
contenente l'endpoint Adobe Commerce GraphQL.Esempio di macOS X:
code language-bash export COMMERCE_ENDPOINT=https://<yourcommercesystem>/graphql
Esempio Windows:
code language-bash set COMMERCE_ENDPOINT=https://<yourcommercesystem>/graphql
Questa variabile viene utilizzata dall’AEM per connettersi al sistema commerce. Inoltre, il componente aggiuntivo CIF include un proxy inverso locale per rendere disponibile localmente l’endpoint Commerce GraphQL. Questo proxy viene utilizzato dagli strumenti di creazione dell’CIF (console prodotti e selettori) e per i componenti CIF lato client che effettuano chiamate dirette a GraphQL.
Questa variabile deve essere impostata anche per l’ambiente AEM as a Cloud Service. Per ulteriori informazioni sulle variabili, vedere Configurazione di OSGi per AEM as a Cloud Service.
-
(Facoltativo) Per abilitare le funzioni di catalogo per staging, devi creare un token di integrazione per la tua istanza di Adobe Commerce. Segui i passaggi in Guida introduttiva per creare il token.
Imposta un segreto OSGi con il nome
COMMERCE_AUTH_HEADER
sul seguente valore:code language-xml Authorization: Bearer <Access Token>
Per ulteriori informazioni sui segreti, vedere Configurazione di OSGi per AEM as a Cloud Service.
-
Avvia l’SDK di AEM as a Cloud Service.
Verifica la configurazione tramite la console OSGI:http://localhost:4502/system/console/osgi-installer
. L’elenco deve includere i bundle relativi al componente aggiuntivo CIF, il pacchetto di contenuti e le configurazioni OSGI come definiti nel file di modello della funzione.
Configurazione del progetto project
Esistono due modi per Bootstrap il progetto CIF per AEM as a Cloud Service.
Usare AEM Project Archetype
Il Archetipo progetto AEM è lo strumento principale per la Bootstrap di un progetto preconfigurato per iniziare a utilizzare CIF. I componenti core CIF e tutte le configurazioni richieste possono essere inclusi in un progetto generato con un’opzione aggiuntiva.
Consulta le istruzioni d’uso di AEM Project Archetype per la generazione di un progetto AEM. Per includere CIF nel progetto, utilizzare l'opzione includeCommerce
.
Ad esempio:
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
I componenti core CIF possono essere utilizzati in qualsiasi progetto includendo il pacchetto all
fornito o singolarmente utilizzando il pacchetto di contenuti CIF e i bundle OSGI correlati. Per aggiungere manualmente i Componenti core CIF a un progetto, utilizza le dipendenze seguenti:
<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>
Usare AEM Venia Reference Store
Una seconda opzione per avviare un progetto CIF è clonare e utilizzare AEM Venia Reference Store. AEM Venia Reference Store è un esempio di applicazione di vetrina di riferimento che illustra l’utilizzo dei componenti core CIF di AEM. Si tratta di un insieme di esempi di best practice e di un potenziale punto di partenza per sviluppare le tue funzionalità.
Per iniziare a utilizzare Venia Reference Store, clona l’archivio Git e inizia a personalizzare il progetto in base alle tue esigenze.