開發適用於AEMas a Cloud Service的AEM Commerce

以AEMas a Cloud Service的Commerce Integration Framework (CIF)為基礎開發AEM Commerce專案，會遵循與AEMas a Cloud Service上的其他AEM專案相同的規則和最佳實務。 請先檢閱下列內容：

• AEM 專案結構
• AEM as a Cloud Service SDK
• AEM as a Cloud Service 開發方針

使用AEMas a Cloud ServiceSDK進行本機開發

建議使用本機開發環境搭配CIF專案使用。 為AEMas a Cloud Service提供的CIF附加元件也可用於本機開發。 您可從以下網址下載： 軟體發佈入口網站.

CIF附加元件是以Sling功能封存的形式提供。 軟體發佈入口網站上的zip檔案包含兩個Sling功能封存檔案，一個用於AEM作者，一個用於AEM發佈執行個體。

AEM as a Cloud Service 的新手嗎？ 簽出 有關使用AEMas a Cloud ServiceSDK設定本機開發環境的更詳細指南.

必要軟體

下列專案應在本機安裝：

• 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套件。 可使用AEMas a Cloud Service授權存取SDK清單。

本機設定

對於使用AEMas a Cloud ServiceSDK的本機CIF附加元件開發，請執行以下步驟：

1. 取得最新的AEMas a Cloud ServiceSDK

2. 解壓縮AEM .jar，以便建立 crx-quickstart 資料夾，執行：

   java -jar <jar name> -unpack
   

3. 建立 crx-quickstart/install 資料夾

4. 將CIF附加元件的正確Sling功能封存檔案複製到 crx-quickstart/install 資料夾。

   CIF附加元件zip檔案包含兩個Sling功能封存 .far 檔案。 請務必根據您計畫執行本機AEMas a Cloud ServiceSDK的方式，對AEM Author或AEM Publish使用正確的套裝。

5. 建立本機作業系統環境變數，命名為 COMMERCE_ENDPOINT 保留Adobe Commerce GraphQL端點。

   macOS X範例：

   export COMMERCE_ENDPOINT=https://<yourcommercesystem>/graphql
   

   範例Windows：

   set COMMERCE_ENDPOINT=https://<yourcommercesystem>/graphql
   

   AEM使用此變數來連線至您的商務系統。 此外，CIF附加元件也包含本機反向Proxy，讓Commerce GraphQL端點可在本機使用。 此Proxy由CIF製作工具（產品主控台和選擇器）使用，並用於執行直接GraphQL呼叫的CIF使用者端元件。

   此外，此變數必須針對AEMas a Cloud Service環境進行設定。 如需變數的詳細資訊，請參閱 為AEMas a Cloud Service設定OSGi.

6. （選用）若要啟用分階段目錄功能，您必須為Adobe Commerce執行個體建立整合權杖。 請依照下列步驟操作： 快速入門 以建立Token。

   以名稱設定OSGi密碼 COMMERCE_AUTH_HEADER 變更為下列值：

   Authorization: Bearer <Access Token>
   

   如需秘密的詳細資訊，請參閱 為AEMas a Cloud Service設定OSGi.

7. 啟動AEMas a Cloud ServiceSDK

透過OSGI主控台驗證設定： http://localhost:4502/system/console/osgi-installer. 此清單應包含功能模型檔案中定義的CIF附加元件相關組合、內容套件和OSGI設定。

專案設定

有兩種方法可BootstrapAEMas a Cloud Service的CIF專案。

使用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參考存放區

啟動CIF專案的第二個選項是複製並使用 AEM Venia參考存放區. AEM Venia Reference Store是範例參考店面應用程式，可示範AEM的CIF核心元件的使用方式。 其目的是作為一組最佳實務範例，以及開發您自己的功能的潛在起點。

若要開始使用Venia參考存放區，請複製Git存放庫，並開始根據您的需求自訂專案。

其他資源

• AEM 專案原型
• AEM Venia參考存放區
• 軟體發佈入口網站