AEM herramientas para desarrolladores de Eclipse

Información general

AEM Developer Tools para Eclipse es un complemento de Eclipse basado en el complemento de Eclipse para Apache Sling publicado con la licencia de Apache 2.

Ofrece varias funciones que facilitan el desarrollo de AEM:

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

Requisitos

Antes de utilizar las herramientas para desarrolladores de AEM, debe:

  • Descargue e instale Eclipse IDE para desarrolladores de Java EE. AEM herramientas para desarrolladores admiten actualmente Eclipse Kepler o versiones más recientes

  • Se puede utilizar 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 en pilas editando su archivo de configuración eclipse.ini tal como se describe en las Preguntas frecuentes sobre Eclipse.

NOTA

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

Instalación de 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. Examine el AEM Sitio Web de herramientas para desarrolladores.

  2. Copie el Installation Link.

    Tenga en cuenta que, de lo contrario, puede descargar un archivo en lugar de utilizar el vínculo de instalación. Esto permite la instalación sin conexión, pero de este modo se perderán las notificaciones de actualización automáticas.

  3. En Eclipse, abra el menú Help.

  4. Haga clic en Instalar nuevo software.

  5. Haga clic en Agregar….

  6. En Name escriba AEM Herramientas para desarrolladores.

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

  8. Haga clic en Ok.

  9. Compruebe los complementos AEM y Sling.

  10. Haga clic en Siguiente.

  11. Haga clic en Siguiente.

  12. Acepte los acuerdos de licencia y haga clic en Finish.

  13. Haga clic en Yes para reiniciar Eclipse.

Cómo importar proyectos existentes

La perspectiva de AEM

Las AEM herramientas de desarrollo para Eclipse se envían con una perspectiva que le ofrece 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, así como que sirve como guía de prácticas recomendadas para varias funciones de AEM. Obtenga más información sobre el tipo de archivo del proyecto.

Siga estos pasos para crear el proyecto de ejemplo:

  1. En el menú File > New > Project, vaya a la sección AEM y seleccione AEM ejemplo de proyecto de varios módulos.

    chlimage_1-69

  2. Haga clic en Siguiente.

    NOTA

    Este paso puede tardar un rato, 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) en el menú y haga clic en Siguiente.

    chlimage_1-71

  4. Rellene un Name, Group id y un Artifact id para el proyecto de ejemplo. 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 Debugger, debe haber empezado a AEM en el modo de depuración, 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 Finish. Se crea la estructura del proyecto.

    NOTA

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

Solución de problemas

Resolver definición de proyecto no válida

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 derecho. En el menú Maven seleccione Actualizar proyectos.
  3. Compruebe Forzar actualizaciones de instantáneas/versiones.
  4. Haga clic en Aceptar. Eclipse intenta descargar las dependencias requeridas.

Habilitación del llenado automático 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 las dependencias adecuadas al proyecto. Hay un problema conocido al usar el AEM Uber Jar, que no incluye los archivos tld y TagExtraInfo necesarios.

Para evitarlo, asegúrese de que el artefacto org.apache.sling.scripting.jsp.taglib esté ubicado en la ruta de clases antes del AEM Uber Jar. Para los proyectos de Maven, coloque la siguiente dependencia en el pom.xml antes de 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

La herramienta oficial Apache Sling IDE para el sitio web Eclipse le proporciona información útil:

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

En esta página