开发AEM Commerce for AEMas a Cloud Service

开发AEM Commerce项目(基于Commerce Integration Framework (CIF) for AEMas a Cloud Service)时，遵循与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发布实例。

不熟悉AEMas 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文件包含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 文件。 确保为AEM创作或AEM发布使用正确的编辑器，具体取决于您计划如何运行本地AEMas a Cloud ServiceSDK。

5. 创建名为的本地操作系统环境变量 COMMERCE_ENDPOINT 持有Adobe Commerce GraphQL端点。

   macOS X示例：

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

   示例窗口：

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

   AEM使用此变量连接到您的商务系统。 此外，CIF加载项还包括一个本地反向代理，以使Commerce GraphQL端点可在本地使用。 此代理由CIF创作工具（产品控制台和选取器）和用于执行直接GraphQL调用的CIF客户端组件使用。

   此外，还必须为AEMas a Cloud Service环境设置此变量。 有关变量的更多信息，请参阅 为AEMas a Cloud Service配置OSGi.

6. （可选）要启用暂存目录功能，必须为Adobe Commerce实例创建集成令牌。 按照中的步骤操作 快速入门 以创建令牌。

   使用名称设置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 Reference Store

启动CIF项目的第二个选项是克隆并使用 AEM Venia引用存储. AEM Venia Reference Store是一个示例引用店面应用程序，用于演示如何将CIF核心组件用于AEM。 它旨在作为一组最佳实践示例以及开发您自己的功能的潜在起点。

要开始使用Venia引用存储，请克隆Git存储库并开始根据您的需求自定义项目。

其他资源

• AEM 项目原型
• AEM Venia引用存储
• 软件分发门户