Como depurar um aplicativo AEM usando o Eclipse

Última atualização em 2023-11-16

Para depurar um aplicativo AEM, é possível usar Depuração remota Java.

Descrição

Ambiente

  • Adobe Experience Manager (AEM) 6.4
  • Adobe Experience Manager (AEM) 6.5

Problemas/Sintomas

Como depurar um aplicativo em execução em um servidor AEM remoto (ou local)?

Resolução

Para depurar um aplicativo AEM, é possível usar Depuração remota Java.

Aviso: Não ative a depuração remota no ambiente de produção, a menos que isso seja necessário, pois poderia afetar muito o desempenho do aplicativo.

Etapa 1: adicionar o parâmetro JVM da depuração remota

Para usar a depuração remota, você deve iniciar o AEM com este parâmetro JVM:
-agentlib:jdwp=transport=dt_socket,address=8000,server=y,suspend=n

Você pode adicionar o parâmetro seguindo qualquer um destes procedimentos:

  • Adicione-o ao seu crx-quickstart/bin/start script CQ_JVM_OPTS variável de ambiente (para que o servidor sempre inicie no modo de depuração).
  • Incluí-lo como parâmetro ao iniciar o AEM com java -jar diretamente. Por exemplo, java -Xmx512m -agentlib:jdwp=transport=dt_socket,address=8000,server=y,suspend=n -jar cq-author-4502.jar

Notas

  • Se necessário, você pode alterar a porta definida em "…,address=8000,…" de 8000 para algo que funcione melhor em seu ambiente.
  • Se você observar que não está funcionando, evite bifurcar o processo java especificando a opção de linha de comando -nofork.
  • O script de inicialização está localizado em crx-quickstart/bin

Etapa 2: iniciar uma sessão de depuração remota

Para iniciar uma sessão de depuração remota do Eclipse, faça o seguinte:

  1. Abra o Eclipse.
  2. Escolher Executar >  Configurações de depuração.
  3. Clique com o botão direito do mouse em Aplicações Java remotas e selecione Novo.
  4. Selecione o projeto AEM em Projeto.
  5. Digite a porta na configuração "address" do parâmetro jvm definido acima. No exemplo, é a porta 8000 (e o nome do host da máquina à qual você está se conectando, provavelmente localhost)
  6. Para iniciar uma sessão de depuração, clique duas vezes no nova configuração na tela Configurações de depuração depois de salvá-la.

Nesta página