Desenvolver o AEM Commerce para o AEM as a Cloud Service develop

O desenvolvimento de projetos de comércio do AEM, com base na Commerce Integration Framework (CIF) para o AEM as a Cloud Service, segue as mesmas regras e práticas recomendadas de outros projetos do AEM AEM no as a Cloud Service. Revise o seguinte primeiro:

Desenvolvimento local com o SDK do AEM as a Cloud Service local

Um ambiente de desenvolvimento local é recomendado para trabalhar com projetos da CIF. O complemento CIF fornecido para o AEM as a Cloud Service também está disponível para desenvolvimento local. Ele pode ser baixado no Portal de distribuição de software.

O complemento CIF é fornecido como um arquivo de recursos Sling. O arquivo zip disponível no Portal de distribuição de software inclui dois arquivos de recursos Sling, um para o autor no AEM e outro para instâncias de publicação do AEM.

Novo no AEM as a Cloud Service? Confira um guia mais detalhado para configurar um ambiente de desenvolvimento local usando o SDK as a Cloud Service do AEM.

Software necessário

Devem ser instalados:

Acesso ao complemento CIF

É possível baixar o complemento CIF como um arquivo zip no Portal de distribuição de software. O arquivo zip contém o complemento CIF como Arquivo de recursos do Sling, não é um pacote de AEM. As listagens do SDK podem ser acessadas com uma licença do AEM as a Cloud Service.

TIP
Use sempre a versão mais recente do complemento CIF.

Configuração local

Para o desenvolvimento local do complemento CIF usando o AEM as a Cloud Service, siga estas etapas:

  1. Obtenha o SDK do AEM as a Cloud Service mais recente

  2. Descompacte o AEM .jar para que você possa criar o crx-quickstart pasta, execute:

    code language-bash
    java -jar <jar name> -unpack
    
  3. Crie uma pasta crx-quickstart/install

  4. Copie o arquivo de recursos Sling correto do complemento CIF na pasta crx-quickstart/install.

    O arquivo zip do complemento CIF contém dois arquivos .far de recursos Sling. Use o arquivo correto para autor ou publicação no AEM, dependendo de como você planeja executar o SDK do AEM as a Cloud Service local.

  5. Crie uma variável de ambiente do sistema operacional local chamada COMMERCE_ENDPOINT mantendo o endpoint do Adobe Commerce GraphQL.

    Exemplo macOS X:

    code language-bash
    export COMMERCE_ENDPOINT=https://<yourcommercesystem>/graphql
    

    Exemplo para Windows:

    code language-bash
    set COMMERCE_ENDPOINT=https://<yourcommercesystem>/graphql
    

    Essa variável é usada pelo AEM para se conectar ao sistema de comércio. Além disso, o complemento CIF inclui um proxy reverso local para disponibilizar o endpoint do Commerce GraphQL localmente. Esse proxy é usado pelas ferramentas de criação da CIF (console do produto e seletores) e para os componentes do lado do cliente da CIF que fazem chamadas diretas de GraphQL.

    Essa variável também deve ser configurada para o ambiente do AEM as a Cloud Service. Para obter mais informações sobre variáveis, consulte Configuração do OSGi para o AEM as a Cloud Service.

  6. (Opcional) Para ativar recursos de catálogo em etapas, você deve criar um token de integração para sua instância do Adobe Commerce. Siga as etapas em Introdução para criar o token.

    Definir um segredo OSGi com o nome COMMERCE_AUTH_HEADER ao seguinte valor:

    code language-xml
    Authorization: Bearer <Access Token>
    

    Para obter mais informações sobre segredos, consulte Configuração do OSGi para o AEM as a Cloud Service.

  7. Inicie o SDK do AEM as a Cloud Service

NOTE
Inicie o SDK as a Cloud Service do AEM na mesma janela de terminal em que a variável de ambiente foi definida na etapa 5. Se você iniciá-lo em uma janela de terminal separada ou clicando duas vezes no arquivo .jar, verifique se a variável de ambiente está visível.

Verifique a configuração por meio do console OSGI: http://localhost:4502/system/console/osgi-installer. A lista deve incluir os pacotes relacionados ao complemento CIF, o pacote de conteúdo e as configurações OSGI, conforme definido no arquivo de modelo de recurso.

Configuração do projeto project

Há duas maneiras de Bootstrap seu projeto da CIF para o AEM as a Cloud Service.

Usar o Arquétipo de projeto do AEM

A variável Arquétipo de projeto AEM O é a principal ferramenta para Bootstrap um projeto pré-configurado e começar a usar a CIF. Os Componentes principais da CIF e todas as configurações necessárias podem ser incluídos em um projeto gerado com uma opção adicional.

TIP
Sempre usar a versão mais recente do Arquétipo de projeto AEM então você pode gerar o projeto.

Consulte as instruções de uso do Arquétipo de projeto do AEM sobre como gerar um projeto do AEM. Para incluir a CIF no projeto, use o includeCommerce opção.

Por exemplo:

mvn -B org.apache.maven.plugins:maven-archetype-plugin:3.2.1:generate \
 -D archetypeGroupId=com.adobe.aem \
 -D archetypeArtifactId=aem-project-archetype \
 -D archetypeVersion=35 \
 -D appTitle="My Site" \
 -D appId="mysite" \
 -D groupId="com.mysite" \
 -D includeCommerce=y

Os Componentes principais da CIF podem ser utilizados em qualquer projeto incluindo os all pacote ou individualmente usando o pacote de conteúdo CIF e os pacotes OSGI relacionados. Para adicionar os Componentes principais da CIF manualmente a um projeto, use as seguintes dependências:

<dependency>
    <groupId>com.adobe.commerce.cif</groupId>
    <artifactId>core-cif-components-apps</artifactId>
    <type>zip</type>
    <version>x.y.z</version>
</dependency>
<dependency>
    <groupId>com.adobe.commerce.cif</groupId>
    <artifactId>core-cif-components-config</artifactId>
    <type>zip</type>
    <version>x.y.z</version>
</dependency>
<dependency>
    <groupId>com.adobe.commerce.cif</groupId>
    <artifactId>core-cif-components-core</artifactId>
    <version>x.y.z</version>
</dependency>
<dependency>
    <groupId>com.adobe.commerce.cif</groupId>
    <artifactId>graphql-client</artifactId>
    <version>x.y.z</version>
</dependency>
<dependency>
    <groupId>com.adobe.commerce.cif</groupId>
    <artifactId>magento-graphql</artifactId>
    <version>x.y.z</version>
</dependency>

Usar a loja de referência AEM Venia

Uma segunda opção para iniciar um projeto da CIF é clonar e usar a loja de referência AEM Venia. A loja de referência AEM Venia é um exemplo de aplicativo de vitrine de referência que demonstra o uso dos Componentes principais da CIF para o AEM. Ela serve como um conjunto de exemplos de práticas recomendadas e um possível ponto de partida para desenvolver sua própria funcionalidade.

Para começar a usar a loja de referência Venia, clone o repositório Git e comece a personalizar o projeto de acordo com suas necessidades.

NOTE
O projeto Loja de referência Venia contém dois perfis de construção para AEM as a Cloud Service e AEM 6.5. Marcar readme.md do projeto para que você possa ver como eles são usados.

Recursos adicionais

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab