aem core cif components
CI
AEM CIFコアコンポーネントプロジェクトは、AEM、CIF、Adobe Commerceを使用したプロジェクトを開始するためのアクセラレータとして機能します。このプロジェクトには、ダイナミックエクスペリエンス /データのために、サーバー側のレンダリングされたAEMコンポーネントとクライアント側のReact Commerceコンポーネント（MPA）を組み合わせた再利用可能なCommerceコアコンポーネントが含まれています。
このプロジェクトは、AEMサイトのコアコンポーネントと組み合わせて使用することを目的としています。 AEM CIFコアコンポーネントは、可能な限り基盤としてAEMサイトコアコンポーネントを使用し、それらを拡張します。
新しいプロジェクトを開始するには、Archetypeプロジェクトをご覧ください。また、WCMおよびCIFコアコンポーネントを使用して見事な店頭体験を提供するVeniaサンプルプロジェクトもご覧ください。
AEM CIFコアコンポーネントの使用法と構成命令については、AEMコンポーネント開発の紹介については、AEMコンテンツとコマースのドキュメントを参照してください。
技術的なプレビューにあるコンポーネントは、いつでも後方に互換性のない方法で変更される場合があります。これには、すべての無名、特に該当する場合はコンテンツ構造、API、マークアップ、スタイリングが含まれます。これらのコンポーネントを生産に使用しないでください。
AEM CIFコアコンポーネントの最新バージョンには、以下の最小システム要件が必要です。
| CIFコアコンポーネント | クラウドサービスとしてのAEM | AEM 6.5 | AEMコマースアドオン | アドビコマース | Java |
|---|---|---|---|---|---|
| 2.15.0 | 継続的 | 6.5.18 | V2022.08.02.00 | 2.4.2 EE | 11 |
以前のバージョンの要件のリストについては、履歴システムの要件を参照してください。
クラウドサービスの展開としてのAEMの場合、このプロジェクトでは、各AEMにクラウドサービス環境としてプロビジョニングされたCIFアドオンが必要です。 CIFアドオンが自動的にインストールされ、追加の展開は必要ありません。 CIFアドオンは、Software Distribution PortalのAEM SDKを使用したローカル開発にも利用できます。
AEM ONPREMのインストールの場合、このプロジェクトでは、AEM 6.5のAEM Commerceアドオンが必要です。製品ピッカー、製品資産ビュー、およびコネクタパッケージが提供する製品コンソールを活用することにより、オーサリングエクスペリエンスを改善します。 AEM 6.5のAEM Commerceアドオンは、ソフトウェア配布ポータルでも利用できます。個別にインストールする必要があります。
このプロジェクトは、AEMサイトのコアコンポーネントに依存しています。通常、AEMの一部としてインストールされます。サンプルコンテンツオプションなしでAEMをインストールする場合は、AEM CIFコアコンポーネントを使用する前に手動で展開する必要があります。
2.3.2から始めて、Adobe Commerceはキャッシュ可能なGraphQL要求をサポートし、バージョン0.2.1から始めるCIFコアコンポーネントはデフォルトでそれを使用します。コンポーネントをAdobe Commerce 2.3.1で動作させるには、次の場所でこの機能を手動で無効にすることができます。
mvn clean install実行して、アーティファクトをローカルMavenリポジトリにインストールします。allプロジェクトに切り替えて、 mvn clean install content-package:install 。セットアッププロセスの完全なビデオウォークスルーです。
すべてのモジュールを自分で構築し、最新の（まだ）未発表の変更をすべて取得する場合は、リポジトリのルートに次のコマンドを使用してすべてのモジュールを構築およびインストールするだけです。
mvn clean install -PautoInstallAll
これにより、デフォルトではすべてのlocalhost:4502にコンテキストパスなしにインストールされます。次のMavenプロパティでインストール場所を構成することもできます。
aem.hostインスタンスの名前aem.port ：AEMインスタンスのポート番号aem.contextPath ：AEMインスタンスのコンテキストパス（ /でない場合）このプロジェクトは、AEM 6.5.7 cq-quickstart Uberjarに依存しています。これはhttps://repo.adobe.comで公開されています
Uberjarの詳細については、Apache Mavenドキュメントページを使用してAEMプロジェクトを構築する方法にアクセスしてください。
AEM CIFコアコンポーネントのリリースバージョンは、Maven Central Repositoryで入手できます。 AEM CIFコアコンポーネントパッケージを独自のプロジェクトに含めるには、依存関係を追加できます
<dependency>
<groupId>com.adobe.commerce.cif</groupId>
<artifactId>core-cif-components-all</artifactId>
<type>zip</type>
<version>x.y.z</version>
</dependency>
およびサブパッケージセクション
<subPackage>
<groupId>com.adobe.commerce.cif</groupId>
<artifactId>core-cif-components-all</artifactId>
<filter>true</filter>
</subPackage>
content-package-maven-pluginに。
AEM CIFコアコンポーネントをAdobe Commerce環境またはサードパーティのCommerce Deploymentに接続するには、構成手順に従います。マルチストア /サイトのセットアップの場合、AEMサイトをAdobe Commerce Storeビュー構成にリンクするには、追加の手順が必要です。
CIFコアコンポーネントをカスタマイズするために、CIFコアコンポーネントをカスタマイズするためのドキュメントでユースケースと例を提供します。
コンポーネントのクライアント側JavaScriptコードは、Karmaで実行されたMochaユニットテストを使用してカバーされています。すべての貢献ごとに、新しいクライアント側のコードがテストでカバーされていること、およびすべてのテストが合格していることを確認してください。
cd ui.apps
npm install
npm testKarmaはChromeとFirefoxでテストします。両方のブラウザがインストールされていることを確認してください。
eclipse-formatter.xmlファイルでコードフォーマットルールを見つけることができます。コードフォーマットは、ビルドごとに自動的にチェックされます。コードを自動的にフォーマットするには、実行してください。
mvn clean install -Pformat-code JavaScriptとCSSのフォーマットには、よりきれいを使用します。 ui.appsプロジェクトでnpm testを実行すると、フォーマットが自動的にチェックされます。コードを自動的にフォーマットするには、 ui.appsで次のコマンドを実行してください。
npm run prettier:fixこのプロジェクトのリリースは、手動で実行されているmvn release:prepare release:cleanこのリポジトリのルートフォルダーのmasterブランチでクリーン。リリースと次のスナップショットバージョンを選択すると、これによりcore-cif-components-reactor-xyzなどのリリースGitタグとともに変更がコミットされます。コミットはGitリポジトリに自動的にプッシュされないため、変更を確認してから手動でプッシュする時間があることに注意してください。プッシュは、タグ付きアーティファクトの展開をMaven Centralに実行する専用のCircleCIビルドをトリガーします。
重要：このプロジェクトはMaven Reactorリリースを行い、サブモジュールからのリリースをトリガーしません！
注：APIの変更とセマンティックバージョンのためにJavaバンドルのバージョンを更新する必要がある場合は、親POMバージョンと親POMバージョンを参照するすべてのPOMを、親プロジェクトフォルダーで次のコマンドを実行することでmvn versions:set -DnewVersion=xyz-SNAPSHOT更新できます。これにより、すべてのプロジェクトが同じバージョンを持つことが保証されます。
貢献を歓迎します！詳細については、寄稿ガイドをお読みください。
このプロジェクトは、Apache V2ライセンスの下でライセンスされています。詳細については、ライセンスを参照してください。
