Desenvolver o AEM Commerce para o AEM as a Cloud Service develop
O desenvolvimento de projetos do AEM Commerce, com base no Commerce integration framework (CIF) para o AEM as a Cloud Service AEM, segue as mesmas regras e práticas recomendadas de outros projetos do no AEM 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 do AEM as a Cloud Service.
Software necessário
Devem ser instalados:
- SDK do AEM as a Cloud Service
- Java™ 11
- Apache Maven (3.3.9 ou mais recente)
- Node.js v10+
- npm 6+
- Git
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 Sling, não é um pacote AEM. As listagens do SDK podem ser acessadas com uma licença do AEM as a Cloud Service.
Configuração local
Para o desenvolvimento local do complemento CIF usando o AEM as a Cloud Service, siga estas etapas:
-
Obtenha o SDK do AEM as a Cloud Service mais recente
-
Descompacte o AEM .jar para que você possa criar a pasta
crx-quickstart
e execute:code language-bash java -jar <jar name> -unpack
-
Crie uma pasta
crx-quickstart/install
-
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. -
Crie uma variável de ambiente do sistema operacional local com o nome
COMMERCE_ENDPOINT
que contenha o ponto de extremidade 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 do CIF (console do produto e seletores) e para os componentes do lado do cliente 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 Configurar OSGi para AEM as a Cloud Service.
-
(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.
Defina um segredo OSGi com o nome
COMMERCE_AUTH_HEADER
com o seguinte valor:code language-xml Authorization: Bearer <Access Token>
Para obter mais informações sobre segredos, consulte Configuração de OSGi para AEM as a Cloud Service.
-
Inicie o SDK do AEM as a Cloud Service
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 CIF para o AEM as a Cloud Service.
Usar o Arquétipo de projeto do AEM
O Arquétipo de Projeto AEM é a principal ferramenta para Bootstrap um projeto pré-configurado e começar a usar o 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.
Consulte as instruções de uso do Arquétipo de projeto do AEM sobre como gerar um projeto do AEM. Para incluir CIF no projeto, use a opção includeCommerce
.
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 do CIF podem ser usados em qualquer projeto incluindo o pacote all
fornecido ou individualmente usando o pacote de conteúdo CIF e os pacotes OSGI relacionados. Para adicionar manualmente os Componentes principais do CIF 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.