Desenvolvimento do AEM Commerce develop

O desenvolvimento de projetos de Commerce de AEM com base no Commerce integration framework (CIF) para o AEM AEM segue as mesmas regras e práticas recomendadas de outros projetos de. Revise estes primeiro:

Desenvolvimento local para o AEM Commerce local

Um ambiente de desenvolvimento local é recomendado para trabalhar com projetos de CIF.

NOTE
As instruções a seguir ajudam a configurar um ambiente de desenvolvimento de AEM local para o AEM Commerce usando CIF com foco para o AEM 6.5). Se você estiver usando o AEM as a Cloud Service, consulte a AEM Commerce as a Cloud Service documentação.

O complemento de comércio AEM para AEM 6.5 também conhecido como. O complemento CIF também está disponível para desenvolvimento local e é fornecido como um pacote AEM. Ele pode ser baixado do Portal de distribuição de software como um pacote de recursos.

Software necessário

Devem ser instalados:

Acesso ao complemento CIF

O complemento CIF pode ser baixado do Portal de distribuição de software, pesquise por "complemento AEM Commerce".

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

Configuração local

Para o desenvolvimento de projetos locais de CIF usando o AEM e o complemento CIF, siga estas etapas:

  1. Obtenha a versão AEM 6.5 e instale o AEM 6.5 Service Pack. O AEM 6.5 Service Pack 7 é necessário, no entanto, a Adobe recomenda instalar o último service pack disponível.

  2. Descompacte o AEM .jar para criar a pasta crx-quickstart e execute:

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

  4. Copie todos os pacotes do complemento CIF, baixados do Portal de distribuição de software, na crx-quickstart/install pasta.

TIP
Como alternativa, o pacote complementar do CIF também pode ser instalado por meio do Gerenciador de pacotes.
  1. Iniciar o início rápido do AEM

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. Verifique se todos os pacotes foram iniciados.

Configuração do projeto project

Há duas maneiras de começar seu projeto AEM Commerce usando CIF.

Usar o Arquétipo de projeto do AEM

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

TIP
Use o Arquétipo de projeto do AEM 25 ou posterior para 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 a opção includeCommerce.

Por exemplo:

mvn -B archetype:generate \
 -D archetypeGroupId=com.adobe.granite.archetypes \
 -D archetypeArtifactId=aem-project-archetype \
 -D aemVersion=6.5.5 \
 -D appTitle="My Site" \
 -D appId="mysite" \
 -D groupId="com.mysite" \
 -D frontendModule=general \
 -D includeExamples=n \
 -D includeCommerce=y

Componentes principais do CIF podem ser usados em qualquer projeto, incluindo os all pacote ou indivíduo 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, basta clonar 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. Verifique a readme.md do projeto para ver como são usados. Para o AEM 6.5, use o classic perfil.

Conectar o AEM ao sistema Commerce

Para conectar seu projeto ao sistema de comércio, o AEM deve ser configurado com o terminal GraphQL do sistema de comércio.

Ambos, um projeto gerado pelo Arquétipo de projeto AEM ou o Loja de referência AEM Venia, já inclui um configuração padrão que deve ser ajustado.

Substitua o valor de url in com.adobe.cq.commerce.graphql.client.impl.GraphqlClientImpl~default.cfg.json com o terminal GraphQL do sistema de comércio usado pelo projeto.

O complemento AEM Commerce e os componentes principais do CIF se conectam ao endpoint comercial do GraphQL AEM por meio do servidor e diretamente pelo navegador. Os Componentes principais do CIF do lado do cliente e as ferramentas de criação do complemento CIF por padrão se conectam a /api/graphql. Se necessário, isso pode ser ajustado por meio da configuração de Cloud Service CIF (veja abaixo).

O complemento CIF fornece um servlet proxy do GraphQL em /api/graphql. Se você não planeja usar um AEM Dispatcher local, é recomendável configurar também o servlet proxy do GraphQL.

Navegue até http://localhost:4502/system/console/configMgr e crie uma configuração OSGI para o Adobe CIF GraphQL Proxy Configuration serviço. Use o mesmo endpoint do GraphQL do sistema de comércio usado para o cliente GraphQL acima.

Recursos adicionais

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2