Spartakus
@spartacus
Hallo und herzlich willkommen!
Diese README-Datei ist Teil des develop , einem aktiven Entwicklungszweig im Spartacus-Repository. Daher kann der folgende Text Verweise auf Arbeiten enthalten, die noch in Arbeit sind und noch nicht offiziell veröffentlicht wurden.
Ab Version 2211.19 hat Composable Storefront seine Versionierung an SAP Commerce Cloud angepasst. Die vorherige Version von Composable Storefront war Version 6.8. Weitere Informationen finden Sie unter Änderungen an der Release-Nummerierung und den Update-Richtlinien für Composable Storefront ab Februar 2024.
Ab Version 5.0 ist „SAP Commerce Cloud, Composable Storefront“ der Name für die offizielle Veröffentlichung der von SAP veröffentlichten Projektbibliotheken „Spartacus“. Die offiziell unterstützte Composable Storefront steht SAP Commerce Cloud-Kunden zur Verfügung. Die Dokumentation ist im SAP Help Portal verfügbar.
Composable Storefront basiert auf dem Open-Source-Code von Spartacus und ist ohne zusätzliche Kosten in der SAP Commerce Cloud-Lizenz enthalten. Composable Storefront verfügt über eine Roll-Forward-Update-Richtlinie.
Kunden vor Ort können weiterhin Spartacus Open Source verwenden. Weitere Informationen finden Sie unter Selbstveröffentlichende Spartacus-Bibliotheken unter Verwendung des Open-Source-Codes.
Spartacus ist eine schlanke, Angular-basierte JavaScript-Storefront für SAP Commerce Cloud. Spartacus kommuniziert ausschließlich über die Commerce REST API mit der SAP Commerce Cloud.
Spartacus ist...
Spartacus bietet zentrale Storefront-Funktionen wie:
Weitere Informationen finden Sie in der Release-Dokumentation im SAP Help Portal.
Wenn Sie mit Spartacus 2211 arbeiten, sehen Sie sich die Anforderungen an die 2211 Angular-Entwicklungsumgebung im SAP-Hilfeportal an.
Wenn Sie mit Spartacus 6.x arbeiten, sehen Sie sich die entsprechenden Anforderungen an die Angular-Entwicklungsumgebung für 6.x im SAP-Hilfeportal an.
Wenn Sie mit Spartacus 5.x arbeiten, sehen Sie sich die entsprechenden Anforderungen an die Angular-Entwicklungsumgebung für 5.x im SAP-Hilfeportal an.
Informationen zu den Back-End-Anforderungen finden Sie in der Composable Storefront-Kompatibilitätsmatrix.
Wenn Sie mit Spartacus 4.x arbeiten, sollte Ihre Angular-Entwicklungsumgebung Folgendes umfassen:
Wenn Sie mit Spartacus 3.x arbeiten, sollte Ihre Angular-Entwicklungsumgebung Folgendes umfassen:
Wenn Sie mit Spartacus 2.x arbeiten, sollte Ihre Angular-Entwicklungsumgebung Folgendes umfassen:
Wenn Sie mit Spartacus 1.x arbeiten, sollte Ihre Angular-Entwicklungsumgebung Folgendes umfassen:
Für das Backend ist SAP Commerce Cloud Version 1905 oder höher erforderlich, empfohlen wird SAP Commerce Cloud Version 2005 oder neuer.
Hinweis: Für einige Spartacus-Funktionen sind API-Endpunkte erforderlich, die nur in neueren Versionen von SAP Commerce Cloud verfügbar sind. Weitere Informationen finden Sie in der Kompatibilitätsmatrix im SAP Help Portal.
Um mit Spartacus loszulegen, empfiehlt es sich, Ihre Storefront-Anwendung aus vorgefertigten Bibliotheken zu erstellen. Sie können auch aus dem Quellcode klonen und erstellen, ein Upgrade ist jedoch nicht so einfach.
Spartacus kann derzeit nur mit einer SAP Commerce Cloud-Instanz über Commerce APIs verwendet werden.
Um Spartacus-Bibliotheken schnell zu einer Angular-Anwendung hinzuzufügen, können Sie Spartacus-Schemata verwenden: ng add @spartacus/schematics . Dadurch werden Spartacus-Bibliotheken in Ihrem Angular-Projekt eingerichtet und installiert. Alle Voraussetzungen und Anweisungen zur Verwendung von Spartacus-Schaltplänen finden Sie in der offiziellen Spartacus-Schaltplandokumentation.
Vollständige Einrichtungsanweisungen finden Sie unter „Einrichten der Composable Storefront“ im SAP Help Portal.
Um unser Versprechen der Aktualisierbarkeit einzuhalten, sieht das Entwurfsmuster für Spartacus vor, dass nicht zum Kerngeschäft gehörende Funktionen als Funktionsbibliotheken erstellt werden, die die bereitgestellte Funktionalität ergänzen oder ändern.
Wenn Sie Spartacus verwenden, erstellen Sie eine App, die die Spartacus-Bibliotheken einbezieht, die die Kernressourcen enthalten, die für die Arbeit mit SAP Commerce erforderlich sind. Anschließend erstellen Sie neue Funktionen, die benutzerdefinierte Funktionen und Seiten enthalten.
Inhalte für Spartacus-Seiten werden aus dem SAP Commerce Cloud CMS (Content Management System) abgerufen, beispielsweise Logos, Links, Banner und statische Seiten. Wir empfehlen, dass neue inhaltsgesteuerte Funktionen demselben Muster folgen, damit Content-Manager den Seiteninhalt über die CMS-Tools ändern können.
Die Dokumentation zum Anpassen und Erweitern von Spartacus befindet sich noch in der Entwicklung und wird veröffentlicht, sobald sie verfügbar ist.
Siehe Composable Storefront API.
Die neueste generierte Dokumentation für Spartacus-Anwendungsbibliotheken (Module, Klassen, Schnittstellen usw.) wird hier gehostet: https://sap.github.io/spartacus/
Die Anwendungsdokumentation ist versioniert und im Abschnitt „Assets“ jeder Version jeder einzelnen Spartacus-Bibliothek enthalten. Sie können die Dokumentation für eine bestimmte Version herunterladen, indem Sie auf den Abschnitt „Assets “ einer beliebigen Spartacus-Bibliothek dieser bestimmten Version zugreifen und dann auf docs.tar.gz oder docs.zip klicken. Um den Assets -Ordner für eine bestimmte Bibliothek zu finden, greifen Sie auf die freigegebenen Bibliotheken für Spartacus zu, klicken Sie auf den Link für die Bibliothek, die Sie interessiert, und scrollen Sie zum Ende der Seite.
Um beispielsweise die Anwendungsdokumentation für die Version 3.4.0 herunterzuladen, können Sie hier auf den Ordner „Assets“ der @spartacus/[email protected] -Bibliothek zugreifen.
Hinweis: Die 1.x- und 2.x-Releases der Spartacus-Bibliotheken funktionieren nur mit den SAP Commerce-Versionen 1905 und 2005. Bestimmte Funktionen, wie z. B. Stornierungen und Retouren, sind nur mit SAP Commerce 2005 verfügbar, da die erforderliche OCC-API-Unterstützung nur vorhanden ist verfügbar in SAP Commerce 2005.
Bei der Veröffentlichung von 1.0.0 wird die Verwendung von SAP Commerce 1905 empfohlen. Spartacus funktioniert mit einigen Einschränkungen mit den Versionen 1808 und 1811 von SAP Commerce Cloud.
Spartacus wird außerdem aktualisiert, damit es gut mit kommenden Versionen von SAP Commerce Cloud funktioniert. Das bedeutet, dass bestimmte Funktionen von Spartacus möglicherweise nur mit unveröffentlichten zukünftigen Editionen von SAP Commerce Cloud funktionieren. Dies wird bei der Veröffentlichung neuer Versionen von Spartacus berücksichtigt.
Bekannte Probleme werden im GitHub-Problemverfolgungssystem dokumentiert.
Spartacus wird „wie besehen“ ohne offizielle Supportlinien bereitgestellt.
So erhalten Sie Hilfe von der Spartacus-Community:
Team Spartacus freut sich über Feedback, Ideen, Wünsche und insbesondere Code-Beiträge.
Es kommen viele Verbesserungen! Alle Aufgaben werden in unserem GitHub-Problemverfolgungssystem veröffentlicht. Wie bereits erwähnt, werden einige der Verbesserungen bahnbrechende Änderungen mit sich bringen. Obwohl wir uns bemühen, dies zu vermeiden, können wir nicht garantieren, dass dies nicht vor der ersten Veröffentlichung geschieht.
Copyright (c) 2024 SAP SE oder ein SAP-Konzernunternehmen. Alle Rechte vorbehalten. Diese Datei ist unter der Apache-Softwarelizenz, Version 2, lizenziert, sofern in der LIZENZdatei nichts anderes angegeben ist.
