aem core cif components
CI
Le projet AEM CIF Core Components sert d'accélérateur pour commencer avec des projets utilisant AEM, CIF et Adobe Commerce. Le projet contient des composants de noyau de commerce réutilisables qui combinent des composants AEM rendues côté serveur avec des composants de commerce React côté client (MPA) pour les expériences / données dynamiques.
Ce projet est destiné à être utilisé en conjonction avec les composants de base des sites AEM. Les composants de base AEM CIF utilisent les composants de base des sites AEM comme fondation dans la mesure du possible et les étendaient.
Pour commencer un nouveau projet, veuillez consulter notre projet archétype. Jetez également un œil à notre projet d'échantillon de Venia qui utilise les composants WCM et CIF Core pour offrir une superbe expérience de magasin de magasin.
Voir la documentation AEM Content & Commerce pour les instructions d'utilisation et de configuration des composants de base AEM CIF et d'introduction au développement des composants AEM.
Les composants qui sont dans l'aperçu technique peuvent changer de manière compatible en arrière à tout moment. Cela inclut tous les aspects et en particulier la structure de contenu, l'API, le balisage et le style le cas échéant. N'utilisez pas ces composants en production.
La dernière version des composants de base AEM CIF nécessite les exigences du système minimum ci-dessous:
| Composants de base CIF | AEM en tant que service cloud | AEM 6.5 | Complément AEM Commerce | Adobe Commerce | Java |
|---|---|---|---|---|---|
| 2.15.0 | Continuel | 6.5.18 | v2022.08.02.00 | 2.4.2 EE | 11 |
Pour une liste des exigences pour les versions précédentes, voir les exigences du système historique.
Pour AEM en tant que déploiements de services cloud, ce projet nécessite le complément CIF provisionné sur chaque AEM en tant qu'environnement de service cloud. Le module complémentaire CIF est installé automatiquement, aucun déploiement supplémentaire n'est nécessaire. Le module complémentaire CIF est également disponible pour le développement local avec AEM SDK à partir du portail de distribution de logiciels.
Pour les installations AEM sur site, ce projet nécessite le module complémentaire AEM Commerce pour AEM 6.5 pour améliorer l'expérience de création en tirant parti des sélecteurs de produits, de la vue des actifs de produit et des consoles de produits fournies par le package de connecteur. Le module complémentaire AEM Commerce pour AEM 6.5 est également disponible sur le portail de distribution de logiciels. Il doit être installé séparément.
Ce projet repose sur les composants de base des sites AEM. Ils sont généralement installés dans le cadre de l'AEM. Si vous installez une option AEM sans exemple de contenu, vous devez les déployer manuellement avant d'utiliser les composants de base AEM CIF.
À partir de 2.3.2, Adobe Commerce prend en charge les demandes GraphQL cacheables et en commençant par la version 0.2.1, les composants CIF Core l'utiliseront par défaut. Pour faire fonctionner les composants avec Adobe Commerce 2.3.1, vous pouvez désactiver manuellement cette fonctionnalité dans les emplacements suivants:
mvn clean install dans le dossier racine pour installer les artefacts sur votre référentiel Maven local.all et exécutez un mvn clean install content-package:install .Voici une visite vidéo complète du processus de configuration.
Si vous souhaitez construire tous les modules vous-même et obtenir toutes les dernières (encore) modifications inédites , construisez et installez tous les modules avec la commande suivante à la racine du référentiel:
mvn clean install -PautoInstallAll
Cela installe tout par défaut à localhost:4502 sans chemin de contexte. Vous pouvez également configurer l'emplacement d'installation avec les propriétés Maven suivantes:
aem.host : le nom de l'instance AEMaem.port : le numéro de port de l'instance AEMaem.contextPath : le chemin de contexte de votre instance AEM (sinon / ) Ce projet repose sur l'AEM 6.5.7 cq-quickstart Uberjar. Ceci est accessible au public sur https://repo.adobe.com
Pour plus de détails sur l'Uberjar, veuillez vous rendre sur la page How To Cuil AEM à l'aide de la page de documentation Apache Maven.
La version publiée des composants de noyau AEM CIF est disponible sur le référentiel Maven Central. Pour inclure le package AEM CIF Core Components dans votre propre construction Maven Build, vous pouvez ajouter la dépendance
<dependency>
<groupId>com.adobe.commerce.cif</groupId>
<artifactId>core-cif-components-all</artifactId>
<type>zip</type>
<version>x.y.z</version>
</dependency>
et la section sous-package
<subPackage>
<groupId>com.adobe.commerce.cif</groupId>
<artifactId>core-cif-components-all</artifactId>
<filter>true</filter>
</subPackage>
au content-package-maven-plugin .
Pour connecter les composants de base AEM CIF avec votre environnement Adobe Commerce ou un déploiement de commerce tiers suivez les étapes de configuration. Pour une configuration multiple / site, des étapes supplémentaires sont nécessaires pour relier un site AEM à une configuration de vue Adobe Commerce Store.
Pour personnaliser les composants CIF Core, nous fournissons des cas d'utilisation et des exemples dans notre documentation dans la personnalisation des composants CIF Core.
Le code JavaScript côté client des composants est couvert à l'aide de tests unitaires Mocha exécutés avec Karma. Veuillez vous assurer que pour chaque contribution, le nouveau code côté client est couvert par les tests et que tous les tests passent.
cd ui.apps
npm install
npm testLe karma testera avec Chrome et Firefox. Assurez-vous que les deux navigateurs sont installés.
Vous pouvez trouver les règles de formatage de code dans le fichier eclipse-formatter.xml . Le formatage du code est automatiquement vérifié pour chaque version. Pour formater automatiquement votre code, veuillez exécuter:
mvn clean install -Pformat-code Pour la mise en forme JavaScript et CSS, nous utilisons plus joli. Le formatage est automatiquement vérifié lors de l'exécution npm test dans le projet ui.apps . Pour formater automatiquement votre code, veuillez exécuter la commande suivante dans ui.apps :
npm run prettier:fix Les versions de ce projet sont déclenchées en exécutant manuellement mvn release:prepare release:clean sur la branche master sur le dossier racine de ce référentiel. Une fois que vous avez choisi la version et les versions d'instantané suivantes, cela engage le changement avec une balise GIT de version comme par exemple core-cif-components-reactor-xyz . Notez que les commits ne sont pas automatiquement poussés vers le référentiel GIT, vous avez donc le temps de vérifier vos modifications, puis de les pousser manuellement. Le push déclenche ensuite une construction CircleCI dédiée qui effectue le déploiement de l'artefact tagué à Maven Central.
IMPORTANT : Ce projet fait des sorties de réacteurs Maven, ne déclenchez pas de versions à partir de subs modules!
Remarque: Dans le cas où il est nécessaire pour mettre à jour la version d'un bundle Java en raison des modifications de l'API et du versioning sémantique, on peut facilement mettre à jour la version POME POM POME et tous les POMs faisant référence à la version parent POM en exécutant la commande suivante dans le dossier du projet parent: mvn versions:set -DnewVersion=xyz-SNAPSHOT . Cela garantira que tous les projets ont la même version.
Les contributions sont les bienvenues! Lisez le guide contributif pour plus d'informations.
Ce projet est concédé sous licence Apache V2. Voir la licence pour plus d'informations.
