Como desenvolver projetos AEM usando o IntelliJ IDEA

Visão geral

Para começar a desenvolver AEM IntelliJ, são necessárias as etapas a seguir.

Cada uma delas é explicada mais detalhadamente no restante deste Como.

  • Instalar o IntelliJ
  • Configure seu projeto AEM com base no Maven
  • Preparar suporte JSP para IntelliJ no Maven POM
  • Importar o projeto Maven para o IntelliJ
Observação

Este guia é baseado no IntelliJ IDEA Ultimate Edition 12.1.4 e AEM 5.6.1.

Instale o IntelliJ IDEA

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

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

Configure seu projeto AEM com base no Maven

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

Para o start de trabalhar com projetos AEM no IntelliJ IDEA, a configuração básica na Introdução em 5 minutos é suficiente.

Preparar suporte JSP para IntelliJ IDEA

A IntelliJ IDEA também pode fornecer suporte ao trabalho com a JSP, por exemplo,

  • conclusão automática de bibliotecas de tags
  • sensibilização para os objetos definidos por <cq:defineObjects /> e <sling:defineObjects />

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

Importar o projeto Maven

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

    • selecionando Importar projeto na tela de boas-vindas se você ainda não tiver um projeto aberto
    • selecionando Arquivo -> Importar projeto no menu principal
  2. Na caixa de diálogo Importar, selecione o arquivo POM do seu 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 pelas seguintes caixas de diálogo clicando em Avançar e em Concluir.

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

    chlimage_1-47

Depuração de JSPs com IntelliJ IDEA

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

  • Configurar um Web Facet no projeto
  • Instale o plug-in de suporte JSR45
  • Configurar um Perfil de depuração
  • Configurar AEM para o modo de depuração

Configurar um Web Facet no projeto

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

  1. Ir para Arquivo -> Estrutura do Projeto
  2. Selecione o módulo Conteúdo
  3. Clique + acima da lista dos 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 como mostrado na captura de tela abaixo.

chlimage_1-48

Instale o plug-in de suporte JSR45

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

chlimage_1-49

Configurar um Perfil de depuração

  1. Ir para Executar -> Editar configurações
  2. Pressione as teclas + e selecione JSR45 Remote
  3. Na caixa de diálogo de configuração, selecione Configurar ao lado do Servidor ​de aplicativos e configure um servidor Genérico
  4. Defina a página do start como um URL apropriado se quiser abrir um navegador quando você start a depuração
  5. Remova todas as tarefas Antes de iniciar o se você usar a sincronização automática vlt ou configurar as tarefas Maven apropriadas se você não
  6. No painel Inicialização/Conexão , ajuste a porta, se necessário
  7. Copie os argumentos da linha de comando que o IntelliJ IDEA propõe

chlimage_1-50 chlimage_1-51

Configurar AEM para o modo de depuração

O último passo necessário é o start do AEM com as opções de JVM propostas pela IntelliJ IDEA.

Você pode fazer isso iniciando o arquivo jar AEM diretamente e adicionando essas opções, por exemplo, com a seguinte linha de comando:

java -Xdebug -Xrunjdwp:transport=dt_socket,address=58242,suspend=n,server=y -Xmx1024m -XX:MaxPermSize=256M -jar cq-quickstart-5.6.1.jar

Também é possível adicionar essas opções ao script do start, conforme mostrado crx-quickstart/bin/start abaixo.

# ...

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

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

# ...

Depuração de Start

Agora, todos os usuários estão configurados para depurar seus 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

Depuração de pacotes com o 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 em depuraçãoremota.

Nesta página