Herramientas para desarrolladores de AEM para Eclipse aem-developer-tools-for-eclipse

Logotipo de herramientas para desarrolladores de Experience Manager para Eclipse

Información general overview

Herramientas para desarrolladores Experience Manager para Eclipse es un complemento de Eclipse basado en el complemento Eclipse para Apache Sling lanzado bajo la licencia Apache 2.

AEM Ofrece varias funciones que facilitan el desarrollo de la:

  • AEM Integración perfecta con las instancias de la a través del conector del 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 AEM simple de proyectos de la mediante un asistente de creación de proyectos específico
  • Edición sencilla de propiedades JCR

Requisitos requirements

AEM Antes de usar las herramientas para desarrolladores de, debe hacer lo siguiente:

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

AEM Cómo instalar las herramientas para desarrolladores de para Eclipse how-to-install-the-aem-developer-tools-for-eclipse

Cuando haya cumplido los requisitos anteriores, puede instalar el complemento de la siguiente manera:

  1. AEM Abra el sitio web de Herramientas para desarrolladores de.

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

    Como alternativa, puede descargar un archivo en lugar de utilizar el vínculo de instalación. Este método permite la instalación sin conexión, pero no recibe notificaciones de actualización automáticas faltantes de esta manera.

  3. En Eclipse, abre el menú Ayuda.

  4. Haga clic en Instalar nuevo software.

  5. Haga clic en Agregar….

  6. En el campo Nombre, escriba AEM Developer Tools.

  7. En el campo Ubicación, copie la URL de instalación.

  8. Haga clic en Agregar.

  9. AEM Compruebe los complementos ​y Sling.

  10. Haga clic en Siguiente.

  11. En la ventana Instalar detalles, haga clic de nuevo en Siguiente.

  12. Acepte los contratos de licencia y haga clic en Finalizar.

  13. Haz clic en Reiniciar ahora para reiniciar Eclipse.

AEM La perspectiva de la the-aem-perspective

En Eclipse, una perspectiva determina las acciones y vistas disponibles dentro de una ventana y permite la interacción orientada a tareas con recursos en Eclipse. Para obtener más información acerca de Perspective, consulte la documentación de Eclipse.

Herramientas de desarrollo de Experience Manager AEM AEM para Eclipse proporcionan una perspectiva de que le ofrece control total sobre sus Proyectos e instancias de la comunidad de la comunidad de la que se ha realizado el trabajo de la comunidad de trabajo. AEM Para abrir la Perspectiva de la:

  1. En la barra de menús de Eclipse, seleccione Ventana > Perspectiva > Abrir perspectiva > Otra.
  2. AEM Seleccione ​en el cuadro de diálogo y haga clic en Abrir.

AEM La perspectiva de la en Eclipse

Ejemplo de proyecto de varios módulos sample-multi-module-project

Herramientas para desarrolladores de Experience Manager para Eclipse incluye un proyecto de ejemplo de varios módulos que le ayudará a ponerse al día rápidamente con la configuración de un proyecto en Eclipse. AEM También sirve como guía de prácticas recomendadas sobre varias funciones de la. Más información sobre el tipo de archivo del proyecto.

Siga estos pasos para crear el proyecto de ejemplo:

  1. AEM AEM En el menú Archivo > Nuevo > Proyecto, vaya a la sección ​y seleccione Proyecto de módulo múltiple de muestra.

    AEM Proyecto De Módulo Múltiple De Ejemplo

  2. Haga clic en Siguiente.

    note note
    NOTE
    Este paso puede tardar un momento, ya que m2eclipse debe analizar los catálogos de tipo de archivo.
  3. Elija com.adobe.granite.archetypes : sample-project-archetype : <highest-number> en el menú y luego haga clic en Siguiente.

    Seleccionar versión de tipo de archivo

  4. Proporcione los siguientes campos para el proyecto de ejemplo:

    • Nombre
    • Id. de grupo
    • Id. de artefacto
    • appId: es posible que tenga que expandir las opciones de Avanzado para establecer este valor.
    • appTitle: es posible que tenga que expandir las opciones de Advanced para establecer este valor.
    • Paquete: es posible que tenga que expandir las opciones de Avanzado para establecer este valor.

    Definir propiedades de tipo de archivo

  5. Haga clic en Siguiente.

  6. AEM A continuación, configure un servidor de al que se conecte Eclipse.

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

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

    AEM Conectarse al servidor de la

  7. 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.

Cómo Importar Proyectos Existentes how-to-import-existing-projects

