斯巴達克斯和可組合店面

您好，歡迎光臨！

本自述文件是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。 2005 中提供。