Herramientas para desarrolladores de AEM para Eclipse

Información general

AEM Developer Tools para Eclipse es un complemento Eclipse basado en el complemento Eclipse para Apache Sling publicado bajo la Licencia Apache 2.

Oferta varias características que facilitan el desarrollo de AEM:

  • Integración perfecta con instancias de AEM mediante el conector de servidor Eclipse.
  • Sincronización para paquetes de contenido y OSGI.
  • Compatibilidad de depuración con la capacidad de intercambio en caliente de código.
  • Un sencillo arranque de AEM proyectos a través de un Asistente para la creación de proyectos específico.
  • Fácil edición de las propiedades de JCR.

Requisitos

Antes de utilizar las herramientas de desarrollo de AEM, debe:

  • Descargue e instale Eclipse IDE para desarrolladores de Java EE. AEM Developer Tools es compatible actualmente con Eclipse Kepler o versiones posteriores

  • Puede utilizarse con AEM versión 5.6.1 o posterior

  • Configure la instalación de eclipse para asegurarse de que tiene al menos 1 gigabyte de memoria de pila editando su archivo de configuración eclipse.ini como se describe en las Preguntas más frecuentes sobre Eclipse.

NOTA

En macOS, debe hacer clic con el botón derecho en Eclipse.app y luego seleccionar Mostrar contenido del paquete para encontrar su eclipse.ini.

Cómo instalar las herramientas para desarrolladores de AEM para Eclipse

Una vez que haya cumplido los requisitos anteriores, puede instalar el complemento de la siguiente manera:

  1. Navegue por el sitio Web de herramientas de desarrollo AEM.

  2. Copie el Vínculo de instalación.

    Tenga en cuenta que, como alternativa, puede descargar un archivo en lugar de utilizar el vínculo de instalación. Esto permite la instalación sin conexión, pero se perderán las notificaciones de actualización automática de esta manera.

  3. En Eclipse, abra el menú Ayuda.

  4. Haga clic en Instalar nuevo software.

  5. Haga clic en Agregar….

  6. En Nombre escriba AEM Developer Tools.

  7. En Ubicación copie la dirección URL de instalación.

  8. Haga clic en Aceptar.

  9. Compruebe los complementos AEM y Sling.

  10. Haga clic en Siguiente.

  11. Haga clic en Siguiente.

  12. Acepte los acuerdos de lincesis y haga clic en Finalizar.

  13. Haga clic en para reiniciar Eclipse.

Cómo importar proyectos existentes

La perspectiva AEM

Las herramientas de desarrollo AEM para Eclipse se envían con una perspectiva que le oferta el control total sobre sus proyectos e instancias de AEM.

chlimage_1-2

Proyecto de módulo múltiple de muestra

Las herramientas para desarrolladores de AEM para Eclipse incluyen un proyecto multimódulo de muestra que le ayuda a ponerse al día rápidamente con la configuración de un proyecto en Eclipse, además de servir como guía de prácticas recomendadas para varias funciones de AEM. Obtenga más información sobre el arquetipo del proyecto.

Siga estos pasos para crear el proyecto de ejemplo:

  1. En el menú Archivo > Nuevo > Proyecto, vaya a la sección AEM y seleccione AEM Ejemplo de proyecto de módulos múltiples.

    chlimage_1-69

  2. Haga clic en Siguiente.

    NOTA

    Este paso puede llevar un tiempo, ya que m2eclipse necesita analizar los catálogos de arquetipos.

    chlimage_1-70

  3. Elija com.adobe.granite.archetypes: sample-project-archetype : (número más alto) del menú, luego haga clic en Siguiente.

    chlimage_1-71

  4. Rellene un Nombre, Id. de grupo y un Id. de artefacto para el proyecto de muestra. También puede optar por establecer algunas propiedades avanzadas.

    chlimage_1-72

  5. A continuación, debe configurar un servidor AEM al que se conectará Eclipse.

    Para utilizar la función de depurador, debe haber empezado a AEM en modo de depuración, lo que se puede lograr, por ejemplo, añadiendo lo siguiente a la línea de comandos:

        -nofork -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=10123
    

    chlimage_1-73

  6. Haga clic en Finalizar. Se crea la estructura del proyecto.

    NOTA

    En una instalación nueva (más específicamente: cuando no se hayan descargado nunca varias dependencias), es posible que el proyecto se cree con errores. En este caso, siga el procedimiento descrito en Resolución de definiciones de proyecto no válidas.

Solución de problemas

Resolución de definiciones de proyecto no válidas

Para resolver dependencias no válidas y la definición del proyecto, siga estos pasos:

  1. Seleccione todos los proyectos creados.
  2. Haga clic con el botón secundario. En el menú Maven seleccione Actualizar proyectos.
  3. Marque Forzar actualizaciones de instantáneas/versiones.
  4. Haga clic en Aceptar. Eclipse intenta descargar las dependencias necesarias.

Habilitación de la finalización automática de la biblioteca de etiquetas en archivos JSP

El llenado automático de la biblioteca de etiquetas funciona de forma predeterminada, ya que se añaden al proyecto las dependencias correspondientes. Hay un problema conocido al usar el AEM Uber Jar, que no incluye los archivos tld y TagExtraInfo necesarios.

Para solucionarlo, asegúrese de que el artefacto org.apache.sling.scripting.jsp.taglib se encuentra en la ruta de clases antes del AEM Uber Jar. Para los proyectos de Maven, coloque la siguiente dependencia en el archivo pom.xml antes del archivo Uber Jar.

<dependency>
  <groupId>org.apache.sling</groupId>
  <artifactId>org.apache.sling.scripting.jsp.taglib</artifactId>
  <scope>provided</scope>
</dependency>

Asegúrese de agregar la versión adecuada para la implementación de AEM.

Más información

El sitio web oficial del IDE de Apache Sling para Eclipse le proporciona información útil:

La siguiente documentación oficial de Eclipse puede ayudarle a configurar su entorno:

En esta página