為AEM as a Cloud Service開發AEM Commerce :headding-anchor:develop
根據AEM as a Cloud Service的Commerce integration framework(CIF)開發AEM Commerce專案,會遵循與AEM as a Cloud Service上的其他AEM專案相同的規則和最佳實務。 請先檢閱下列內容:
使用AEM as a Cloud Service SDK進行本機開發 :headding-anchor:local
建議使用本機開發環境搭配CIF專案使用。 為AEM as a Cloud Service提供的CIF附加元件也可用於本機開發。 可從軟體發佈入口網站下載。
CIF附加元件以Sling功能封存的形式提供。 軟體發佈入口網站上的zip檔案包含兩個Sling功能封存檔案,一個用於AEM作者,另一個用於AEM發佈執行個體。
AEM as a Cloud Service 的新手嗎? 檢視使用AEM as a Cloud Service SDK設定本機開發環境的詳細指南。
必要的軟體
下列專案應在本機安裝:
- AEM as a Cloud Service SDK
- Java™ 11
- Apache Maven (3.3.9 或更新版本)
- Node.js v10+
- npm 6+
- Git
存取CIF附加元件
可以從軟體發佈入口網站下載CIF附加元件的ZIP檔案。 Zip檔案包含CIF附加元件做為 Sling功能封存,它不是AEM套件。 可使用AEM as a Cloud Service授權存取SDK清單。
本機設定
對於使用AEM as a Cloud Service SDK的本機CIF附加元件開發,請執行以下步驟:
-
取得最新的AEM as a Cloud Service SDK
-
解壓縮AEM .jar,以便建立
crx-quickstart
資料夾,請執行:code language-bash java -jar <jar name> -unpack
-
建立
crx-quickstart/install
資料夾 -
將CIF附加元件的正確Sling功能封存檔案複製到
crx-quickstart/install
資料夾。CIF附加元件zip檔案包含兩個Sling功能封存
.far
檔案。 請務必針對AEM Author或AEM Publish使用正確的套裝,端視您計畫執行本機AEM as a Cloud Service SDK的方式而定。 -
建立名為
COMMERCE_ENDPOINT
的本機OS環境變數,其中包含Adobe Commerce GraphQL端點。macOS X範例:
code language-bash export COMMERCE_ENDPOINT=https://<yourcommercesystem>/graphql
範例Windows:
code language-bash set COMMERCE_ENDPOINT=https://<yourcommercesystem>/graphql
AEM使用此變數來連線至您的商務系統。 此外,CIF附加元件包含本機反向Proxy,可讓Commerce GraphQL端點在本機可用。 此Proxy由CIF編寫工具(產品主控台和選擇器)使用,並用於執行直接GraphQL呼叫的CIF使用者端元件。
此外,亦必須針對AEM as a Cloud Service環境設定此變數。 如需變數的詳細資訊,請參閱為AEM as a Cloud Service設定OSGi。
-
(選用)若要啟用分階段目錄功能,您必須為Adobe Commerce執行個體建立整合權杖。 請依照快速入門中的步驟來建立權杖。
將名稱為
COMMERCE_AUTH_HEADER
的OSGi密碼設定為下列值:code language-xml Authorization: Bearer <Access Token>
如需秘密的詳細資訊,請參閱為AEM as a Cloud Service設定OSGi。
-
啟動AEM as a Cloud Service SDK
透過OSGI主控台驗證安裝: http://localhost:4502/system/console/osgi-installer
。 此清單應包含功能模型檔案中定義的CIF附加元件相關組合、內容套件和OSGI設定。
專案設定 :headding-anchor:project
針對AEM as a Cloud ServiceBootstrapCIF專案有兩種方式。
使用AEM專案原型
AEM專案原型是Bootstrap預先設定的專案以開始使用CIF的主要工具。 CIF核心元件和所有的必要設定都可包含在產生專案中,並提供一個額外選項。
請參閱AEM專案原型使用指示,瞭解如何產生AEM專案。 若要將CIF納入專案中,請使用includeCommerce
選項。
例如:
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
CIF核心元件可透過包含提供的all
套件或單獨使用CIF內容套件和相關OSGI套件組合來用於任何專案。 若要手動將CIF核心元件新增至專案,請使用下列相依性:
<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>
使用AEM Venia Reference Store
啟動CIF專案的第二個選項是複製並使用AEM Venia參考存放區。 AEM Venia Reference Store是範例參考店面應用程式,可示範AEM的CIF核心元件的使用情形。 其目的是作為一組最佳實務範例,以及開發您自己的功能的潛在起點。
若要開始使用Venia參考存放區,請複製Git存放庫,並開始根據您的需求自訂專案。