Show Menu
TÓPICOS×

Desenvolver o AEM Commerce para o AEM as a Cloud Service

O desenvolvimento de projetos do AEM Commerce 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 AEM no AEM as a Cloud Service. Leia primeiro estes itens:

Desenvolvimento local com o SDK do AEM as a Cloud Service


Um ambiente de desenvolvimento local é recomendado para trabalhar com projetos da CIF. O complemento CIF disponibilizado para ambientes do 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.

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 . The zip file contains the CIF add-on as Sling Feature archive , it is not an AEM package. Observe que o acesso às listagens do SDK está limitado aos que têm uma licença do AEM as a Cloud Service.
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 criar a pasta crx-quickstart e execute:
    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 com o nome COMMERCE_ENDPOINT mantendo o ponto de extremidade GraphQL da Magento.
    Exemplo para Mac OSX:
    export COMMERCE_ENDPOINT=https://demo.magentosite.cloud/graphql
    
    
    Exemplo para Windows:
    set COMMERCE_ENDPOINT=https://demo.magentosite.cloud/graphql
    
    
    Essa variável também deve ser configurada para o ambiente do AEM as a Cloud Service.
  6. Inicie o SDK do AEM as a Cloud Service
  7. Start do servidor proxy GraphQL local
    Para disponibilizar o ponto de extremidade Magento GraphQL localmente para o suplemento CIF e os componentes CIF, use o seguinte comando. O endpoint GraphQL estará disponível em http://localhost:3002/graphql . Exemplo para Mac OSX:
    npx local-cors-proxy --proxyUrl https://demo.magentosite.cloud --port 3002 --proxyPartial ''
    
    
    Exemplo para Windows:
    npx local-cors-proxy --proxyUrl https://demo.magentosite.cloud --port 3002 --proxyPartial '""'
    
    
    O argumento --proxyPartial precisa receber uma string vazia.
    Você pode testar o proxy GraphQL local apontando uma ferramenta de query GraphQL para http://localhost:3002/graphql e testando alguns query.
  8. Faça logon no AEM SDK e configure o CIF para usar o servidor proxy GraphQL local
    Navegue até a configuração CIF Cloud Service (Ferramentas > Cloud Services > Configuração CIF). Abra a visualização de propriedades da configuração usada pelo seu projeto.
    Para a GraphQL Proxy Path propriedade, use o terminal do servidor proxy local http://localhost:3002/graphql . Salve a configuração.
Não empurre a configuração da etapa 8 para o repo do projeto. Essa configuração só é necessária para uma configuração de desenvolvimento local. AEM como ambientes Cloud Service já estão configurados com o proxy GraphQL durante a integração.
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

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

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 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 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 archetypeVersion=24 \
 -D aemVersion=cloud \
 -D appTitle="My Site" \
 -D appId="mysite" \
 -D groupId="com.mysite" \
 -D frontendModule=general \
 -D includeExamples=n \
 -D includeCommerce=y

Os Componentes principais da CIF podem ser utilizados em qualquer projeto mediante o pacote all fornecido ou de maneira separada, utilizando o pacote de conteúdo da 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-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, bem como 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.
O projeto da loja de referência Venia contém dois perfis de construção para o AEM as a Cloud Service e o AEM 6.5. Verifique o arquivo readme.md do projeto para ver como eles são usados.