DocumentaçãoAEM 6.5Guia do usuário

Como desenvolver projetos AEM usando o IntelliJ IDEA how-to-develop-aem-projects-using-intellij-idea

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Tópicos:

Criado para:

  • Desenvolvedor

Visão geral overview

Para começar a usar o desenvolvimento do AEM no IntelliJ, as seguintes etapas são necessárias.

Cada etapa é explicada com mais detalhes no restante deste tópico.

  • Instalar IntelliJ
  • Configurar o projeto do AEM com base no Maven
  • Preparar suporte JSP para IntelliJ no POM Maven
  • Importar o projeto Maven para o IntelliJ
NOTE
Este guia é baseado no IntelliJ IDEA Ultimate Edition 12.1.4 e AEM 5.6.1.

Instalar IntelliJ IDEA install-intellij-idea

Baixe o IntelliJ IDEA da página Downloads na JetBrains.

Em seguida, siga as instruções de instalação nessa página.

Configurar o projeto do AEM com base no Maven set-up-your-aem-project-based-on-maven

Em seguida, configure seu projeto usando o Maven conforme descrito em Como criar projetos AEM usando o Apache Maven.

Para começar a trabalhar com Projetos AEM no IntelliJ IDEA, a configuração básica no Introdução em 5 Minutos é suficiente.

Preparar suporte JSP para IntelliJ IDEA prepare-jsp-support-for-intellij-idea

O IntelliJ IDEA também pode fornecer suporte ao trabalhar com JSP, por exemplo:

  • preenchimento automático de bibliotecas de tags
  • reconhecimento de objetos definidos por <cq:defineObjects /> e <sling:defineObjects />

Para que isso funcione, siga as instruções em Como trabalhar com JSPs em Como criar projetos de AEM usando o Apache Maven.

Importar o projeto Maven import-the-maven-project

  1. Abra a caixa de diálogo Importar no IntelliJ IDEA por

    • selecionando Importar projeto na tela de boas-vindas se ainda não houver um projeto aberto
    • selecionando Arquivo > Importar projeto no menu principal

  2. Na caixa de diálogo Importar, selecione o arquivo POM do projeto.

    chlimage_1-45

  3. Continue com as configurações padrão, conforme mostrado na caixa de diálogo abaixo.

    chlimage_1-46

  4. Continue nas caixas de diálogo a seguir clicando em Avançar e Concluir.

  5. Agora você está configurado para Desenvolvimento AEM usando IntelliJ IDEA

    chlimage_1-47

Depurando JSPs com IntelliJ IDEA debugging-jsps-with-intellij-idea

As etapas a seguir são necessárias para depurar JSPs com o IntelliJ IDEA

  • Configurar uma faceta da Web no projeto
  • Instalar o plug-in de suporte a JSR45
  • Configurar um perfil de depuração
  • Configurar o AEM para o modo de depuração

Configurar uma faceta da Web no projeto set-up-a-web-facet-in-the-project

O IntelliJ IDEA deve entender onde encontrar os JSPs para depuração. Como o IDEA não pode interpretar as configurações de content-package-maven-plugin, ele deve ser configurado manualmente.

  1. Ir para Arquivo > Estrutura de Projeto
  2. Selecione o módulo Conteúdo
  3. Clique em + acima da lista de módulos e selecione Web
  4. Como o Diretório de Recursos da Web, selecione o content/src/main/content/jcr_root subdirectory do seu projeto, conforme mostrado na captura de tela abaixo.

chlimage_1-48

Instalar o plug-in de suporte a JSR45 install-the-jsr-support-plugin

  1. Vá para o painel Plug-ins nas configurações do IntelliJ IDEA
  2. Navegue até o Plug-in Integração JSR45 e marque a caixa de seleção ao lado dele
  3. Clique em Aplicar
  4. Reiniciar o IntelliJ IDEA quando solicitado a

chlimage_1-49

Configurar um perfil de depuração configure-a-debug-profile

  1. Ir para Executar > Editar configurações
  2. Clique em + e selecione Remoto de JSR45
  3. Na caixa de diálogo de configuração, selecione Configurar ao lado de Servidor de Aplicativos e configure um servidor Genérico
  4. Defina a página inicial com um URL apropriado se desejar abrir um navegador ao iniciar a depuração
  5. Remova todas as tarefas Antes da inicialização se você usar a sincronização automática de vlt ou configurar as tarefas apropriadas do Maven se não usar
  6. No painel Inicialização/Conexão, ajuste a porta, se necessário
  7. Copiar os argumentos de linha de comando propostos pelo IntelliJ IDEA

chlimage_1-50 chlimage_1-51

Configurar o AEM para o modo de depuração configure-aem-for-debug-mode

A última etapa necessária é iniciar o AEM com as opções JVM propostas pelo IntelliJ IDEA.

Inicie o arquivo jar AEM diretamente e adicione essas opções, por exemplo, com a seguinte linha de comando:

java -Xdebug -Xrunjdwp:transport=dt_socket,address=58242,suspend=n,server=y -Xmx1024m -jar cq-quickstart-6.5.0.jar

Você também pode adicionar essas opções ao seu script de inicialização em crx-quickstart/bin/start, conforme mostrado abaixo.

# ...

# default JVM options
if [ -z "$CQ_JVM_OPTS" ]; then
 CQ_JVM_OPTS='-server -Xmx1024m -Djava.awt.headless=true'
fi

CQ_JVM_OPTS="$CQ_JVM_OPTS -Xdebug -Xrunjdwp:transport=dt_socket,address=58242,suspend=n,server=y"

# ...

Iniciar Depuração start-debugging

Agora você está configurado para depurar os JSPs no AEM.

  1. Selecione Executar > Depurar > Seu Perfil De Depuração
  2. Definir pontos de interrupção no código do componente
  3. Acessar uma página no seu navegador

chlimage_1-52

Depurando pacotes com IntelliJ IDEA debugging-bundles-with-intellij-idea

O código em pacotes pode ser depurado usando uma conexão de depuração remota genérica padrão. Você pode seguir a documentação do Jetbrain sobre depuração remota.

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2