开发AEM Commerce develop

根据适用于AEM的Commerce integration framework(CIF)开发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包提供。 可以从软件分发门户下载它作为功能包。

所需的软件

下列内容应本地安装:

访问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是一个示例参考店面应用程序,用于演示如何将CIF核心组件用于AEM。 它旨在作为一组最佳实践示例以及开发您自己的功能的潜在起点。

要开始使用Venia引用存储,只需克隆Git存储库并开始根据需要自定义项目。

NOTE
Venia Reference Store项目包含AEM as a Cloud Service和AEM 6.5的两个生成配置文件。查看项目readme.md以了解它们的使用方式。 对于AEM 6.5,使用classic配置文件。

将AEM连接到Commerce系统

要将您的项目连接到Commerce System,必须使用Commerce System的GraphQL端点配置AEM。

AEM项目原型AEM 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代理servlet。 如果您不打算使用本地AEM Dispatcher,则建议同时配置GraphQL代理servlet。

导航到http://localhost:4502/system/console/configMgr并为Adobe CIF GraphQL Proxy Configuration服务创建OSGI配置。 使用与上述用于GraphQL客户端的相同的GraphQL商务系统端点。

其他资源

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