Cómo desarrollar AEM proyectos usando IntelliJ IDEA

Información general

Para comenzar con AEM desarrollo de IntelliJ, se requieren los siguientes pasos.

Cada uno de ellos se explica con más detalle en el resto de este procedimiento.

  • Instalar IntelliJ
  • Configure el proyecto de AEM en base a Maven
  • Preparación de la compatibilidad de JSP con IntelliJ en el POM de Maven
  • Importar el proyecto Maven a IntelliJ
NOTA

Esta guía se basa en IntelliJ IDEA Ultimate Edition 12.1.4 y AEM 5.6.1.

Instalar IntelliJ IDEA

Descargue IntelliJ IDEA de la página de descargas de JetBrains.

A continuación, siga las instrucciones de instalación de esa página.

Configure el proyecto de AEM en base a Maven

A continuación, configure el proyecto con Maven como se describe en Cómo crear AEM proyectos con Apache Maven.

Para inicio con el trabajo con AEM proyectos en IntelliJ IDEA, la configuración básica de Introducción en 5 minutos es suficiente.

Preparar compatibilidad con JSP para IntelliJ IDEA

IntelliJ IDEA también puede proporcionar soporte para trabajar con JSP, por ejemplo

  • finalización automática de bibliotecas de etiquetas
  • conocimiento de los objetos definidos por <cq:defineObjects /> y <sling:defineObjects />

Para que esto funcione, siga las instrucciones de Cómo trabajar con JSP en Cómo generar AEM proyectos con Apache Maven.

Importar el proyecto Maven

  1. Abra el cuadro de diálogo Importar en IntelliJ IDEA mediante

    • seleccionando Importar proyecto en la pantalla de bienvenida si todavía no tiene un proyecto abierto
    • seleccionar Archivo -> Importar proyecto en el menú principal
  2. En el cuadro de diálogo Importar, seleccione el archivo POM del proyecto.

    chlimage_1-45

  3. Continúe con la configuración predeterminada como se muestra en el cuadro de diálogo siguiente.

    chlimage_1-46

  4. Continúe con los siguientes cuadros de diálogo haciendo clic en Siguiente y Finalizar.

  5. Ahora está configurado para el desarrollo AEM con IntelliJ IDEA

    chlimage_1-47

Depuración de JSPs con IntelliJ IDEA

Los siguientes pasos son necesarios para depurar JSPs con IntelliJ IDEA

  • Configuración de una faceta web en el proyecto
  • Instalación del complemento de soporte JSR45
  • Configuración de un Perfil de depuración
  • Configurar AEM para el modo de depuración

Configurar una faceta web en el proyecto

IntelliJ IDEA necesita saber dónde encontrar los JSPs para la depuración. Como IDEA no puede interpretar la configuración content-package-maven-plugin, esto debe configurarse manualmente.

  1. Vaya a Archivo -> Estructura del proyecto
  2. Seleccione el módulo Contenido
  3. Haga clic + sobre la lista de módulos y seleccione Web
  4. Como directorio de recursos Web, seleccione el content/src/main/content/jcr_root subdirectory del proyecto como se muestra en la captura de pantalla siguiente.

chlimage_1-48

Instale el complemento de soporte JSR45

  1. Vaya al panel Complementos de la configuración de IntelliJ IDEA
  2. Vaya al complemento Integración de JSR45 y seleccione la casilla de verificación situada junto a él
  3. Haga clic en Aplicar
  4. Reinicie IntelliJ IDEA cuando se le solicite

chlimage_1-49

Configurar un Perfil de depuración

  1. Vaya a Ejecutar -> Editar configuraciones
  2. Pulse + y seleccione JSR45 Remote
  3. En el cuadro de diálogo de configuración, seleccione Configurar junto a Servidor de aplicaciones y configure un servidor genérico
  4. Configure la página de inicio en una dirección URL apropiada si desea abrir un explorador cuando depure inicios
  5. Elimine todas las tareas antes de iniciar si utiliza vlt autosync, o configure las tareas Maven apropiadas si no lo hace
  6. En el panel Inicio/Conexión, ajuste el puerto si es necesario
  7. Copiar los argumentos de la línea de comandos que propone IntelliJ IDEA

chlimage_1-50 chlimage_1-51

Configurar AEM para el modo de depuración

El último paso requerido es el inicio de AEM con las opciones de JVM propuestas por IntelliJ IDEA.

Puede hacerlo iniciando el archivo jar de AEM directamente y agregando estas opciones, por ejemplo con la siguiente línea de comandos:

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

También puede agregar estas opciones a la secuencia de comandos de inicio en crx-quickstart/bin/start como se muestra a continuación.

# ...

# 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"

# ...

Depuración de inicio

Ahora está todo configurado para depurar sus JSP en AEM.

  1. Seleccione Ejecutar -> Depurar -> El Perfil de depuración
  2. Definición de puntos de interrupción en el código de componente
  3. Acceso a una página en el explorador

chlimage_1-52

Depuración de paquetes con IntelliJ IDEA

El código de los paquetes se puede depurar mediante una conexión de depuración remota genérica estándar. Puede seguir la documentación de JetBrain sobre depuración remota.

En esta página