開發AEM Commerce for AEM as aCloud Service

根據AEM Integration Framework(CIF)開發AEM as aCloud Service的AEM商務專案,會遵循與上其他AEM專案相同的規則和最佳實務,如同Cloud Service。 請先查看以下內容:

以AEM作為Cloud ServiceSDK的本機開發

若要與CIF專案搭配使用,建議使用當地開發環境。 為AEM as aCloud Service提供的CIF附加元件也適用於當地開發環境。 可從軟體分發門戶下載。

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

AEM as a Cloud Service 的新手嗎? 請參 閱更詳細的指南,以使用AEM作為Cloud ServiceSDK來設定本機開發環境

所需軟體

應在本機安裝下列項目:

存取CIF附加元件

CIF附加元件可從軟體發佈入口網站下載為zip檔案。 zip檔案包含CIF附加元件,作為​Sling Feature archive,但不是AEM套件。 請注意,存取SDK清單的權限僅限於具有AEM作為Cloud Service授權的用戶。

秘訣

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

本機設定

使用AEM作為Cloud ServiceSDK的本機CIF附加元件開發,請執行下列步驟:

  1. 取得最新的AEM as aCloud ServiceSDK

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

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

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

    CIF附加元件zip檔案包含兩個Sling功能封存.far檔案。 根據您打算如何以Cloud ServiceSDK執行本機AEM,請務必為AEM製作或AEM發佈使用正確的AEM製作。

  5. 建立一個名為COMMERCE_ENDPOINT的本地OS環境變數,該變數保留MagentoGraphQL端點。

    範例Mac OS:

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

    示例窗口:

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

    此變數供AEM用來連線至您的商務系統。 此外,CIF附加元件包含本機反向代理,讓Commerce GraphQL端點可在本機使用。 CIF製作工具(產品主控台和選擇器)及執行直接GraphQL呼叫的CIF用戶端元件都會使用此功能。

    您也必須為AEM設定此變數作為Cloud Service環境。 如需變數的詳細資訊,請參閱為AEM as aCloud Service設定OSGi

  6. (選用)若要啟用分段目錄功能,您必須為Magento例項建立整合代號。 請依照快速入門中的步驟建立代號。

    將名稱為COMMERCE_AUTH_HEADER的OSGi密碼設定為以下值:

    Authorization: Bearer <Access Token>
    

    有關機密的詳細資訊,請參閱為AEM as aCloud Service配置OSGi

  7. 將AEM啟動為Cloud ServiceSDK

注意

請務必在步驟5中設定環境變數的相同終端機視窗中,將AEM作為Cloud ServiceSDK啟動。 如果您在個別的終端機視窗中啟動,或連按兩下.jar檔案,請確定環境變數可見。

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

專案設定

有兩種方式可引導您的CIF專案,以AEM作為Cloud Service。

使用AEM專案原型

AEM專案原型是引導預先設定專案以開始使用CIF的主要工具。 CIF核心元件和所有必要設定皆可納入產生的專案中,並提供額外選項。

秘訣

使用AEM專案原型24或更新版本來產生專案。

請參閱AEM專案原型使用指示,了解如何產生AEM專案。 若要將CIF納入專案,請使用includeCommerce選項。

例如:

mvn -B archetype:generate \
 -D archetypeGroupId=com.adobe.granite.archetypes \
 -D archetypeArtifactId=aem-project-archetype \
 -D archetypeVersion=24 \
 -D aemVersion=cloud \
 -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 Reference Store。 AEM Venia Reference Store是範例參考店面應用程式,示範AEM的CIF核心元件使用方式。 這是一組最佳實務範例,也是開發您自己功能的潛在起點。

若要開始使用Venia Reference Store,只需複製Git存放庫,然後根據您的需求開始自訂專案即可。

注意

Venia Reference Store專案包含AEM作為Cloud Service和AEM 6.5的兩個建置設定檔。請查看專案readme.md以了解其使用方式。

其他資源

本頁內容