Extensión de AEM Brackets

Información general

La extensión AEM Brackets proporciona un flujo de trabajo fluido para editar los componentes AEM y las bibliotecas de cliente, y aprovecha el poder del Brackets editor de código, 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 Idioma de plantilla del HTML (HTL), lo que elimina la complejidad de JSP para que el desarrollo de componentes sea más fácil y seguro.

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 de código HTL para expresiones y data-sly-* block .

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 de 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 versión más reciente de Brackets desde soportes.io.

La extensión

Para instalar la extensión, siga estos pasos:

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

Introducción

El proyecto de paquete de contenido

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:

a jcr_root carpeta (p. ej. myproject/jcr_root)
a filter.xml (p. ej. myproject/META-INF/vault/filter.xml); para obtener más información sobre la estructura de la variable filter.xml consulte el Definición del filtro del espacio de trabajo.

Entre corchetes Archivo , elija Abrir carpeta… y seleccione jcr_root o la carpeta del proyecto principal.

NOTA

Si no tiene un proyecto propio con un paquete de contenido, puede probar el Ejemplo de HTL TodoMVC. En GitHub, haga clic en Descargar ZIP, extraiga los archivos localmente y, como se indica más arriba, abra el jcr_root en Brackets. A continuación, siga los pasos a continuación para configurar la variable Configuración del proyecto y, finalmente, cargue todo el paquete en la instancia de desarrollo de AEM haciendo una Exportar paquete de contenido tal y como se indica más abajo en la sección Sincronización de paquetes de contenido completo .

Después de estos pasos, debe poder acceder a la variable /content/todo.html URL en 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 realizar 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 a la AEM menú y selección 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 Los Archivos Cambiados

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 en la Exportar a servidor o Importar desde el servidor se puede acceder a las opciones de .

imagen_1-56

NOTA

Si la entrada seleccionada está fuera del jcr_root carpeta, Exportar a servidor y Importar desde el servidor las entradas del menú contextual están desactivadas.

Sincronización de paquetes de contenido completo

En el AEM , el 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 el contenido marcado como incluido en las reglas de filtrado de filter.xml se sincronizarán, independientemente del método de sincronización utilizado.

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

Edición de 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.

Finalización automática de atributos

En un atributo de HTML, escriba sly. El atributo se completa automáticamente en 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 el Adobe Marketing Cloud organización, en la licencia de Apache, versión 2.0: