Documentação

Resolver a incompatibilidade de versão do Java Runtime no pipeline de produção do AEM

Last update: Mon May 05 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Este artigo fornece uma solução para quando os estágios de compilação e teste de unidade do Adobe Experience Manager (AEM as a Cloud Service) falharem devido a uma incompatibilidade de versão do Java Runtime. A solução envolve o downgrade do plug-in do pacote Maven e a garantia de configurações de ambiente consistentes.

Descrição description

Ambiente

Adobe Experience Manager (AEM) as a Cloud Service - Sites

Problema/Sintomas

Durante os estágios de compilação e teste de unidade do pipeline de produção para a ramificação principal, ocorrem falhas. A mensagem de erro indica uma incompatibilidade de API devido a uma incompatibilidade nas versões do Java Runtime usadas durante compilações do Maven. O maven-bundle-plugin versão 6.0.0 precisa do Java 17, mas a AEM Cloud só é compatível com o Java 11, resultando em uma incompatibilidade.

Resolução resolution

  1. Fazer downgrade do plug-in do pacote Maven. Modifique o arquivo pom.xml nas seções <build>, <pluginManagement> e <plugins> e certifique-se de especificar uma versão compatível do maven-bundle-plugin. As versões recomendadas são 5.1.9 ou inferiores, pois são compatíveis com Java 8 e 11:

    code language-none 
    <build>
    <pluginManagement>
        <plugins>

...

            <plugin>
                <groupId>org.apache.felix</groupId>
                <artifactId>maven-bundle-plugin</artifactId>
                <version>5.1.2</version>
                <inherited>true</inherited>
            </plugin>

...

        </plugins>
    </pluginManagement>
</build>

  2. Se as discrepâncias persistirem entre os ambientes, considere limpar os artefatos em cache usando as APIs apropriadas fornecidas pela documentação do Adobe Cloud Manager. Para ver as etapas, consulte Visão geral - API Cloud Manager na documentação do desenvolvedor do Adobe.

  3. Verifique a configuração de base de código (pom.xml) para quaisquer entradas que possam assumir o padrão de versões de plug-in não suportadas. Para ver as etapas, consulte Pacote de estrutura do repositório no Guia do Usuário de Estrutura de Projeto AEM.

  4. Confirme se os pipelines de Desenvolvimento e Produção usam configurações consistentes em relação a dependências e plug-ins.

Se você tiver resolvido os problemas de compatibilidade dos requisitos de tempo de execução do Java, agora será possível executar testes de build e unidade com êxito em todos os ambientes na configuração do AEM as a Cloud Service.

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