開發AEM Commerce develop

根據Commerce integration framework(CIF)為AEM開發AEM Commerce專案會遵循與其他AEM專案相同的規則和最佳實務。 請先檢閱下列內容:

AEM Commerce的本機開發 local

建議使用本機開發環境搭配CIF專案使用。

NOTE
下列指示可協助您使用適用於AEM 6.5的CIF,為AEM Commerce設定本機AEM開發環境)。 如果您使用AEM as a Cloud Service,請參閱AEM Commerceas a Cloud Service檔案。

適用於AEM 6.5 aka的AEM Commerce附加元件。 CIF附加元件也可用於本機開發,並以AEM套件的形式提供。 可以從軟體發佈入口網站下載它作為Feature Pack。

必要的軟體

下列專案應在本機安裝:

存取CIF附加元件

可以從軟體發佈入口網站下載CIF附加元件,搜尋「AEM Commerce附加元件」。

TIP
請務必使用最新的CIF附加元件版本。

本機設定

對於使用CIF和AEM附加元件的本機CIF專案開發,請執行以下步驟:

  1. 取得AEM 6.5版本並安裝AEM 6.5 Service Pack。 需要AEM 6.5 Service Pack 7,但Adobe建議安裝最後一個可用的Service Pack。

  2. 解壓縮AEM .jar以建立crx-quickstart資料夾,請執行:

    code language-bash
    java -jar <jar name> -unpack
    
  3. 建立crx-quickstart/install資料夾

  4. 將從軟體發佈入口網站下載的CIF附加元件所有套件複製到crx-quickstart/install資料夾。

TIP
或者,也可以透過「封裝管理員」安裝CIF附加元件套件。
  1. 啟動AEM快速入門

透過OSGI主控台驗證安裝: http://localhost:4502/system/console/osgi-installer。 此清單應包含與CIF附加元件相關的組合、內容套件和OSGI設定。 請確定所有套件組合都已啟動。

專案設定 project

有兩種方式可使用CIF啟動AEM Commerce專案。

使用AEM專案原型

AEM專案原型是啟動預先設定的專案以開始使用CIF的主要工具。 CIF核心元件和所有的必要設定都可以包含在產生的專案中,並有一個額外的選項。

TIP
使用AEM Project Archetype 25或更新版本來產生專案。

請參閱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存放庫並開始根據您的需求自訂專案即可。

NOTE
Venia Reference Store專案包含AEM as a Cloud Service和AEM 6.5的兩個組建設定檔。請檢查專案readme.md,瞭解其使用方式。 對於AEM 6.5,請使用classic設定檔。

將AEM連線至Commerce系統

若要將您的專案連線到商務系統,AEM必須設定為您的商務系統的GraphQL端點。

AEM Project ArchetypeAEM Venia參考存放區產生的專案都已包含必須調整的預設設定

com.adobe.cq.commerce.graphql.client.impl.GraphqlClientImpl~default.cfg.jsonurl的值取代為專案所使用的商務系統的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端點。

其他資源

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2