开发AEM Commerce develop
根据适用于AEM的Commerce integration framework(CIF)开发AEM Commerce项目时,遵循与其他AEM项目相同的规则和最佳实践。 请先查看以下内容:
AEM Commerce的本地开发 local
建议使用本地开发环境来处理CIF项目。
适用于AEM 6.5 aka的AEM Commerce加载项。 CIF加载项也可用于本地开发,并作为AEM包提供。 可以从软件分发门户下载它作为功能包。
所需的软件
下列内容应本地安装:
- 本地AEM 6.5
- AEM 6.5 Service Pack 7或更高版本
- Java 11
- Apache Maven (3.3.9或更高版本)
- 节点LTS
- npm 6+
- Git
访问CIF加载项
CIF加载项可从软件分发门户下载,请搜索“AEM Commerce加载项”。
本地设置
对于使用CIF和AEM加载项进行本地CIF项目开发,请执行以下步骤:
-
获取AEM 6.5版本并安装AEM 6.5 Service Pack。 需要AEM 6.5 Service Pack 7,但Adobe建议安装最后一个可用的Service Pack。
-
解压缩AEM .jar以创建
crx-quickstart
文件夹,运行:code language-bash java -jar <jar name> -unpack
-
创建
crx-quickstart/install
文件夹 -
将从软件分发门户下载的CIF附加组件所有包复制到
crx-quickstart/install
文件夹中。
- 启动AEM快速入门
通过OSGI控制台验证设置: http://localhost:4502/system/console/osgi-installer
。 该列表应包含与CIF附加组件相关的包、内容包和OSGI配置。 确保所有捆绑包都已启动。
项目设置 project
有两种方法可使用CIF启动AEM Commerce项目。
使用AEM项目原型
AEM项目原型是引导预配置项目以开始使用CIF的主要工具。 CIF核心组件和所有必需的配置都可以在生成的项目中包含一个额外选项。
有关如何生成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存储库并开始根据需要自定义项目。
classic
配置文件。将AEM连接到Commerce系统
要将您的项目连接到Commerce System,必须使用Commerce System的GraphQL端点配置AEM。
由AEM项目原型或AEM Venia引用存储生成的项目已包含必须调整的默认配置。
将com.adobe.cq.commerce.graphql.client.impl.GraphqlClientImpl~default.cfg.json
中url
的值替换为项目使用的商务系统的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商务系统端点。