AEM CIF核心組件項目是使用AEM,CIF和Adobe Commerce開始的項目。該項目包含可重複使用的商務核心組件,這些組件將服務器端渲染的AEM組件與客戶端React商業組件(MPA)相結合,用於動態體驗 /數據。
該項目旨在與AEM站點核心組件一起使用。 AEM CIF核心組件在可能的情況下使用AEM站點核心組件作為基礎並擴展它們。
要啟動一個新項目,請查看我們的原型項目。還可以查看我們使用WCM和CIF核心組件的Venia樣本項目,以提供令人驚嘆的商店前體驗。
有關AEM CIF核心組件的使用和配置說明以及AEM組件開發的簡介,請參見AEM內容和商業文檔。
技術預覽中的組件可能隨時以無向後兼容的方式變化。這包括所有劇本,尤其是內容結構,API,標記和样式(如果適用)。不要在生產中使用這些組件。
AEM CIF核心組件的最新版本需要低於最低系統要求:
| CIF核心組件 | AEM作為雲服務 | AEM 6.5 | AEM商業附加組件 | Adobe Commerce | 爪哇 |
|---|---|---|---|---|---|
| 2.15.0 | 連續 | 6.5.18 | V2022.08.02.00 | 2.4.2 EE | 11 |
有關以前版本的要求列表,請參見歷史系統要求。
對於AEM作為雲服務部署,本項目需要在每個AEM上作為雲服務環境的CIF附加組件。 CIF附加組件是自動安裝的,不需要額外的部署。 CIF附加組件也可用於本地開發,其中來自軟件分銷門戶的AEM SDK。
對於AEM本地安裝,該項目需要AEM Commerce Add-on for AEM 6.5來通過利用產品選擇器,產品資產視圖和連接器包提供的產品控制台來改善創作體驗。 AEM Commerce Add-on for AEM 6.5也可以在軟件分發門戶網站上使用。必須單獨安裝。
該項目依賴於AEM站點的核心組件。它們通常作為AEM的一部分安裝。如果您沒有示例內容選項安裝AEM,則必須在使用AEM CIF核心組件之前手動部署它們。
從2.3.2開始,Adobe Commerce支持可緩存的GraphQl請求,並以0.2.1版本的CIF Core組件默認使用它。為了使組件與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存儲庫中獲得。要將AEM CIF核心組件軟件包包括在您自己的項目Maven構建中,您可以添加依賴關係
<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環境或第三方商業部署聯繫起來,請遵循配置步驟。對於多商店 /站點設置,需要其他步驟將AEM站點鏈接到Adobe Commerce Store View配置。
為了自定義CIF核心組件,我們在文檔中提供了用例和示例,可以自定義CIF Core組件。
組件的客戶端JavaScript代碼使用用業力執行的Mocha單元測試涵蓋。請確保有關每項貢獻的新客戶端代碼都涵蓋了測試,並且所有測試通過。
cd ui.apps
npm install
npm test業力將使用Chrome和Firefox進行測試。確保已安裝兩個瀏覽器。
您可以在eclipse-formatter.xml文件中找到代碼格式規則。對於每個構建,自動檢查代碼格式。要自動格式化您的代碼,請運行:
mvn clean install -Pformat-code對於格式化JavaScript和CSS,我們使用更漂亮。在ui.apps項目中運行npm test時,將自動檢查格式。要自動格式化代碼,請在ui.apps中運行以下命令:
npm run prettier:fix該項目的發行版是通過手動運行MVN版本觸發的:準備發行版:在此存儲庫的根文件夾的master分支上mvn release:prepare release:clean 。選擇發行版和下一個快照版本後,這將提交更改,以及一個發行版git標籤,例如core-cif-components-reactor-xyz 。請注意,這些提交不會自動將其推向GIT存儲庫,因此您有一些時間檢查更改然後手動推動它們。然後推動觸發了一個專用的CircleCI構建,該構建執行了標記的工件部署到Maven Central。
重要的是:該項目確實會發行Maven反應堆,不要觸發子模塊的發行版!
注意:如果需要由於API的更改和語義版本來更新Java捆綁包的版本,則可以通過在Parent Project文件夾中運行以下命令來輕鬆更新Parent POM版本,並且所有POM都引用了Parent POM版本: mvn versions:set -DnewVersion=xyz-SNAPSHOT 。這將確保所有項目具有相同的版本。
歡迎捐款!閱讀貢獻指南以獲取更多信息。
該項目是根據Apache V2許可證獲得許可的。有關更多信息,請參見許可證。