SAP Commerce Cloud 如何为 Storefront 配置新的应用

Posted 2022-05-16 JerryWang汪子熙

打开 saample 仓库里 manifest.json 文件，地址如下：

​​https://github.com/SAP-samples/cloud-commerce-sample-setup/blob/2105-spartacus/js-storefront/manifest.json​​

在 Application 数组里添加新的元素：

将清单文件中声明的新应用程序的文件添加到代码存储库。

• 如果使用源代码方式开发 Spartacus，则将 package.json 文件添加到​​<application.path>/package.json​​。

例如，​​<repository-root>/js-storefront/some-subdirectory/app2/package.json​​

• 如果您使用的是预构建的应用程序，则将已编译的应用程序文件（包括 index.html）添加到​​<application.path>/dist/<application.name>​​。

例如，​​<repository-root>/js-storefront/some-subdirectory/app2/dist/app2/index.html​​。

每个应用程序的 index.html 文件必须包含以下占位符：

<meta name="occ-backend-base-url" content="OCC_BACKEND_BASE_URL_VALUE" />

在应用程序启动时，此占位符将替换为真正的 API aspect 里定义的外部 URL。

为了使上述配置生效，需要创建一个 build.

构建过程会自动构建 Commerce Cloud 代码存储库中提供的所有 javascript 应用程序。

对于 manifest.json 中定义的每个应用程序，构建过程会检查 ​​<application.path>/dist​​​ 目录是否存在。 如果它不存在，则构建过程在 ​​<application.path>​​ 目录中运行以下命令：

• yarn install - 下载 package.json 中声明的依赖项，
• yarn build - 运行 package.json 中声明的构建命令。

yarn build 对应下图的命令：

"build": "env-cmd --no-override -e dev,b2c,$SPA_ENV ng build storefrontapp --configuration production"

如果 ​​<application.path>/dist​​ 确实存在，则构建过程假定此目录包含已构建的 JavaScript 店面并跳过构建。

Commerce Cloud addon 旨在将自定义代码排除在店面扩展之外并缓解可升级性问题。 思路就是您在 addon 中执行自定义内容，以便您可以获取更新版本的店面并重新应用相同的 addon（在升级期间）。

实际上，addon 机制是一种文件复制机制，并且非常依赖于 yacceleratorstorefront 中的文件结构。 随着标准店面随着时间的推移而变化，addon 可能需要随之改变。

Spartacus 不支持在单个店面应用程序中同时运行 B2C 和 B2B 店面。 如果安装了 ​​Organization - Adminstration​​​ 或者 ​​Organization - Order Approval,​​，B2C 店面将加载，但无法正常工作。

如果选择了适用于 B2B 店面的功能，则原理图会自动添加任何所需的 B2B 配置（如果缺少它们）。