aem core cif components
CI
Das Projekt AEM CIF Core Components dient als Gaspedal, um mit Projekten mit AEM, CIF und Adobe Commerce zu beginnen. Das Projekt enthält wiederverwendbare Commerce-Kernkomponenten, die serverseitige AEM-Komponenten mit clientseitigen React Commerce-Komponenten (MPA) für dynamische Erlebnisse / Daten kombinieren.
Dieses Projekt soll in Verbindung mit den Kernkomponenten der AEM -Stellen verwendet werden. AEM CIF -Kernkomponenten verwenden die Kernkomponenten der AEM -Stellen, wo dies möglich ist, als Grundlage und erweitern sie.
Für den Start eines neuen Projekts schauen Sie sich bitte unser Archetyp -Projekt an. Schauen Sie sich auch unser Venia-Beispielprojekt an, das die WCM- und CIF-Kernkomponenten verwendet, um ein atemberaubendes Erlebnis für das Geschäft zu bieten.
In der Dokumentation von AEM Content & Commerce finden Sie die Anweisungen zur Verwendung und Konfiguration der AEM -CIF -Kernkomponenten und der Einführung in die Entwicklung der AEM -Komponenten.
Komponenten, die sich in der technischen Vorschau befinden, können sich jederzeit auf eine nicht rückwärtskompatible Weise ändern. Dies schließt alle ASPECTS und insbesondere die Inhaltsstruktur, API, Markup und Styling ein. Verwenden Sie diese Komponenten nicht in der Produktion.
Die neueste Version der AEM CIF -Kernkomponenten erfordert die folgenden Mindestsystemanforderungen:
| CIF -Kernkomponenten | AEM als Cloud -Service | AEM 6.5 | AEM Commerce Add-On | Adobe Commerce | Java |
|---|---|---|---|---|---|
| 2.15.0 | Kontinuierlich | 6.5.18 | V2022.08.02.00 | 2.4.2 ee | 11 |
Eine Liste der Anforderungen für frühere Versionen finden Sie unter historischen Systemanforderungen.
Für AEM als Cloud-Service-Bereitstellungen erfordert dieses Projekt das CIF-Add-On, das in jedem AEM als Cloud-Service-Umgebung bereitgestellt wird. Das CIF-Add-On wird automatisch installiert, es ist keine zusätzliche Bereitstellung erforderlich. Das CIF-Add-On ist auch für die lokale Entwicklung mit AEM SDK vom Softwareverteilungsportal verfügbar.
Für AEM-On-Prem-Installationen erfordert dieses Projekt das AEM Commerce-Add-On für AEM 6.5, um das Authoring-Erlebnis zu verbessern, indem die Produktpicker, die Produktvermögensansicht und die von dem Connector-Paket bereitgestellten Produktkonsolen eingesetzt werden. Das AEM Commerce-Add-On für AEM 6.5 ist auch im Softwareverteilungsportal verfügbar. Es muss separat installiert werden.
Dieses Projekt basiert auf den Kernkomponenten der AEM -Websites. Sie werden normalerweise als Teil von AEM installiert. Wenn Sie AEM ohne Beispiel -Inhaltsoption installieren, müssen Sie sie manuell bereitstellen, bevor Sie die AEM CIF -Kernkomponenten verwenden.
Beginnend mit 2.3.2 unterstützt Adobe Commerce Cache-Afle-GraphQL-Anforderungen und beginnend mit Version 0.2.1 Die CIF-Kernkomponenten verwenden es standardmäßig. Damit die Komponenten mit Adobe Commerce 2.3.1 funktioniert, können Sie diese Funktion manuell an folgenden Stellen deaktivieren:
mvn clean install im Root -Ordner aus, um die Artefakte in Ihrem lokalen Maven -Repository zu installieren.all Projekt und führen Sie eine mvn clean install content-package:install .Hier ist ein vollständiger Video-Walk-Through des Setup-Prozesses.
Wenn Sie alle Module selbst erstellen und die neuesten (noch) unveröffentlichten Änderungen erhalten möchten, erstellen und installieren Sie einfach alle Module mit dem folgenden Befehl am Root des Repositorys:
mvn clean install -PautoInstallAll
Dies installiert alles standardmäßig an localhost:4502 ohne einen Kontextpfad. Sie können den Installationsort auch mit den folgenden Maven -Eigenschaften konfigurieren:
aem.host : Der Name der AEM -Instanzaem.port : Die Portnummer der AEM -Instanzaem.contextPath : Der Kontextpfad Ihrer AEM -Instanz (wenn nicht / ) Dieses Projekt basiert auf dem AEM 6.5.7 cq-quickstart Uberjar. Dies ist öffentlich auf https://repo.adobe.com verfügbar
Weitere Informationen zum Uberjar finden Sie unter der Erstellung von AEM -Projekten zum Erstellen von AEM -Projekten mit der Apache Maven -Dokumentationsseite.
Die veröffentlichte Version der AEM CIF -Kernkomponenten ist im Maven Central Repository verfügbar. Um das Paket AEM CIF Core Components in Ihren eigenen Projekt zu einem Einbeziehung von Maven -Build einzubeziehen, können Sie die Abhängigkeit hinzufügen
<dependency>
<groupId>com.adobe.commerce.cif</groupId>
<artifactId>core-cif-components-all</artifactId>
<type>zip</type>
<version>x.y.z</version>
</dependency>
und Subpaketabschnitt
<subPackage>
<groupId>com.adobe.commerce.cif</groupId>
<artifactId>core-cif-components-all</artifactId>
<filter>true</filter>
</subPackage>
zum content-package-maven-plugin .
Folgen Sie den Konfigurationsschritten, um die AEM CIF -Kernkomponenten mit Ihrer Adobe Commerce -Umgebung oder einer Handelsbereitstellung von Drittanbietern zu verbinden. Für ein Multi -Store / Site -Setup sind zusätzliche Schritte erforderlich, um eine AEM -Site mit einer Adobe Commerce Store -Ansichtskonfiguration zu verknüpfen.
Zum Anpassen von CIF -Kernkomponenten stellen wir Anwendungsfälle und Beispiele in unserer Dokumentation zum Anpassen von CIF -Kernkomponenten bereit.
Der clientseitige JavaScript-Code der Komponenten wird unter Verwendung von mit Karma durchgeführten Mokka-Unit-Tests behandelt. Bitte stellen Sie sicher, dass für jeden Beitrag neuer clientseitiger Code durch Tests behandelt wird und alle Tests bestehen.
cd ui.apps
npm install
npm testKarma wird mit Chrom und Firefox testen. Stellen Sie sicher, dass beide Browser installiert sind.
Die Code-Formatierungsregeln finden Sie in der Datei eclipse-formatter.xml . Die Codeformatierung wird automatisch für jeden Build überprüft. Um Ihren Code automatisch zu formatieren, führen Sie bitte aus:
mvn clean install -Pformat-code Zum Formatieren von JavaScript und CSS verwenden wir schöner. Die Formatierung wird automatisch überprüft, wenn npm test im ui.apps -Projekt ausgeführt wird. Um Ihren Code automatisch zu formatieren, führen Sie bitte den folgenden Befehl in ui.apps aus:
npm run prettier:fix Die Veröffentlichungen dieses Projekts werden durch manuell ausgeführte mvn release:prepare release:clean den master -Zweig im Stammordner dieses Repositorys. Sobald Sie die Version und die nächsten Snapshot-Versionen ausgewählt haben, verpflichtet sich die Änderung zusammen mit einem Release-Git-Tag wie z. B. core-cif-components-reactor-xyz . Beachten Sie, dass die Commits nicht automatisch in das Git -Repository weitergeleitet werden, sodass Sie einige Zeit haben, um Ihre Änderungen zu überprüfen und sie dann manuell zu schieben. Der Push löst dann einen dedizierten CircleCI -Build aus, der den Einsatz des markierten Artefakts für Maven Central ausführt.
WICHTIG : Dieses Projekt veröffentlicht Maven Reactor, löst keine Releases aus Submodulen aus!
Hinweis: Falls es erforderlich ist, die Version eines Java -Bundle aufgrund von API -Änderungen und semantischen Versionen zu aktualisieren, kann man die übergeordnete POM -Version und alle POMS, die auf die übergeordnete POM -Version verweisen, durch Ausführen des folgenden Befehls im übergeordneten Projektordner leicht aktualisiert werden: mvn versions:set -DnewVersion=xyz-SNAPSHOT . Dadurch wird sichergestellt, dass alle Projekte dieselbe Version haben.
Beiträge sind begrüßt! Weitere Informationen finden Sie im beitragenden Leitfaden.
Dieses Projekt ist unter der Apache V2 -Lizenz lizenziert. Weitere Informationen finden Sie unter Lizenz.
