Desenvolvimento do comércio de AEM develop
O desenvolvimento de projetos de comércio de AEM (CIF) para o Commerce integration framework segue as mesmas regras e práticas recomendadas de outros projetos de AEM AEM. Revise estes primeiro:
Desenvolvimento local para o comércio AEM local
Um ambiente de desenvolvimento local é recomendado para trabalhar com projetos de CIF.
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:
- AEM local 6.5
- Pacote de serviços do AEM 6.5 7 ou posterior
- Java 11
- Apache Maven (3.3.9 ou mais recente)
- Nó LTS
- npm 6+
- Git
Acesso ao complemento CIF
O complemento CIF pode ser baixado do Portal de distribuição de software, pesquise por "complemento de comércio do AEM".
Configuração local
Para o desenvolvimento de projetos locais de CIF usando o AEM e o complemento CIF, siga estas etapas:
-
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.
-
Descompacte o AEM .jar para criar a pasta
crx-quickstart
e execute:code language-bash java -jar <jar name> -unpack
-
Crie uma pasta
crx-quickstart/install
-
Copie todos os pacotes do complemento CIF, baixados do Portal de distribuição de software, na
crx-quickstart/install
pasta.
- 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 de comércio de AEM 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.
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.
classic
perfil.Conectar o AEM ao sistema de comércio
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 de comércio AEM e os componentes principais CIF se conectam ao terminal de comércio GraphQL por meio do servidor AEM 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.