Olá e seja bem-vindo!
Este README faz parte do ramo develop
, que é um ramo de desenvolvimento ativo no repositório Spartacus. Como tal, o texto a seguir pode conter referências a trabalhos em andamento e ainda não divulgados oficialmente.
A partir da versão 2211.19, a vitrine composta alinhou seu versionamento com o SAP Commerce Cloud. A versão anterior da vitrine combinável era a versão 6.8. Para obter mais informações, consulte Mudanças na numeração de versões e políticas de atualização para Composable Storefront a partir de fevereiro de 2024.
A partir da versão 5.0, “SAP Commerce Cloud, composable storefront” é o nome do lançamento oficial das bibliotecas do projeto “Spartacus” publicadas pela SAP. A vitrine combinável com suporte oficial está disponível para clientes SAP Commerce Cloud. A documentação está disponível no SAP Help Portal.
A vitrine combinável é baseada no código-fonte aberto Spartacus e está incluída na licença SAP Commerce Cloud sem custo adicional. A vitrine combinável tem uma política de atualização progressiva.
Os clientes locais ainda podem usar o código aberto do Spartacus. Para obter mais informações, consulte Bibliotecas Spartacus de autopublicação usando código-fonte aberto.
Spartacus é uma vitrine JavaScript enxuta e baseada em Angular para SAP Commerce Cloud. Spartacus conversa com SAP Commerce Cloud exclusivamente por meio da Commerce REST API.
Espártaco é...
Spartacus oferece recursos básicos de loja, como:
Consulte a documentação de lançamento no SAP Help Portal para obter mais informações.
Se você estiver trabalhando com Spartacus 2211, consulte os requisitos do ambiente de desenvolvimento Angular 2211 no SAP Help Portal.
Se você estiver trabalhando com Spartacus 6.x, consulte os requisitos relevantes do ambiente de desenvolvimento Angular 6.x no SAP Help Portal.
Se você estiver trabalhando com Spartacus 5.x, consulte os requisitos relevantes do ambiente de desenvolvimento Angular 5.x no SAP Help Portal.
Para obter os requisitos de back-end, consulte a Matriz de compatibilidade do Composable Storefront.
Se você estiver trabalhando com Spartacus 4.x, seu ambiente de desenvolvimento Angular deverá incluir o seguinte:
Se você estiver trabalhando com Spartacus 3.x, seu ambiente de desenvolvimento Angular deverá incluir o seguinte:
Se você estiver trabalhando com Spartacus 2.x, seu ambiente de desenvolvimento Angular deverá incluir o seguinte:
Se você estiver trabalhando com Spartacus 1.x, seu ambiente de desenvolvimento Angular deverá incluir o seguinte:
Para o back-end, é necessário o SAP Commerce Cloud versão 1905 ou superior, e o SAP Commerce Cloud versão 2005 ou mais recente é recomendado.
Observação: alguns recursos do Spartacus exigem endpoints de API que estão disponíveis apenas em versões mais recentes do SAP Commerce Cloud. Para obter mais informações, consulte Matriz de compatibilidade no SAP Help Portal.
Para começar a usar o Spartacus, a abordagem recomendada é construir seu aplicativo de loja a partir de bibliotecas prontas. Você também pode clonar e compilar a partir do código-fonte, mas atualizar não é tão simples.
Atualmente, o Spartacus só pode ser usado com uma instância SAP Commerce Cloud por meio de APIs de comércio.
Para adicionar rapidamente bibliotecas Spartacus a um aplicativo Angular, você pode usar esquemas Spartacus: ng add @spartacus/schematics
. Isto irá configurar e instalar bibliotecas Spartacus em seu projeto Angular. Por favor, verifique a documentação oficial dos esquemas do Spartacus para todos os pré-requisitos e instruções sobre como usar os esquemas do Spartacus.
Para obter instruções completas de configuração, consulte Configurando o Composable Storefront no SAP Help Portal.
Para manter nossa promessa de capacidade de atualização, o padrão de design do Spartacus é que recursos não essenciais sejam construídos como bibliotecas de recursos que adicionam ou alteram a funcionalidade fornecida.
Ao usar o Spartacus, você cria um aplicativo que extrai as bibliotecas do Spartacus, que contêm os principais recursos necessários para trabalhar com o SAP Commerce. Em seguida, você cria novos recursos que contêm funcionalidades e páginas personalizadas.
O conteúdo das páginas Spartacus é obtido do SAP Commerce Cloud CMS (Content Management System), como logotipos, links, banners e páginas estáticas. Recomendamos que os novos recursos orientados a conteúdo sigam o mesmo padrão para permitir que os gerentes de conteúdo modifiquem o conteúdo da página por meio das ferramentas CMS.
A documentação para customização e extensão do Spartacus ainda está em desenvolvimento e será lançada assim que estiver disponível.
Consulte API Composable Storefront.
A documentação gerada mais recente para bibliotecas de aplicativos Spartacus (módulos, classes, interfaces e assim por diante) está hospedada aqui: https://sap.github.io/spartacus/
A documentação do aplicativo é versionada e incluída na seção Ativos de cada versão de cada biblioteca Spartacus. Você pode baixar a documentação de uma versão específica acessando a seção Assets de qualquer biblioteca Spartacus daquela versão específica e clicando em docs.tar.gz
ou docs.zip
. Para encontrar a pasta Ativos de uma biblioteca específica, acesse Bibliotecas liberadas para Spartacus, clique no link da biblioteca de seu interesse e vá até o final da página.
Por exemplo, para baixar a documentação do aplicativo para a versão 3.4.0, você pode acessar a pasta Assets da biblioteca @spartacus/[email protected]
aqui.
Nota: As versões 1.xe 2.x das bibliotecas Spartacus funcionam apenas com as versões 1905 e 2005 do SAP Commerce. Certos recursos, como cancelamentos e devoluções, estão disponíveis apenas com o SAP Commerce 2005, porque o suporte necessário da API OCC está disponível apenas disponível no SAP Commerce 2005.
Quando a versão 1.0.0 for lançada, recomenda-se a utilização do SAP Commerce 1905. Spartacus trabalha com as versões 1808 e 1811 do SAP Commerce Cloud, com algumas limitações.
Spartacus também está sendo atualizado para funcionar bem com os próximos lançamentos do SAP Commerce Cloud. Isso significa que determinados recursos do Spartacus só poderão funcionar com futuras edições não lançadas do SAP Commerce Cloud. Isso será notado à medida que lançarmos novas versões do Spartacus.
Os problemas conhecidos estão documentados no sistema de rastreamento de problemas do GitHub.
Spartacus é fornecido "no estado em que se encontra", sem linhas oficiais de apoio.
Para obter ajuda da comunidade Spartacus:
A equipe Spartacus agradece comentários, ideias, solicitações e especialmente contribuições de código.
Muitas melhorias estão por vir! Todas as tarefas serão publicadas em nosso sistema de rastreamento de problemas GitHub. Conforme mencionado, algumas das melhorias significarão mudanças significativas. Embora nos esforcemos para evitar isso, não podemos garantir que isso não acontecerá antes do primeiro lançamento.
Copyright (c) 2024 SAP SE ou empresa afiliada da SAP. Todos os direitos reservados. Este arquivo está licenciado sob a Licença de Software Apache, v. 2, exceto quando indicado de outra forma no arquivo LICENSE.