Como desenvolver projetos AEM usando o IntelliJ IDEA
CAUTIONVisão geral
Para começar a usar AEM desenvolvimento no IntelliJ, as etapas a seguir são necessárias.
Cada um deles é explicado mais detalhadamente no restante deste "Como".
- Instalar o IntelliJ
- Configure seu projeto de AEM com base em Maven
- Preparar o suporte JSP para IntelliJ no POM Maven
- Importar o projeto Maven para o IntelliJ
NOTEInstalar o IntelliJ IDEA
Baixe o IntelliJ IDEA a partir de a página Downloads no JetBrains.
Em seguida, siga as instruções de instalação nessa página.
Configure seu projeto de AEM com base em Maven
Em seguida, configure o 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 em Introdução em 5 minutos for suficiente.
Preparar suporte JSP para IntelliJ IDEA
O IntelliJ IDEA também pode fornecer suporte ao trabalhar com o JSP, por exemplo
- preenchimento automático de bibliotecas de tags
- conhecimento dos objetos definidos pelo
<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
-
Abra o Importar diálogo no IntelliJ IDEA por
- seleção Importar projeto na tela de boas-vindas se você ainda não tiver nenhum projeto aberto
- seleção Arquivo -> Importar projeto no menu principal
-
Na caixa de diálogo Importar, selecione o arquivo POM do seu projeto.
-
Continue com as configurações padrão, conforme mostrado na caixa de diálogo abaixo.
-
Continue pelas caixas de diálogo a seguir clicando em Próximo e Concluir.
-
Agora você está configurado para Desenvolvimento de AEM usando o IntelliJ IDEA
Depuração de JSPs com IntelliJ IDEA
As etapas a seguir são necessárias para depurar JSPs com IntelliJ IDEA
- Configurar uma faceta da Web no projeto
- Instalar o plug-in de suporte JSR45
- Configurar um perfil de depuração
- Configurar AEM para o modo de depuração
Configurar uma faceta da Web no projeto
O IntelliJ IDEA precisa entender onde encontrar os JSPs para depuração. Como o IDEA não pode interpretar o content-package-maven-plugin , isso precisa ser configurado manualmente.
- Ir para Arquivo -> Estrutura do projeto
- Selecione o Conteúdo módulo
- Clique em + acima da lista de módulos e selecione Web
- Como o Diretório de Recursos da Web, selecione o
content/src/main/content/jcr_root subdirectorydo seu projeto, como mostrado na captura de tela abaixo.
Instalar o plug-in de suporte JSR45
- Vá para o Plug-ins painel nas configurações do IntelliJ IDEA
- Navegue até o Integração JSR45 Plug-in e marque a caixa de seleção ao lado dele
- Clique em Aplicar
- Reinicie o IntelliJ IDEA quando solicitado
Configurar um perfil de depuração
- Ir para Executar -> Editar configurações
- Ocorra o + e selecione Remoto JSR45
- Na caixa de diálogo de configuração, selecione Configurar ao lado de Servidor de aplicativos e configurar um servidor Genérico
- Defina a página inicial como um URL apropriado se desejar abrir um navegador quando você começar a depurar
- Remover tudo Antes do lançamento tarefas se você usar vlt autosync ou configurar as tarefas apropriadas do Maven se você não
- No Inicialização/Conexão ajustar a porta, se necessário
- Copie os argumentos da linha de comando que o IntelliJ IDEA propõe
Configurar AEM para o modo de depuração
A última etapa necessária é iniciar o AEM com as opções da JVM propostas pelo 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 de início em crx-quickstart/bin/start conforme mostrado abaixo.
# ...
>[!CAUTION]
>
>AEM 6.4 has reached the end of extended support and this documentation is no longer updated. For further details, see our [technical support periods](https://helpx.adobe.com/br/support/programs/eol-matrix.html). Find the supported versions [here](https://experienceleague.adobe.com/docs/?lang=pt-BR).
# default JVM options
>[!CAUTION]
>
>AEM 6.4 has reached the end of extended support and this documentation is no longer updated. For further details, see our [technical support periods](https://helpx.adobe.com/br/support/programs/eol-matrix.html). Find the supported versions [here](https://experienceleague.adobe.com/docs/?lang=pt-BR).
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"
# ...
>[!CAUTION]
>
>AEM 6.4 has reached the end of extended support and this documentation is no longer updated. For further details, see our [technical support periods](https://helpx.adobe.com/br/support/programs/eol-matrix.html). Find the supported versions [here](https://experienceleague.adobe.com/docs/?lang=pt-BR).
Iniciar depuração
Agora, todos os usuários estão configurados para depurar os JSPs no AEM.
- Selecionar Executar -> Depurar -> Seu Perfil De Depuração
- Definir pontos de interrupção no código do componente
- Acesse uma página no navegador
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 o Documentação do Jetrain sobre depuração remota.
