開發AEM Commerce develop
根據Commerce integration framework(CIF)為AEM開發AEM Commerce專案會遵循與其他AEM專案相同的規則和最佳實務。 請先檢閱下列內容:
AEM Commerce的本機開發 local
建議使用本機開發環境搭配CIF專案使用。
適用於AEM 6.5 aka的AEM Commerce附加元件。 CIF附加元件也可用於本機開發,並以AEM套件的形式提供。 可以從軟體發佈入口網站下載它作為Feature Pack。
必要的軟體
下列專案應在本機安裝:
- 本機AEM 6.5
- AEM 6.5 Service Pack 7或更新版本
- Java 11
- Apache Maven (3.3.9 或更新版本)
- 節點LTS
- npm 6+
- Git
存取CIF附加元件
可以從軟體發佈入口網站下載CIF附加元件,搜尋「AEM Commerce附加元件」。
本機設定
對於使用CIF和AEM附加元件的本機CIF專案開發,請執行以下步驟:
-
取得AEM 6.5版本並安裝AEM 6.5 Service Pack。 需要AEM 6.5 Service Pack 7,但Adobe建議安裝最後一個可用的Service Pack。
-
解壓縮AEM .jar以建立
crx-quickstart
資料夾,請執行:code language-bash java -jar <jar name> -unpack
-
建立
crx-quickstart/install
資料夾 -
將從軟體發佈入口網站下載的CIF附加元件所有套件複製到
crx-quickstart/install
資料夾。
- 啟動AEM快速入門
透過OSGI主控台驗證安裝: http://localhost:4502/system/console/osgi-installer
。 此清單應包含與CIF附加元件相關的組合、內容套件和OSGI設定。 請確定所有套件組合都已啟動。
專案設定 project
有兩種方式可使用CIF啟動AEM Commerce專案。
使用AEM專案原型
AEM專案原型是啟動預先設定的專案以開始使用CIF的主要工具。 CIF核心元件和所有的必要設定都可以包含在產生的專案中,並有一個額外的選項。
請參閱AEM專案原型使用指示,瞭解如何產生AEM專案。 若要將CIF納入專案中,請使用includeCommerce
選項。
例如:
mvn -B archetype:generate \
-D archetypeGroupId=com.adobe.granite.archetypes \
-D archetypeArtifactId=aem-project-archetype \
-D aemVersion=6.5.5 \
-D appTitle="My Site" \
-D appId="mysite" \
-D groupId="com.mysite" \
-D frontendModule=general \
-D includeExamples=n \
-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 Reference Store,只要複製Git存放庫並開始根據您的需求自訂專案即可。
classic
設定檔。將AEM連線至Commerce系統
若要將您的專案連線到商務系統,AEM必須設定為您的商務系統的GraphQL端點。
由AEM Project Archetype或AEM Venia參考存放區產生的專案都已包含必須調整的預設設定。
將com.adobe.cq.commerce.graphql.client.impl.GraphqlClientImpl~default.cfg.json
中url
的值取代為專案所使用的商務系統的GraphQL端點。
AEM Commerce附加元件和CIF核心元件會透過AEM伺服器和直接透過瀏覽器,連線至商務GraphQL端點。 使用者端CIF核心元件和CIF附加撰寫工具預設會連線至/api/graphql
。 如有需要,可透過CIFCloud Service設定(請參閱下文)調整此設定。
CIF附加元件提供位於/api/graphql
的GraphQL Proxy servlet。 如果您不打算使用本機AEM Dispatcher,建議一併設定GraphQL Proxy servlet。
導覽至http://localhost:4502/system/console/configMgr並建立Adobe CIF GraphQL Proxy Configuration
服務的OSGI設定。 使用與上述用於GraphQL使用者端相同的商務系統GraphQL端點。