Puede usar la característica Nuevo proyecto para crear la estructura adecuada:

  1. Siga las instrucciones para crear un Proyecto de módulo múltiple de muestra y tiene los siguientes proyectos creados para usted, que permiten una separación correcta de preocupaciones:

    • PROJECT.ui.apps para el contenido /apps y /etc
    • PROJECT.ui.content para /content creado
    • PROJECT.core para paquetes Java™ (se vuelven interesantes cuando desea agregar código Java™)
    • PROJECT.it.launcher y PROJECT.it.tests para pruebas de integración
  2. Reemplace el contenido de su proyecto PROJECT.ui.apps por las carpetas apps y etc de su paquete:

    1. En el panel Explorador del proyecto, despliegue PROJECT.ui.apps > src > main > content > jcr_root > apps.
    2. Haga clic con el botón derecho en la carpeta apps y elija Mostrar en > Explorador del sistema.
    3. Elimine las carpetas apps y etc que debería ver y coloque aquí las carpetas apps y etc de su paquete de contenido.
    4. En Eclipse, haga clic con el botón secundario en el proyecto PROJECT.ui.apps y elija Actualizar.
  3. A continuación, haga lo mismo para PROJECT.ui.content y reemplace su carpeta de contenido por el de sus paquetes:

    1. En el panel Explorador del proyecto, despliegue PROJECT.ui.content > src > main > content > jcr_root > content.
    2. Haga clic con el botón derecho en la carpeta de contenido más detallada y elija Mostrar en > Explorador del sistema.
    3. Elimine la carpeta de contenido que debería ver ahora y coloque aquí la carpeta de contenido de su paquete de contenido.
    4. En Eclipse, haga clic con el botón secundario en el proyecto PROJECT.ui.content y elija Actualizar.
  4. Ahora tiene que actualizar los filter.xml archivos de estos dos proyectos para que se correspondan con el contenido del paquete de contenido. Para ello, abra el archivo META-INF/vault/filter.xml del paquete de contenido en un editor de texto/código independiente.

    • Este es un ejemplo del aspecto que puede tener el archivo filter.xml:
    code language-xml
    <?xml version="1.0" encoding="UTF-8"?>
    <workspaceFilter version="1.0">
        <filter root="/apps/foo"/>
        <filter root="/apps/foundation/components/bar"/>
        <filter root="/etc/designs/foo"/>
        <filter root="/content/foo"/>
        <filter root="/content/dam/foo"/>
        <filter root="/content/usergenerated/content/foo"/>
    </workspaceFilter>
    
  5. En cuanto al contenido del paquete que se dividió en dos proyectos, también debe dividir estas reglas de filtro en dos y actualizar en consecuencia los filter.xml archivos de los dos proyectos.

    1. En Eclipse, abra PROJECT.ui.apps/src/main/content/META-INF/filter.xml.

    2. Reemplace el contenido del elemento <workspaceFilter> por las reglas del paquete que comiencen por /apps y /etc

      • Por ejemplo:

        code language-xml
        <?xml version="1.0" encoding="UTF-8"?>
        <workspaceFilter version="1.0">
           <filter root="/apps/foo"/>
           <filter root="/apps/foundation/components/bar"/>
           <filter root="/etc/designs/foo"/>
        </workspaceFilter>
        
    3. Luego abra PROJECT.ui.content/src/main/content/META-INF/filter.xml.

    4. Reemplace las reglas por las del paquete que comiencen por /content.

      • Por ejemplo:

        code language-xml
        <?xml version="1.0" encoding="UTF-8"?>
        <workspaceFilter version="1.0">
           <filter root="/content/foo"/>
           <filter root="/content/dam/foo"/>
           <filter root="/content/usergenerated/content/foo"/>
        </workspaceFilter>
        
  6. Asegúrese de guardar todos los cambios. AEM Ahora puede sincronizar ese nuevo contenido con la instancia de la.

  7. En el panel Servidores, asegúrese de que la conexión se ha iniciado y, en caso contrario, iníciela.

  8. Haz clic en el icono Limpiar y Publish.

Una vez finalizado, el paquete debería estar ejecutándose en la instancia y, al guardarlo, cualquier cambio se sincronizará automáticamente con la instancia.

Si desea volver a compilar un paquete a partir del proyecto, haga clic con el botón derecho en PROJECT.ui.apps o PROJECT.ui.content y elija Ejecutar como > Instalación de Maven.

Ahora tiene una carpeta de destino creada con el paquete dentro de (por ejemplo, PROJECT.ui.apps-0.0.1-SNAPSHOT.zip).

Resolució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:

  1. Seleccione todos los proyectos creados.
  2. Haga clic con el botón derecho.
  3. En el menú contextual, seleccione Maven > Actualizar proyectos.
  4. Compruebe Forzar actualizaciones de instantáneas/versiones.
  5. Haga clic en OK.

Eclipse descarga las dependencias requeridas. Esto puede tardar un momento.

Más información more-information

La página web oficial de Apache Sling IDE tooling for Eclipse le proporciona información útil:

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

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab