斯巴达克斯和可组合店面

您好，欢迎光临！

本自述文件是develop分支的一部分，该分支是 Spartacus 存储库中活跃的开发分支。因此，以下文本可能包含对正在进行中且尚未正式发布的工作的引用。

从版本 2211.19 开始，可组合店面已将其版本控制与 SAP Commerce Cloud 保持一致。可组合店面的上一个版本是版本 6.8。有关更多信息，请参阅从 2024 年 2 月开始对可组合店面的版本编号和更新策略进行的更改。

从版本 5.0 开始，“SAP Commerce Cloud，可组合店面”是 SAP 发布的项目“Spartacus”库的正式版本的名称。 SAP Commerce Cloud 客户可以使用官方支持的可组合店面。 SAP 帮助门户上提供了文档。

可组合店面基于 Spartacus 开源代码，并且包含在 SAP Commerce Cloud 许可证中，无需额外付费。可组合店面具有前滚更新策略。

本地客户可能仍然使用 Spartacus 开源。有关更多信息，请参阅使用开源代码自行发布斯巴达克斯库。

斯巴达克斯是什么？

Spartacus 是一个适用于 SAP Commerce Cloud 的精简、基于 Angular 的 JavaScript 店面。 Spartacus 仅通过 Commerce REST API 与 SAP Commerce Cloud 进行对话。

SAP 帮助门户上提供了文档。
在我们的公共演示网站上试用示例斯巴达克斯店面。
技术问题？在 Stack Overflow 上与我们联系。
非技术问题？加入我们的 Slack 工作区。
有关 4.0 发布的详细信息，请参阅 SAP Help Portal 上的发布信息页面。

斯巴达克斯是...

可扩展：斯巴达克斯被设计为可升级，同时保持完全的可扩展性。您将能够通过更新我们定期增强的 Spartacus 库来采用新版本的 Spartacus。（为了确保第一个版本能够像我们希望的那样可扩展和升级，在 1.0 发布之前很可能会引入重大更改。）
可升级：Spartacus 代码作为库发布和使用，并遵循语义版本控制约定。通过使用这些库，Spartacus 可升级为次要版本和补丁版本。
渐进式：Spartacus 正在努力完全符合渐进式 Web 应用程序 (PWA) 清单。我们的目标是增加对支持 PWA 的店面的所有主要功能的支持，以提供最佳的客户体验，无论设备或位置如何。
开源：斯巴达克斯是开源的。它将由 SAP Commerce Cloud 团队不断开发，但我们非常欢迎贡献者，并为 Spartacus 培养一个包容、活跃的开发社区。请参阅我们的贡献文档以获取更多信息。
现代：Spartacus 店面是我们为 SAP Commerce Cloud 安装提供可定制但可升级技术的激动人心的新旅程的一部分。有关 SAP Commerce Cloud 的更多信息，请参阅 SAP 客户体验。

店面特色

斯巴达克斯提供核心店面功能，例如：

主页
搜索
类别
产品详情
购物车页面
添加到购物车
查看
订单历史

有关详细信息，请参阅 SAP 帮助门户上的版本文档。

要求

如果您使用 Spartacus 2211，请参阅 SAP Help Portal 上的 2211 Angular 开发环境要求。

如果您使用的是 Spartacus 6.x，请参阅 SAP Help Portal 上的相关 6.x Angular 开发环境要求。

如果您使用 Spartacus 5.x，请参阅 SAP Help Portal 上的相关 5.x Angular 开发环境要求。

有关后端要求，请参阅可组合店面兼容性矩阵。

如果您使用 Spartacus 4.x，您的 Angular 开发环境应包括以下内容：

Angular CLI： 12.0或更高版本，< 13。
纱线：v1.15 或更高版本
node.js：需要14.15版本。版本 12.x 已于 2022 年 4 月 30 日终止生命，并且 Spartacus 不再支持。强烈建议您尽快将所有现有的 Spartacus 店面迁移到 Node.js 14。如果 Spartacus 和 Node.js 14 存在任何问题，请升级到最新版本。如果您在使用 Node.js 14 时仍然遇到问题，请向 SAP 创建支持票证。 Spartacus 还支持 Node.js 版本 16.x，但公共云构建器中的 Commerce Cloud 尚不支持该版本。

如果您使用 Spartacus 3.x，您的 Angular 开发环境应包括以下内容：

Angular CLI： 10.1或更高版本，< 11。
node.js：12.16.1 或更高版本，< 13.0。建议使用最新的 12.x 版本。
纱线：v1.15 或更高版本

如果您使用 Spartacus 2.x，您的 Angular 开发环境应包括以下内容：

Angular CLI： 9.1或更高版本，< 10。
node.js：10.14.1 或更高版本，< 13.0。建议使用最新的 12.x 版本。
纱线：v1.15 或更高版本

如果您使用 Spartacus 1.x，您的 Angular 开发环境应包括以下内容：

Angular CLI：v8.0.0 或更高版本，< v9.0.0
node.js：v10 或更高版本，< v12
纱线：v1.15 或更高版本

对于后端，需要 SAP Commerce Cloud 版本 1905 或更高版本，建议使用 SAP Commerce Cloud 版本 2005 或更高版本。

注意：某些 Spartacus 功能需要仅在较新版本的 SAP Commerce Cloud 中可用的 API 端点。有关详细信息，请参阅 SAP Help Portal 上的兼容性表。

下载与安装

要启动并运行 Spartacus，建议的方法是从现成的库构建您的店面应用程序。您还可以从源代码克隆和构建，但升级并不那么简单。

Spartacus 目前只能通过 Commerce API 与 SAP Commerce Cloud 实例一起使用。

要将 Spartacus 库快速添加到 Angular 应用程序中，您可以使用 Spartacus 原理图： ng add @spartacus/schematics 。这会将 Spartacus 库设置并安装到您的 Angular 项目中。请查看官方 Spartacus 原理图文档，了解有关如何使用 Spartacus 原理图的所有先决条件和说明。

有关完整的设置说明，请参阅 SAP Help Portal 上的设置可组合店面。

定制和扩展斯巴达克斯

为了维持我们对可升级性的承诺，Spartacus 的设计模式是将非核心功能构建为功能库，以添加或更改所提供的功能。

使用 Spartacus 时，您可以构建一个提取 Spartacus 库的应用程序，其中包含使用 SAP Commerce 所需的核心资源。然后，您可以构建包含任何自定义功能和页面的新功能。

Spartacus 页面的内容是从 SAP Commerce Cloud CMS（内容管理系统）获取的，例如徽标、链接、横幅和静态页面。我们建议新的内容驱动功能遵循相同的模式，以使内容管理员能够通过 CMS 工具修改页面内容。

用于定制和扩展 Spartacus 的文档仍在开发中，并将在可用时发布。

斯巴达克斯应用文档

版本 5.x 及更高版本

请参阅可组合店面 API。

4.x 及更早版本

最新生成的 Spartacus 应用程序库（模块、类、接口等）文档托管在此处：https://sap.github.io/spartacus/

应用程序文档已进行版本控制，并且包含在每个 Spartacus 库的每个版本的资产部分中。您可以通过访问该特定版本中任何 Spartacus 库的“资产”部分，然后单击docs.tar.gz或docs.zip来下载特定版本的文档。要查找特定库的资源文件夹，请访问 Spartacus 的已发布库，单击您感兴趣的库的链接，然后滚动到页面底部。

例如，要下载 3.4.0 版本的应用程序文档，您可以在此处访问@spartacus/[email protected]库的Assets文件夹。

注意： Spartacus 库的 1.x 和 2.x 版本仅适用于 SAP Commerce 版本 1905 和 2005。某些功能（例如取消和退货）仅适用于 SAP Commerce 2005，因为仅需要必要的 OCC API 支持。 SAP Commerce 2005 中提供。