aem core cif components
CI
O projeto AEM CIF Core Components serve como acelerador para começar com projetos usando o comércio AEM, CIF e Adobe. O projeto contém componentes principais de comércio reutilizáveis que combinam componentes AEM renderizados do lado do servidor com componentes de comércio de comércio de reação do lado do cliente (MPA) para experiências / dados dinâmicos.
Este projeto deve ser usado em conjunto com os componentes do núcleo do Sites AEM. Os componentes principais do AEM CIF usam os componentes principais do AEM Sites como uma base sempre que possível e estendê -los.
Para iniciar um novo projeto, dê uma olhada no nosso projeto de arquétipo. Também dê uma olhada no nosso projeto de amostra da Venia, que usa os componentes do WCM e CIF para oferecer uma experiência impressionante na frente da loja.
Consulte a documentação do conteúdo e comércio da AEM para obter instruções de uso e configuração dos componentes do núcleo do AEM CIF e introdução ao desenvolvimento de componentes AEM.
Os componentes que estão em visualização técnica podem mudar de maneira compatível sem verso a qualquer momento. Isso inclui todos os apetos e, em particular, a estrutura de conteúdo, API, marcação e estilo, se aplicável. Não use esses componentes na produção.
A versão mais recente dos componentes principais do AEM CIF exige os requisitos mínimos do sistema abaixo:
| Componentes do núcleo do CIF | AEM como um serviço em nuvem | AEM 6.5 | Complemento do comércio AEM | Adobe Commerce | Java |
|---|---|---|---|---|---|
| 2.15.0 | Contínuo | 6.5.18 | v2022.08.02.00 | 2.4.2 EE | 11 |
Para obter uma lista de requisitos para versões anteriores, consulte os requisitos históricos do sistema.
Para o AEM como um serviço em nuvem implanta, este projeto requer o complemento CIF provisionado em cada AEM como um ambiente de serviço em nuvem. O complemento CIF é instalado automaticamente, nenhuma implantação extra é necessária. O complemento CIF também está disponível para o desenvolvimento local com o AEM SDK no portal de distribuição de software.
Para instalações no local da AEM, este projeto requer o complemento do Comércio AEM para o AEM 6.5 para melhorar a experiência de autoria, aproveitando os catadores de produtos, a exibição de ativos de produtos e os consoles de produtos fornecidos pelo pacote do conector. O complemento do Comércio AEM para AEM 6.5 também está disponível no portal de distribuição de software. Deve ser instalado separadamente.
Este projeto depende dos componentes principais dos sites da AEM. Eles geralmente são instalados como parte do AEM. Se você instalar a opção de conteúdo do AEM sem amostra, precisará implantá -los manualmente antes de usar os componentes do núcleo do AEM CIF.
Começando com 2.3.2, o Adobe Commerce suporta solicitações grafql de cache e começando com a versão 0.2.1 Os componentes do CIF Core o usarão por padrão. Para fazer com que os componentes trabalhem com o Adobe Commerce 2.3.1, você pode desativar manualmente esse recurso nos seguintes locais:
mvn clean install na pasta raiz para instalar os artefatos no repositório local do Maven.all e execute um mvn clean install content-package:install .Aqui está um passeio completo de vídeo do processo de configuração.
Se você quiser construir todos os módulos e obter todas as mais recentes alterações (ainda) não lançadas , basta construir e instalar todos os módulos com o seguinte comando na raiz do repositório:
mvn clean install -PautoInstallAll
Isso instala tudo por padrão no localhost:4502 sem nenhum caminho de contexto. Você também pode configurar o local de instalação com as seguintes propriedades do Maven:
aem.host : o nome da instância AEMaem.port : o número da porta da instância AEMaem.contextPath : o caminho de contexto da sua instância AEM (se não / ) Este projeto depende do Uberjar do AEM 6.5.7 cq-quickstart . Isso está disponível publicamente em https://repo.adobe.com
Para obter mais detalhes sobre o Uberjar, acesse os projetos de como construir o AEM usando a página de documentação do Apache Maven.
A versão lançada dos componentes do núcleo AEM CIF está disponível no repositório central do MAVEN. Para incluir o pacote AEM CIF Core Components em seu próprio projeto Maven Build, você pode adicionar a dependência
<dependency>
<groupId>com.adobe.commerce.cif</groupId>
<artifactId>core-cif-components-all</artifactId>
<type>zip</type>
<version>x.y.z</version>
</dependency>
e seção sub -pacote
<subPackage>
<groupId>com.adobe.commerce.cif</groupId>
<artifactId>core-cif-components-all</artifactId>
<filter>true</filter>
</subPackage>
para o content-package-maven-plugin .
Para conectar os componentes do núcleo do AEM CIF com o seu ambiente de comércio da Adobe ou uma implantação de comércio de terceiros, siga as etapas de configuração. Para uma configuração de várias lojas / sites, são necessárias etapas adicionais para vincular um site AEM a uma configuração de exibição da Adobe Commerce Store.
Para personalizar os componentes principais do CIF, fornecemos casos de uso e exemplos em nossa documentação no personalização dos componentes principais do CIF.
O código JavaScript do lado do cliente dos componentes é coberto usando testes de unidade Mocha executados com o karma. Certifique-se de que, para cada contribuição, o novo código do lado do cliente seja coberto por testes e que todos os testes passem.
cd ui.apps
npm install
npm testO Karma testará com Chrome e Firefox. Verifique se você tem os dois navegadores instalados.
Você pode encontrar as regras de formatação do código no arquivo eclipse-formatter.xml . A formatação do código é automaticamente verificada para cada compilação. Para formatar automaticamente seu código, execute:
mvn clean install -Pformat-code Para formatar JavaScript e CSS, usamos mais bonito. A formatação é verificada automaticamente ao executar npm test no projeto ui.apps . Para formatar automaticamente seu código, execute o seguinte comando na ui.apps :
npm run prettier:fix Os lançamentos deste projeto são acionados pela mvn release:prepare release:clean na filial master na pasta raiz deste repositório. Depois de escolher a versão e as próximas versões instantâneas, isso comete a alteração junto com uma tag de liberação como, por exemplo core-cif-components-reactor-xyz . Observe que os compromissos não são empurrados automaticamente para o repositório Git, então você tem algum tempo para verificar suas alterações e depois pressioná -las manualmente. O impulso então desencadeia uma construção dedicada CircleCI que executa a implantação do artefato marcado para o Maven Central.
IMPORTANTE : Este projeto faz liberações de reator Maven, não aciona liberações de sub -módulos!
NOTA: Caso seja necessário atualizar a versão de um pacote Java devido a alterações na API e versão semântica, pode -se atualizar facilmente a versão pai POM e todos os POMs que referenciam a versão pai POM executando o seguinte comando na pasta do projeto pai: mvn versions:set -DnewVersion=xyz-SNAPSHOT . Isso garantirá que todos os projetos tenham a mesma versão.
As contribuições são bem -vindas! Leia o guia contribuinte para obter mais informações.
Este projeto está licenciado sob a licença Apache V2. Consulte a licença para obter mais informações.
