Show Menu
TEMAS×

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 con la licencia de Apache 2.
Ofrece varias funciones que facilitan el desarrollo de AEM:
  • Integración perfecta con las instancias de AEM a través de Eclipse Server Connector.
  • Sincronización para paquetes de contenido y OSGI.
  • Compatibilidad de depuración con la capacidad de intercambio de código en caliente.
  • Instantánea simple de los proyectos de AEM mediante 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 desarrollador de AEM, debe:
  • Descargue e instale Eclipse IDE para desarrolladores de Java EE. Las herramientas de desarrollador de AEM admiten actualmente Eclipse Kepler o versiones posteriores
  • 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 de pila editando el archivo de configuración como se describe en las preguntas más frecuentes eclipse.ini de Eclipse .
En macOS, debe hacer clic con el botón derecho en Eclipse.app y luego seleccionar Mostrar contenido del paquete para encontrar el 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 para desarrolladores de AEM .
  2. Copie el vínculo 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 Herramientas para desarrolladores de AEM.
  7. En Ubicación , copie la dirección URL de instalación.
  8. Click 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 Finalizar .
  13. Haga clic en para reiniciar Eclipse.

Cómo importar proyectos existentes

La perspectiva de AEM

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

Ejemplo de proyecto multimódulo

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 Proyecto de módulos múltiples de muestra de AEM.
  2. Haga clic en Siguiente .
    Este paso puede llevar un tiempo, ya que m2eclipse necesita analizar los catálogos de arquetipos.
  3. Elija com.adobe.granite.archetypes: sample-project-archetype : (número más alto) del menú y, a continuación, haga clic en Siguiente .
  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.
  5. A continuación, debe configurar un servidor AEM al que se conectará Eclipse.
    Para utilizar la función de depurador, debe haber iniciado 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
    
    
  6. Click Finish . Se crea la estructura del proyecto.
    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.

Activació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 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 de 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 añadir la versión adecuada para la implementación de AEM.

More information

El sitio web oficial de Apache Sling IDE para Eclipse le proporciona información útil:
  • La Guía , esta documentación le guiará a través de los conceptos generales, la integración del servidor y las capacidades de implementación admitidas por las herramientas de desarrollo de AEM.
  • Sección de solución de problemas.
  • Lista de problemas conocidos.
La siguiente documentación oficial de Eclipse puede ayudarle a configurar su entorno: