基于Commerce Integration Framework (CIF)为AEMas a Cloud Service开发AEM Commerce项目也遵循与AEMas a Cloud Service上的其他AEM项目相同的规则和最佳实践。 请先查看以下内容:
建议使用本地开发环境来处理CIF项目。 为AEMas a Cloud Service提供的CIF加载项也可用于本地开发。 可从以下网址下载: 软件分发门户.
CIF加载项作为Sling功能存档提供。 软件分发门户上提供的zip文件包括两个Sling功能存档文件,一个用于AEM创作,一个用于AEM发布实例。
不熟悉AEMas a Cloud Service? 签出 有关使用AEMas a Cloud ServiceSDK设置本地开发环境的更详细指南.
以下内容应安装在本地:
CIF加载项可以从 软件分发门户. zip文件包含CIF加载项,如 Sling功能存档,它不是AEM包。 请注意,对SDK列表的访问仅限于具有AEMas a Cloud Service许可证的用户。
确保始终使用最新的CIF加载项版本。
对于使用AEMas a Cloud ServiceSDK进行本地CIF加载项开发,请执行以下步骤:
获取最新的AEMas a Cloud ServiceSDK
解压缩AEM .jar以创建 crx-quickstart
文件夹,运行:
java -jar <jar name> -unpack
创建 crx-quickstart/install
文件夹
将CIF加载项的正确Sling功能存档文件复制到 crx-quickstart/install
文件夹。
CIF加载项zip文件包含两个Sling功能存档 .far
文件。 确保为AEM创作或AEM发布使用正确的编辑器,具体取决于您计划如何运行本地AEMas a Cloud ServiceSDK。
创建名为的本地操作系统环境变量 COMMERCE_ENDPOINT
持有Adobe Commerce GraphQL端点。
示例Mac OSX:
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.
(可选)要启用暂存目录功能,必须为Adobe Commerce实例创建集成令牌。 请按照 快速入门 以创建令牌。
使用名称设置OSGi密码 COMMERCE_AUTH_HEADER
到以下值:
Authorization: Bearer <Access Token>
有关密码的详细信息,请参阅 为AEMas a Cloud Service配置OSGi.
启动AEMas a Cloud ServiceSDK
确保在步骤5中设置的同一终端窗口中启动AEMas a Cloud ServiceSDK。 如果在单独的终端窗口中或通过双击.jar文件启动它,请确保环境变量可见。
通过OSGI控制台验证设置: http://localhost:4502/system/console/osgi-installer
. 该列表应包括功能模型文件中定义的CIF附加组件相关包、内容包和OSGI配置。
有两种方法可以为AEMas a Cloud Service引导CIF项目。
此 AEM项目原型 是引导预配置项目以开始使用CIF的主要工具。 CIF核心组件和所有必需的配置都可以通过一个附加选项包含在生成的项目中。
始终使用最新版本的 AEM项目原型 以生成项目。
请参阅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>
启动CIF项目的第二个选项是克隆并使用 AEM Venia引用存储. AEM Venia Reference Store是一个示例引用店面应用程序,用于演示如何将CIF核心组件用于AEM。 它旨在作为一组最佳实践示例以及开发您自己的功能的潜在起点。
要开始使用Venia引用存储,只需克隆Git存储库并开始根据您的需求自定义项目即可。
Venia Reference Store项目包含AEMas a Cloud Service和AEM 6.5的两个生成配置文件。查看 项目readme.md 了解它们的使用方式。