سبارتاكوس
@spartacus
أهلا ومرحبا!
يعد الملف التمهيدي هذا جزءًا من فرع develop ، وهو فرع تطوير نشط في مستودع Spartacus. وعلى هذا النحو، قد يحتوي النص التالي على إشارات إلى عمل قيد التقدم ولم يتم إصداره رسميًا بعد.
بدءًا من الإصدار 2211.19، قامت واجهة المتجر القابلة للتركيب بمحاذاة إصدارها مع SAP Commerce Cloud. الإصدار السابق من واجهة المتجر القابلة للتركيب كان الإصدار 6.8. لمزيد من المعلومات، راجع التغييرات على ترقيم الإصدارات وسياسات التحديث لواجهة المتجر القابلة للتركيب بدءًا من فبراير 2024.
بدءًا من الإصدار 5.0، "SAP Commerce Cloud، واجهة المتجر القابلة للتركيب" هو اسم الإصدار الرسمي لمكتبات مشروع "Spartacus" التي نشرتها SAP. تتوفر واجهة المتجر القابلة للتركيب والمدعومة رسميًا لعملاء SAP Commerce Cloud. الوثائق متاحة على بوابة تعليمات SAP.
تعتمد واجهة المتجر القابلة للتركيب على كود Spartacus مفتوح المصدر، وهي مضمنة في ترخيص SAP Commerce Cloud دون أي تكلفة إضافية. تتمتع واجهة المتجر القابلة للتركيب بسياسة التحديث المرحلي.
لا يزال بإمكان العملاء المحليين استخدام Spartacus مفتوح المصدر. لمزيد من المعلومات، راجع مكتبات سبارتاكوس للنشر الذاتي باستخدام التعليمات البرمجية مفتوحة المصدر.
Spartacus عبارة عن واجهة متجر JavaScript بسيطة تعتمد على Angular لـ SAP Commerce Cloud. يتحدث Spartacus إلى SAP Commerce Cloud حصريًا من خلال Commerce REST API.
سبارتاكوس هو...
يوفر Spartacus ميزات واجهة المتجر الأساسية مثل:
راجع وثائق الإصدار على بوابة تعليمات SAP لمزيد من المعلومات.
إذا كنت تعمل مع Spartacus 2211، فراجع متطلبات بيئة التطوير 2211 Angular على بوابة تعليمات SAP.
إذا كنت تعمل مع Spartacus 6.x، فراجع متطلبات بيئة التطوير 6.x Angular ذات الصلة على بوابة تعليمات SAP.
إذا كنت تعمل مع Spartacus 5.x، فراجع متطلبات بيئة التطوير 5.x Angular ذات الصلة على بوابة تعليمات SAP.
للتعرف على متطلبات الواجهة الخلفية، راجع مصفوفة توافق واجهة المتجر القابلة للتركيب.
إذا كنت تعمل مع Spartacus 4.x، فيجب أن تتضمن بيئة التطوير Angular ما يلي:
إذا كنت تعمل مع Spartacus 3.x، فيجب أن تتضمن بيئة التطوير Angular الخاصة بك ما يلي:
إذا كنت تعمل مع Spartacus 2.x، فيجب أن تتضمن بيئة التطوير Angular الخاصة بك ما يلي:
إذا كنت تعمل مع Spartacus 1.x، فيجب أن تتضمن بيئة التطوير Angular الخاصة بك ما يلي:
بالنسبة للواجهة الخلفية، يلزم الإصدار 1905 من SAP Commerce Cloud أو أعلى، ويوصى باستخدام الإصدار 2005 من SAP Commerce Cloud أو الأحدث.
ملاحظة: تتطلب بعض ميزات Spartacus نقاط نهاية API المتوفرة فقط في الإصدارات الأحدث من SAP Commerce Cloud. لمزيد من المعلومات، راجع مصفوفة التوافق على بوابة تعليمات SAP.
لبدء العمل مع Spartacus، فإن الأسلوب الموصى به هو إنشاء تطبيق واجهة المتجر الخاص بك من المكتبات الجاهزة. يمكنك أيضًا الاستنساخ والبناء من المصدر، لكن الترقية ليست بهذه البساطة.
لا يمكن استخدام Spartacus حاليًا إلا مع مثيل SAP Commerce Cloud من خلال واجهات برمجة التطبيقات التجارية.
لإضافة مكتبات Spartacus بسرعة إلى تطبيق Angular، يمكنك استخدام مخططات Spartacus: ng add @spartacus/schematics . سيؤدي هذا إلى إعداد مكتبات Spartacus وتثبيتها على مشروع Angular الخاص بك. برجاء مراجعة وثائق مخططات Spartacus الرسمية للتعرف على جميع المتطلبات الأساسية والتعليمات حول كيفية استخدام مخططات Spartacus.
للحصول على تعليمات الإعداد الكاملة، راجع إعداد واجهة المتجر القابلة للتركيب على بوابة تعليمات SAP.
للحفاظ على وعدنا بإمكانية الترقية، فإن نمط التصميم لـ Spartacus مخصص للميزات غير الأساسية التي سيتم إنشاؤها كمكتبات ميزات تضيف إلى الوظائف المتوفرة أو تغيرها.
عند استخدام Spartacus، يمكنك إنشاء تطبيق يسحب مكتبات Spartacus، التي تحتوي على الموارد الأساسية اللازمة للعمل مع SAP Commerce. يمكنك بعد ذلك إنشاء ميزات جديدة تحتوي على أي وظائف وصفحات مخصصة.
يتم جلب محتوى صفحات Spartacus من SAP Commerce Cloud CMS (نظام إدارة المحتوى)، مثل الشعارات والروابط واللافتات والصفحات الثابتة. نوصي بأن تتبع الميزات الجديدة المستندة إلى المحتوى نفس النمط لتمكين مديري المحتوى من تعديل محتوى الصفحة من خلال أدوات نظام إدارة المحتوى.
لا تزال الوثائق الخاصة بتخصيص وتوسيع Spartacus قيد التطوير وسيتم إصدارها عندما تصبح متاحة.
راجع واجهة برمجة تطبيقات واجهة المتجر القابلة للتركيب.
تتم استضافة أحدث الوثائق التي تم إنشاؤها لمكتبات تطبيقات Spartacus (الوحدات والفئات والواجهات وما إلى ذلك) هنا: https://sap.github.io/spartacus/
يتم إصدار وثائق التطبيق ويتم تضمينها في قسم الأصول في كل إصدار لكل مكتبة Spartacus. يمكنك تنزيل الوثائق الخاصة بإصدار معين عن طريق الوصول إلى قسم الأصول في أي مكتبة Spartacus من هذا الإصدار المحدد، ثم النقر فوق docs.tar.gz أو docs.zip . للعثور على مجلد الأصول لمكتبة معينة، قم بالوصول إلى المكتبات الصادرة لـ Spartacus، وانقر على الرابط الخاص بالمكتبة التي تهتم بها، وانتقل إلى أسفل الصفحة.
على سبيل المثال، لتنزيل وثائق التطبيق للإصدار 3.4.0، يمكنك الوصول إلى مجلد الأصول الخاص بمكتبة @spartacus/[email protected] هنا.
ملاحظة: يعمل الإصداران 1.x و2.x من مكتبات Spartacus فقط مع الإصدارين 1905 و2005 من SAP Commerce. تتوفر بعض الميزات، مثل الإلغاءات والإرجاع، فقط مع SAP Commerce 2005، نظرًا لأن دعم OCC API الضروري متاح فقط متوفر في SAP Commerce 2005.
عند إصدار 1.0.0، يوصى باستخدام SAP Commerce 1905. يعمل Spartacus مع الإصدارين 1808 و1811 من SAP Commerce Cloud، مع بعض القيود.
يتم أيضًا تحديث Spartacus بحيث يعمل بشكل جيد مع الإصدارات القادمة من SAP Commerce Cloud. وهذا يعني أن بعض ميزات Spartacus قد تعمل فقط مع الإصدارات المستقبلية من SAP Commerce Cloud. سيتم ملاحظة ذلك عندما نقوم بإصدار إصدارات جديدة من Spartacus.
يتم توثيق المشكلات المعروفة في نظام تتبع المشكلات في GitHub.
يتم توفير سبارتاكوس "كما هو" دون أي خطوط دعم رسمية.
للحصول على المساعدة من مجتمع سبارتاكوس:
يرحب فريق Spartacus بالتعليقات والأفكار والطلبات، وخاصة مساهمات التعليمات البرمجية.
العديد من التحسينات قادمة! سيتم نشر جميع المهام على نظام تتبع المشكلات GitHub الخاص بنا. كما ذكرنا سابقًا، فإن بعض التحسينات ستعني كسر التغييرات. وبينما نسعى جاهدين لتجنب القيام بذلك، لا يمكننا ضمان عدم حدوث ذلك قبل الإصدار الأول.
حقوق الطبع والنشر (ج) لعام 2024 مملوكة لشركة SAP SE أو إحدى الشركات التابعة لـ SAP. جميع الحقوق محفوظة. تم ترخيص هذا الملف بموجب ترخيص برنامج Apache، الإصدار 2 باستثناء ما هو مذكور بخلاف ذلك في ملف الترخيص.
