Herramientas para desarrolladores de AEM para Eclipse aem-developer-tools-for-eclipse
Información general overview
"Herramientas para desarrolladores de AEM" es un complemento de Eclipse basado en el complemento Eclipse para Apache Sling lanzado bajo la licencia Apache 2.
Ofrece varias funciones que facilitan el desarrollo de AEM:
- Integración perfecta con las instancias de AEM a través del conector de servidor Eclipse.
- Sincronización para paquetes OSGI y de contenido.
- Compatibilidad de depuración con la capacidad de intercambio en caliente de código.
- Bootstrap simple de proyectos de AEM mediante un asistente de creación de proyectos específico.
- Edición sencilla de propiedades JCR.
Requisitos requirements
Antes de usar las herramientas para desarrolladores de AEM, haga lo siguiente:
-
Descargue e instale Eclipse IDE para desarrolladores de Java™ EE. Actualmente, las herramientas para desarrolladores de AEM admiten Eclipse Kepler o una versión más reciente
-
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 GB de memoria de pila editando el archivo de configuración
eclipse.inital como se describe en Preguntas frecuentes sobre Eclipse.
eclipse.ini.Cómo instalar las herramientas para desarrolladores de AEM para Eclipse how-to-install-the-aem-developer-tools-for-eclipse
Una vez que haya cumplido los requisitos anteriores, puede instalar el complemento de la siguiente manera:
-
Examine el sitio web de AEM Developer Tools en
https://eclipse.adobe.com/aem/dev-tools/. -
Copie el vínculo de instalación.
También puede descargar un archivo en lugar de utilizar el vínculo de instalación. Al hacerlo, se puede realizar la instalación sin conexión, pero se pierden las notificaciones de actualización automática.
-
En Eclipse, abre el menú Ayuda.
-
Haga clic en Instalar nuevo software.
-
Haga clic en Agregar….
-
En Name, escriba Herramientas para desarrolladores de AEM.
-
En Ubicación, copie la URL de instalación.
-
Haga clic en Aceptar.
-
Compruebe los complementos de AEM y Sling.
-
Haga clic en Siguiente.
-
Haga clic en Siguiente.
-
Acepte los contratos de licencia y haga clic en Finalizar.
-
Haz clic en Sí para reiniciar Eclipse.
Cómo Importar Proyectos Existentes how-to-import-existing-projects
La perspectiva de AEM the-aem-perspective
Las herramientas de desarrollo de AEM para Eclipse se envían con una perspectiva que le ofrece control total sobre sus proyectos e instancias de AEM.
Ejemplo de proyecto de varios módulos sample-multi-module-project
Las "herramientas para desarrolladores de AEM" incluyen un proyecto de muestra de varios módulos que le ayuda a ponerse al día rápidamente con la configuración de un proyecto en Eclipse. También sirve como guía de prácticas recomendadas sobre varias funciones de AEM. Más información sobre el tipo de archivo del proyecto.
Para crear el proyecto de ejemplo, complete los siguientes pasos:
-
En el menú Archivo > Nuevo > Proyecto, vaya a la sección AEM y seleccione Proyecto de módulo múltiple de muestra de AEM.
-
Haga clic en Siguiente.
note note NOTE Este paso puede tardar un poco porque m2eclipse debe analizar los catálogos de tipo de archivo. 
-
Elija com.adobe.granite.archetypes : sample-project-archetype : (número más alto) en el menú y, a continuación, haga clic en Siguiente.
-
Rellene Name, Group id y Artifact id para el proyecto de ejemplo. También puede optar por establecer algunas propiedades avanzadas.
-
Ahora configure un servidor de AEM al que Eclipse pueda conectarse.
Para utilizar la función del depurador, asegúrese de iniciar AEM en modo de depuración, lo que se puede lograr agregando lo siguiente a la línea de comandos:
code language-none -nofork -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=10123
-
Haga clic en Finalizar. Se crea la estructura del proyecto.
note note NOTE En una instalación nueva (más específicamente: cuando las dependencias de Maven nunca se han descargado), puede obtener el proyecto creado con errores. En este caso, siga el procedimiento descrito en Resolver definición de proyecto no válida.
Solución de problemas troubleshooting
Resolver definición de proyecto no válida resolving-invalid-project-definition
Para resolver dependencias no válidas y la definición del proyecto, siga estos pasos:
- Seleccione todos los proyectos creados.
- Haga clic con el botón derecho. En el menú Maven, seleccione Actualizar proyectos.
- Compruebe Forzar actualizaciones de instantáneas/versiones.
- Haga clic en Aceptar. Eclipse intenta descargar las dependencias requeridas.
Habilitar la finalización automática de bibliotecas de etiquetas en archivos JSP enabling-tag-library-autocompletion-in-jsp-files
La finalización automática de la biblioteca de etiquetas funciona de forma predeterminada, dado que se añaden las dependencias adecuadas al proyecto. 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 esté en la ruta de clase antes de AEM Uber Jar. Para proyectos de Maven, coloque la siguiente dependencia en el archivo 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 añadir la versión adecuada para la implementación de AEM.
Más información more-information
La página web oficial de Apache Sling IDE tooling for Eclipse le proporciona información útil:
- La Guía del usuario de herramientas del IDE de Apache Sling para Eclipse, esta documentación le guía 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.
- La sección de solución de problemas.
- La lista de problemas conocidos.
La siguiente documentación oficial de Eclipse puede ayudar a configurar su entorno: