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 documentação do AEM Commerce as a Cloud Service.

O complemento AEM Commerce 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 no Portal de distribuição de software e procure 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 pasta crx-quickstart/install.

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

Os Componentes principais do CIF podem ser usados em qualquer projeto incluindo o pacote all fornecido ou um 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 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 o arquivo readme.md do projeto para ver como eles são usados. Para AEM 6.5, use o perfil classic.

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 pelo Armazenamento de Referência AEM Venia, já incluem uma configuração padrão que deve ser ajustada.

Substitua o valor de url em com.adobe.cq.commerce.graphql.client.impl.GraphqlClientImpl~default.cfg.json pelo ponto de extremidade 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 ao /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 serviço Adobe CIF GraphQL Proxy Configuration. 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