Como depurar um aplicativo AEM usando o Eclipse

Para depurar um aplicativo AEM, você pode usar a depuração remota Java.

Descrição description

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 resolution

Para depurar um aplicativo AEM, você pode usar a depuração remota Java.

Aviso: não habilite a depuração remota no ambiente de produção, a menos que seja necessário, pois isso pode 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 à variável de ambiente CQ_JVM_OPTS do script crx-quickstart/bin/start (para que o servidor sempre inicie no modo de depuração).
  • Inclua-o como parâmetro ao iniciar o AEM diretamente com java -jar. 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 na nova configuração na tela Configurações de Depuração depois de salvá-la.
recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f