Extensión de AEM Brackets

Información general

La extensión AEM Brackets proporciona un flujo de trabajo fluido para editar los componentes de AEM y las bibliotecas de cliente, y aprovecha la potencia del editor de código Brackets, que proporciona acceso desde el editor de código a los archivos y capas de Photoshop. La sencilla sincronización que proporciona la extensión (no se requiere Maven ni File Vault) aumenta la eficacia del desarrollador y también ayuda a los desarrolladores de front-end con conocimientos AEM limitados a participar en proyectos. Esta extensión también proporciona cierta compatibilidad con el lenguaje de plantilla HTML (HTL), que elimina la complejidad de JSP para facilitar el desarrollo de componentes y aumentar su seguridad.

imagen_1-53

Características

Las principales características de la extensión AEM Brackets son:

Sincronización automatizada de archivos modificados con la instancia de desarrollo de AEM.
Sincronización bidireccional manual de archivos y carpetas.
Sincronización completa de paquetes de contenido del proyecto.
Finalización del código HTL para expresiones y data-sly-* instrucciones de bloque.

Además, Brackets incorpora muchas funciones útiles para los desarrolladores de fuentes AEM:

Compatibilidad con archivos de Photoshop para extraer información de un archivo PSD, como capas, medidas, colores, fuentes, textos, etc.
Sugerencias de código del PSD para reutilizar fácilmente esta información extraída en el código.
Compatibilidad con preprocesadores CSS, como LESS y SCSS.
Y cientos de extensiones adicionales que cubren necesidades más específicas.

Instalación

Brackets

La extensión AEM Brackets es compatible con Brackets versión 1.0 o buenas.

Descargue la última versión de Brackets de ackets.io.

La extensión

Para instalar la extensión, siga estos pasos:

Abrir Brackets. En el menú Archivo, seleccione Extension Manager…
Introduzca AEM en la barra de búsqueda y busque AEM Brackets Extension.
Haga clic en Instalar.
Cierre el cuadro de diálogo y el Extension Manager una vez completada la instalación.

Introducción

El proyecto Content-Package

Una vez instalada la extensión, puede empezar a desarrollar componentes de AEM abriendo una carpeta de paquetes de contenido desde el sistema de archivos con Brackets.

El proyecto debe contener al menos:

una carpeta jcr_root (p. ej. myproject/jcr_root)
un archivo filter.xml (por ejemplo, myproject/META-INF/vault/filter.xml); para obtener más información sobre la estructura del archivo filter.xml, consulte la definición del filtro del espacio de trabajo.

En el menú File de Brackets, elija Open Folder… y elija la carpeta jcr_root o la carpeta del proyecto principal.

NOTA

Si no tiene un proyecto propio con un paquete de contenido, puede probar el HTL TodoMVC Example. En GitHub, haga clic en Descargar ZIP, extraiga los archivos localmente y, como se ha indicado anteriormente, abra la carpeta jcr_root en Brackets. A continuación, siga los pasos a continuación para configurar la Configuración del proyecto y, por último, cargue todo el paquete en la instancia de desarrollo de AEM haciendo un Paquete de contenido de exportación como se indica en la sección Sincronización de paquetes de contenido completo .

Después de estos pasos, debe poder acceder a la dirección URL /content/todo.html de la instancia de desarrollo de AEM y puede empezar a realizar modificaciones en el código en Brackets y ver cómo, después de hacer una actualización en el explorador web, los cambios se sincronizaron inmediatamente con el servidor de AEM.

Configuración del proyecto

Para sincronizar el contenido con y desde una instancia de desarrollo de AEM, debe definir la configuración del proyecto. Para ello, vaya al menú AEM y elija Configuración del proyecto…

imagen_1-55

La Configuración del proyecto permite definir:

La URL del servidor (p. ej. http://localhost:4502)
tolerar servidores que no tengan un certificado HTTPS válido (mantener sin marcar, a menos que sea necesario)
El nombre de usuario utilizado para sincronizar contenido (por ejemplo, admin)
La contraseña del usuario (p. ej. admin)

Sincronización de contenido

La extensión AEM Brackets proporciona los siguientes tipos de sincronización de contenido para archivos y carpetas permitidos por las reglas de filtrado definidas en filter.xml:

Sincronización automatizada de archivos modificados

Esto solo sincroniza los cambios de Brackets a la instancia de AEM, pero nunca al revés.

Sincronización bidireccional manual

En el Explorador de proyectos, abra el menú contextual haciendo clic con el botón derecho en cualquier archivo o carpeta y se puede acceder a las opciones Export to Server o Import from Server.

imagen_1-56

NOTA

Si la entrada seleccionada está fuera de la carpeta jcr_root, las entradas de menú contextual Export to Server y Import from Server están desactivadas.

Sincronización completa de paquetes de contenido

En el menú AEM, las opciones Exportar paquete de contenido o Importar paquete de contenido permiten sincronizar todo el proyecto con el servidor.

chlimage_1-57

Estado de sincronización

La extensión AEM Brackets incluye un icono de notificación en la barra de herramientas de la derecha de la ventana Brackets, que indica el estado de la última sincronización:

verde: todos los archivos se han sincronizado correctamente
azul: una operación de sincronización está en curso
amarillo: algunos archivos no estaban sincronizados
rojo: ninguno de los archivos se sincronizó

Al hacer clic en el icono de notificación, se abrirá el cuadro de diálogo del informe Estado de sincronización que enumera todos los estados de cada archivo sincronizado.

chlimage_1-58

NOTA

Solo se sincronizará el contenido marcado como incluido en las reglas de filtrado de filter.xml independientemente del método de sincronización utilizado.

Además, los archivos .vltignore son compatibles para excluir el contenido de la sincronización con el repositorio y desde él.

Edición del código HTL

La extensión AEM Brackets también incluye algunas funciones de finalización automática para facilitar la escritura de atributos y expresiones HTL.

Autocompletar atributo

En un atributo HTML, escriba sly. El atributo se completa automáticamente como data-sly-.
Seleccione el atributo HTL en la lista desplegable.

Finalización automática de expresiones

Dentro de una expresión ${}, los nombres de variables comunes se completan automáticamente.

Más información

La extensión AEM Brackets es un proyecto de código abierto, alojado en GitHub por la organización Adobe Marketing Cloud, en la licencia de Apache, versión 2.0: