Спартак

Спартак и сборная витрина

Здравствуйте и добро пожаловать!

Этот файл README является частью ветки develop , которая является активной веткой разработки в репозитории Spartacus. Таким образом, следующий текст может содержать ссылки на работу, которая еще не выпущена официально.

Начиная с версии 2211.19, составная витрина согласовала свои версии с SAP Commerce Cloud. Предыдущей версией составной витрины была версия 6.8. Дополнительные сведения см. в разделе «Изменения в нумерации выпусков и политиках обновления для составной витрины магазина, начиная с февраля 2024 г.».

Начиная с версии 5.0, «SAP Commerce Cloud, составная витрина» — это название официального выпуска библиотек проекта «Спартак», опубликованного SAP. Официально поддерживаемая составная витрина доступна клиентам SAP Commerce Cloud. Документация доступна на справочном портале SAP.

Составная витрина основана на открытом исходном коде Spartacus и включена в лицензию SAP Commerce Cloud без дополнительной оплаты. В составной витрине действует политика обновления с повтором транзакций.

Локальные клиенты по-прежнему могут использовать Spartacus с открытым исходным кодом. Для получения дополнительной информации см. Самостоятельную публикацию библиотек Spartacus с использованием открытого исходного кода.

Что такое Спартак?

Spartacus — это компактный магазин JavaScript на базе Angular для SAP Commerce Cloud. Spartacus взаимодействует с SAP Commerce Cloud исключительно через Commerce REST API.

• Документация доступна на справочном портале SAP.
• Опробуйте образец витрины магазина Spartacus на нашем общедоступном демонстрационном сайте.
• Технические вопросы? Свяжитесь с нами через Stack Overflow.
• Нетехнические вопросы? Присоединяйтесь к нашему рабочему пространству Slack.
• Подробные сведения о запуске версии 4.0 см. на странице «Информация о выпуске» на справочном портале SAP.

Спартак - это...

• Расширяемый : Spartacus спроектирован так, чтобы его можно было модернизировать, сохраняя при этом полную расширяемость. Вы сможете использовать новые версии Spartacus, обновляя библиотеки Spartacus, которые мы будем регулярно улучшать. (Чтобы гарантировать, что первый выпуск будет настолько расширяемым и обновляемым, насколько нам хотелось бы, критические изменения, скорее всего, будут внесены вплоть до запуска 1.0.)
• Возможность обновления : код Spartacus публикуется и используется в виде библиотек и соответствует соглашениям о семантическом управлении версиями. Используя библиотеки, Spartacus можно обновлять до второстепенных выпусков и выпусков исправлений.
• Прогрессивный : Spartacus стремится полностью соответствовать контрольному списку прогрессивных веб-приложений (PWA). Мы стремимся добавить поддержку всех основных функций витрины магазина с поддержкой PWA, чтобы обеспечить наилучшее качество обслуживания клиентов независимо от устройства или местоположения.
• Открытый исходный код : Спартак имеет открытый исходный код. Команда SAP Commerce Cloud будет постоянно разрабатывать его, но мы очень хотим приветствовать участников и способствовать созданию инклюзивного и активного сообщества разработчиков для Spartacus. Дополнительную информацию см. в нашей сопутствующей документации.
• Современность : витрина Spartacus — это часть нашего нового захватывающего пути к настраиваемой, но обновляемой технологии для установок SAP Commerce Cloud. Дополнительную информацию о SAP Commerce Cloud см. в разделе SAP Customer Experience.

Особенности витрины

Spartacus предоставляет основные функции витрины, такие как:

• Домашняя страница
• Поиск
• Категории
• Подробности о продукте
• Страница корзины
• Добавление в корзину
• Проверить
• История заказов

Дополнительную информацию см. в документации по выпуску на справочном портале SAP.

Требования

Если вы работаете со Spartacus 2211, см. требования к среде разработки 2211 Angular на справочном портале SAP.

Если вы работаете с Spartacus 6.x, см. соответствующие требования к среде разработки Angular 6.x на справочном портале SAP.

Если вы работаете с Spartacus 5.x, см. соответствующие требования к среде разработки Angular 5.x на справочном портале SAP.

Требования к серверной части см. в Матрице совместимости составной витрины.

Если вы работаете со Spartacus 4.x, ваша среда разработки Angular должна включать следующее:

• Angular CLI: 12.0 или новее, < 13.
• пряжа: v1.15 или новее
• node.js: требуется версия 14.15 . Срок эксплуатации версии 12.x истек 30 апреля 2022 г., и Спартак больше не поддерживает ее. Настоятельно рекомендуется как можно скорее перенести все существующие витрины магазинов Spartacus на Node.js 14. Если есть какие-либо проблемы со Spartacus и Node.js 14, обновите их до последних версий. Если у вас по-прежнему возникают проблемы с Node.js 14, создайте заявку в службу поддержки SAP. Spartacus также поддерживает версию 16.x Node.js, но эта версия еще не поддерживается в 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 требуются конечные точки API, которые доступны только в более новых версиях SAP Commerce Cloud. Для получения дополнительной информации см. Матрицу совместимости на справочном портале SAP.

Загрузка и установка

Чтобы начать работу со Spartacus, рекомендуется создать приложение для витрины из готовых библиотек. Вы также можете клонировать и собирать исходный код, но обновить его не так просто.

В настоящее время Spartacus можно использовать только с экземпляром SAP Commerce Cloud через API Commerce.

Чтобы быстро добавить библиотеки Spartacus в приложение Angular, вы можете использовать схемы Spartacus: ng add @spartacus/schematics . Это позволит настроить и установить библиотеки Spartacus в ваш проект Angular. Пожалуйста, ознакомьтесь с официальной документацией по схемам Spartacus, чтобы узнать все необходимые условия и инструкции по использованию схем Spartacus.

Полные инструкции по настройке см. в разделе «Настройка составной витрины» на справочном портале SAP.

Настройка и расширение Спартака

Чтобы сохранить наше обещание об обновлении, шаблон проектирования Spartacus предполагает создание неосновных функций в виде библиотек функций, которые добавляют или изменяют предоставляемую функциональность.

При использовании Spartacus вы создаете приложение, которое использует библиотеки Spartacus, содержащие основные ресурсы, необходимые для работы с SAP Commerce. Затем вы создаете новые функции, которые содержат любые пользовательские функции и страницы.

Контент для страниц Spartacus извлекается из SAP Commerce Cloud CMS (система управления контентом), например логотипы, ссылки, баннеры и статические страницы. Мы рекомендуем, чтобы новые функции, управляемые контентом, следовали той же схеме, чтобы позволить менеджерам контента изменять содержимое страниц с помощью инструментов CMS.

Документация по настройке и расширению Спартака все еще находится в разработке и будет выпущена по мере ее появления.

Документация по заявке Спартака

Версия 5.x и новее

См. составной API витрины.

Версия 4.x и старше

Последняя созданная документация для библиотек приложений Spartacus (модули, классы, интерфейсы и т. д.) размещена здесь: https://sap.github.io/spartacus/

Документация приложения имеет версии и включена в раздел «Ресурсы» каждого выпуска каждой библиотеки Spartacus. Вы можете загрузить документацию для конкретной версии, открыв раздел «Ресурсы» любой библиотеки Spartacus из этого конкретного выпуска, а затем щелкнув docs.tar.gz или docs.zip . Чтобы найти папку «Активы» для конкретной библиотеки, откройте «Выпущенные библиотеки для Спартака», щелкните ссылку на интересующую вас библиотеку и прокрутите страницу вниз.

Например, чтобы загрузить документацию приложения для версии 3.4.0, вы можете получить доступ к папке Assets библиотеки @spartacus/[email protected] здесь.

Примечание. Выпуски библиотек Spartacus 1.x и 2.x работают только с SAP Commerce версий 1905 и 2005. Некоторые функции, такие как отмена и возврат, доступны только в SAP Commerce 2005, поскольку необходимая поддержка OCC API доступна только в SAP Commerce 2005. доступно в SAP Commerce 2005.

Ограничения

При выпуске версии 1.0.0 рекомендуется использовать SAP Commerce 1905. Spartacus работает с версиями 1808 и 1811 SAP Commerce Cloud с некоторыми ограничениями.

Spartacus также обновляется, чтобы он хорошо работал с предстоящими выпусками SAP Commerce Cloud. Это означает, что некоторые функции Spartacus могут работать только с невыпущенными будущими выпусками SAP Commerce Cloud. Это будет отмечено по мере выпуска новых версий Спартака.

Известные проблемы

Известные проблемы документированы в системе отслеживания проблем GitHub.

Как получить поддержку

«Спартак» предоставляется «как есть», без какой-либо официальной поддержки.

Чтобы получить помощь от сообщества Спартака:

• Если у вас есть вопросы для разработчиков, задавайте их в Stack Overflow с тегом «Спартак».

Содействие

Команда Spartacus приветствует отзывы, идеи, запросы и особенно вклад в код.

• Прочтите сопроводительный документ и узнайте, как:
  • Помогите другим
  • Сообщить о проблеме
  • Внести код в Спартак

Сделать

Будет много улучшений! Все задачи будут опубликованы в нашей системе отслеживания проблем GitHub. Как уже упоминалось, некоторые улучшения будут означать кардинальные изменения. Хотя мы стараемся избегать этого, мы не можем гарантировать, что этого не произойдет до выхода первого релиза.

Лицензия

Авторские права (c) принадлежат SAP SE или аффилированной компании SAP, 2024 г. Все права защищены. Этот файл распространяется по лицензии Apache Software License, версия 2, если иное не указано в файле LICENSE.