Documentação

Problemas ao atualizar para a versão 21 do Java no AEMaaCS - Assets

Last update: Thu Mar 20 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Ao tentar atualizar para a versão 21 do Java para AEMaaCS - ocorrem problemas com o Assets e falhas de build, verifique a configuração do pacote, verifique a compatibilidade de dependências, atualize a configuração de build, defina a versão do JDK Maven e execute testes de validação.

Descrição description

Ambiente

Adobe Experience Manager as a Cloud Service - Assets (AEMaaCS - Assets)

Problema

Ao tentar atualizar para o Java versão 21 para o Adobe Experience Manager (AEM) as a Cloud Service - Assets, ocorrem falhas de build.

  • Falhas de build com mensagens de erro indicando requisitos ausentes do ambiente de execução OSGi.
  • Erros específicos ocorrem de forma semelhante a: osgi.ee; filter:="(osgi.ee=UNKNOWN)" no nível inicial 20, mas nenhum artefato está fornecendo um recurso correspondente nesse nível inicial.
  • Erros adicionais ocorrem durante a execução do Maven, exigindo compatibilidade de versão do Java.

Resolução resolution

Para resolver os problemas encontrados ao atualizar para o Java versão 21, siga estas etapas:

  1. Examine o MANIFEST.MFarquivo do pacote que não foi iniciado.

    • Verifique se o cabeçalho Bundle-RequiredExecutionEnvironment especifica um ambiente de execução Java válido (Por exemplo: JavaSE-11). Se ele mostrar DESCONHECIDO, pode haver uma configuração incorreta ou um pacote corrompido.

  2. Verifique se todas as dependências, incluindo as transitivas, são compatíveis com o Java versão 21.

    • A atualização do Java pode levar a incompatibilidades em bibliotecas ou estruturas de terceiros; verifique se todas as dependências são atualizadas adequadamente.

  3. Verifique as ferramentas de configuração de build (Por exemplo: Maven, Gradle) para obter as configurações corretas alinhadas à versão 21 do Java.

    • Atualizar scripts de implantação, se necessário, para refletir as alterações na versão do Java ou nas configurações do contêiner OSGi.

  4. Crie um arquivo .cloudmanager/java-version na ramificação do repositório Git usada pelo pipeline.

    • Edite este arquivo para que ele contenha apenas 21. Isso garante que o Oracle Java 21 seja usado durante o processo de criação.

  5. Depois de definir a ramificação e atualizar as configurações, execute os testes de validação por meio do pipeline DEV da Cloud Manager usando a ramificação configurada.

Seguindo essas etapas, você deve ser capaz de atualizar e configurar com êxito o ambiente do AEM para uso com o Java versão 21 sem encontrar erros de build relacionados aos ambientes OSGi ou às configurações Maven.

recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f