O SDK do AEM as a Cloud Service aem-as-a-cloud-service-sdk

O SDK do AEM as a Cloud Service é composto pelos seguintes artefatos:

  • Quickstart Jar - O tempo de execução do AEM usado para o desenvolvimento local
  • Jar da API Java™ - A dependência Java™ Jar/Maven que expõe todas as APIs Java™ permitidas que podem ser usadas para desenvolvimento em relação ao AEM as a Cloud Service. Anteriormente conhecido como Uberjar
  • Jar do Javadoc - Os javadocs do Jar da API Java™
  • Ferramentas do Dispatcher - O conjunto de ferramentas usadas para desenvolver localmente em relação ao Dispatcher. Artefatos separados para UNIX® e Windows

Além disso, alguns clientes que foram implantados anteriormente com AEM 6.5 ou versões anteriores usam os artefatos abaixo. Se a compilação local não estiver funcionando com o Quickstart jar e você suspeitar que isso ocorre devido à remoção de interfaces do AEM implantado no as a Cloud Service, entre em contato com o Suporte ao cliente. Eles podem determinar se você precisa de acesso. Requer alterações no back-end.

  • 6.5 Jar da API Java™ obsoleta - um conjunto extra de interfaces que foram removidas desde o AEM 6.5
  • 6.5 Jar Javadoc obsoleto - os Javadocs do conjunto adicional de interfaces
NOTE
Há diferenças entre o AEM as a Cloud Service e o SDK em várias áreas diferentes. Para situações em que são necessárias alterações rápidas e iterativas, o Adobe introduziu os ambientes de desenvolvimento rápido. Consulte os Ambientes de desenvolvimento rápido para obter mais informações.

Criação para o SDK building-for-the-sdk

O SDK do AEM as a Cloud Service é usado para criar e implantar código personalizado. Consulte a documentação do Arquétipo de projeto do AEM. Em um nível superior, as seguintes etapas são executadas:

  • Código de compilação. Conforme esperado, o código-fonte é compilado, gerando os pacotes de conteúdo resultantes
  • Criar artefatos. Os artefatos são criados durante esse processo
  • Analisar pacotes. Os pacotes são analisados usando o plug-in Maven Analyzer, que procura problemas no projeto Maven, como dependências ausentes
  • Implantar artefatos. Os artefatos são implantados no servidor local.

As mesmas etapas são executadas pela Cloud Manager ao implantar em ambientes de nuvem. A execução de builds localmente permite o desenvolvimento e o teste locais. Os desenvolvedores podem descobrir problemas de código ou estruturais com eficiência antes de confirmar o controle de origem e acionar as implantações do Cloud Manager, que podem levar mais tempo.

NOTE
O SDK do AEM as a Cloud Service deve ser compilado com uma distribuição e uma versão do Java suportadas pelo ambiente de compilação da Cloud Manager. Os clientes da AEM as a Cloud Service podem baixar o JDK do Oracle no Portal de distribuição de software e ter o Suporte estendido para Java 11 até setembro de 2026, devido ao licenciamento do Adobe e aos termos de suporte para a tecnologia Java do Oracle quando usada em projetos da Adobe Experience Manager.

Acesso ao SDK do AEM as a Cloud Service accessing-the-aem-as-a-cloud-service-sdk

  • Você pode verificar o ícone AEM Admin Console Sobre o Adobe Experience Manager AEM para descobrir a versão do que você está executando na produção.
  • O jar de início rápido e as Ferramentas do Dispatcher podem ser baixadas como um arquivo zip no Portal de distribuição de software. O acesso às listagens do SDK é limitado a pessoas que têm ambientes no AEM Managed Services ou AEM as a Cloud Service.
  • O Jar da API Java™ e o Jar do Javadoc podem ser baixados por meio das ferramentas maven, seja pela linha de comando ou com o IDE de sua preferência.
  • Os poms de projeto maven devem fazer referência ao seguinte pacote Jar de API. A dependência de poms de qualquer subpacote também deve ser referenciada.
<dependency>
  <groupId>com.adobe.aem</groupId>
  <artifactId>aem-sdk-api</artifactId>
  <version>2019.11.3006.20191108T223635Z-191201</version>
  <scope>provided</scope>
</dependency>
NOTE
A entrada da versão do SDK deve corresponder à versão do AEM as a Cloud Service. Você pode ver qual versão está usando ao fazer logon no AEM. No canto superior direito da tela, vá para o ponto de interrogação e selecione Sobre o Adobe Experience Manager.

Atualizar um projeto local com uma nova versão do SDK refreshing-a-local-project-with-a-new-skd-version

Quando é recomendado atualizar o projeto local com um novo SDK?

O Adobe recomenda atualizá-lo após uma versão de manutenção mensal.

É opcional atualizá-lo após qualquer versão de manutenção diária. Os clientes são informados quando sua instância de produção é atualizada com êxito para uma nova versão do AEM. Para as versões de manutenção diárias, não é esperado que o novo SDK tenha mudado significativamente, se é que mudou. Ainda assim, é recomendável atualizar ocasionalmente o ambiente de desenvolvedor do AEM local com o SDK mais recente e, em seguida, recriar e testar o aplicativo personalizado. A versão de manutenção mensal geralmente inclui alterações mais impactantes e, portanto, os desenvolvedores devem atualizar, reconstruir e testar imediatamente.

Abaixo está o procedimento recomendado para atualizar um ambiente local:

  1. Verifique se qualquer conteúdo útil está comprometido com o projeto no controle do código-fonte ou disponível em um pacote de conteúdo mutável para importação posterior.
  2. O conteúdo do teste de desenvolvimento local deve ser armazenado separadamente para que não seja implantado como parte da build do pipeline do Cloud Manager. O motivo é que ele é usado apenas para desenvolvimento local.
  3. Interrompe a inicialização rápida em execução no momento.
  4. Mova a pasta crx-quickstart para uma pasta diferente para manter a pasta segura.
  5. Observe a nova versão do AEM, que é anotada no Cloud Manager (ela é usada para identificar a nova versão do QuickStart Jar para baixar mais).
  6. Baixe o QuickStart JAR cuja versão corresponda à versão do AEM de produção no Portal de distribuição de software.
  7. Crie uma pasta totalmente nova e coloque o novo QuickStart Jar dentro dela.
  8. Inicie o novo QuickStart com os modos de execução desejados (renomeando o arquivo ou transmitindo os modos de execução por meio do -r).
    • Verifique se não há vestígios do início rápido antigo na pasta.
  9. Crie seu aplicativo AEM.
  10. Implante o aplicativo AEM no AEM local por meio do Gerenciador de pacotes.
  11. Instale todos os pacotes de conteúdo mutável necessários para o teste do ambiente local por meio do Gerenciador de pacotes.
  12. Prossiga com o desenvolvimento e implante as alterações conforme necessário.

Se houver conteúdo que deva ser instalado a cada nova versão de início rápido do AEM, inclua-o em um pacote de conteúdo e no controle de origem do projeto. Em seguida, instale-o sempre.

A recomendação é atualizar o SDK com frequência (por exemplo, duas vezes por semana) e descartar o estado local completo diariamente para não depender acidentalmente de dados com estado no aplicativo.

Se você depender do CryptoSupport (configurando as credenciais dos serviços na nuvem ou o serviço de email SMTP no AEM ou usando a API CryptoSupport no aplicativo), as propriedades criptografadas serão criptografadas por uma chave. Essa chave é gerada automaticamente no primeiro início de um ambiente AEM. Embora a configuração da nuvem trate da reutilização automática da CryptoKey específica do ambiente, é necessário injetar a cryptokey no ambiente de desenvolvimento local.

Por padrão, o AEM é configurado para armazenar os dados principais na pasta de dados de uma pasta, mas, para facilitar a reutilização no desenvolvimento, o processo AEM pode ser inicializado na primeira inicialização com "-Dcom.adobe.granite.crypto.file.disable=true". Este processo gera os dados de criptografia em "/etc/key".

Para poder reutilizar pacotes de conteúdo que contenham os valores criptografados, siga estas etapas:

  • Ao iniciar inicialmente o quickstart.jar local, adicione o parâmetro abaixo: "-Dcom.adobe.granite.crypto.file.disable=true". É recomendável, mas opcional, sempre adicioná-lo.
  • Na primeira vez que você iniciou uma instância, crie um pacote que contenha um filtro para a raiz "/etc/key". Esse pacote contém o segredo a ser reutilizado em todos os ambientes para os quais você deseja que eles sejam reutilizados.
  • Exporte qualquer conteúdo mutável que contenha segredos ou procure os valores criptografados por meio do /crx/de para poder adicioná-lo ao pacote que é reutilizado nas instalações.
  • Sempre que você gerar uma nova instância (para substituir por uma nova versão ou como vários ambientes de desenvolvimento devem compartilhar as credenciais para teste), instale o pacote produzido nas etapas 2 e 3. Isso permite reutilizar o conteúdo sem a necessidade de reconfigurar manualmente. O motivo é porque agora a chave de criptografia está sincronizada.
recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab