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 de a página Downloads em JetBrains.

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

Configure seu projeto AEM com base em Maven

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

Para o start de trabalhar com projetos AEM no IntelliJ IDEA, a configuração básica em 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
  • 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 AEM usando o Apache Maven.

Importar o projeto Maven

  1. Abra 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 com as seguintes caixas de diálogo clicando em Next e Finish.

  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

Configure um Web Facet no Project

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

  1. Ir para Ficheiro -> Estrutura do Projeto
  2. Selecione o módulo Content
  3. Clique em + acima da lista dos módulos e selecione Web
  4. Como o Diretório de recursos da Web, selecione 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 Integração JSR45 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. Vá para Executar -> Editar configurações
  2. Pressione + e selecione JSR45 Remote
  3. Na caixa de diálogo de configuração, selecione Configurar ao lado de Servidor de Aplicações 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 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 em crx-quickstart/bin/start, conforme mostrado 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 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 Jetbrain em depuração remota.

Nesta página

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now