AEM Brackets-Erweiterung

Überblick

Die AEM Brackets-Erweiterung bietet einen reibungslosen Workflow für die Bearbeitung von AEM-Komponenten und Client-Bibliotheken und nutzt die Leistungsfähigkeit des Brackets-Code-Editors, der den Zugriff auf Photoshop-Dateien und -Ebenen über den Code-Editor ermöglicht. Die durch die Erweiterung gebotene einfache Synchronisation (kein Maven oder File Vault erforderlich) erhöht die Effizienz der Entwickler und hilft auch Frontend-Entwicklern mit begrenztem AEM-Wissen, an Projekten teilzunehmen. Diese Erweiterung bietet auch einige Unterstützung für die HTML-Vorlagensprache (HTL)](https://docs.adobe.com/content/help/de/experience-manager-htl/using/overview.html), wodurch die Komplexität von JSP entfällt, um die Komponentenentwicklung einfacher und sicherer zu gestalten.[

chlimage_1-53

Funktionen

Die Hauptmerkmale der AEM Brackets-Erweiterung sind:

  • Automatisierte Synchronisierung von geänderten Dateien mit der AEM Entwicklungsinstanz.
  • Manuelle bidirektionale Synchronisierung von Dateien und Ordnern.
  • Vollständige Synchronisierung des Inhaltspakets des Projekts.
  • HTML-Code-Abschluss für Ausdruck und data-sly-* Blockanweisungen.

Zusätzlich bietet Brackets viele nützliche Funktionen für AEM-Frontend-Entwickler:

  • Photoshop-Dateiunterstützung zum Extrahieren von Informationen aus einer PSD-Datei, wie Schichten, Maße, Farben, Schriftarten, Texte usw.
  • Codehinweise aus der PSD, um diese extrahierten Informationen im Code einfach wiederzuverwenden.
  • CSS-Vorprozessorunterstützung, wie LESS und SCSS.
  • Und Hunderte zusätzlicher Erweiterungen, die spezifischere Anforderungen abdecken.

Installation

Brackets

Die AEM Brackets-Erweiterung unterstützt Brackets Version 1.0 oder höher.

Laden Sie die neueste Brackets-Version von brackets.io herunter.

Die Erweiterung

Um die Erweiterung zu installieren, gehen Sie wie folgt vor:

  1. Öffnen Sie Brackets. Wählen Sie im Menü Datei den Extension Manager…

  2. Geben Sie AEM in die Suchleiste ein und suchen Sie nach AEM Brackets-Erweiterung.

    chlimage_1-54

  3. Klicken Sie auf Installieren.

  4. Schließen Sie das Dialogfeld und den Extension Manager nach Abschluss der Installation.

Erste Schritte

Das Content-Package-Projekt

Nachdem die Erweiterung installiert wurde, können Sie mit der Entwicklung von AEM-Komponenten beginnen, indem Sie mit Brackets einen content-package-Ordner aus Ihrem Dateisystem öffnen.

Das Projekt muss mindestens enthalten:

  1. a jcr_root Ordner (z.B. myproject/jcr_root)

  2. eine filter.xml-Datei (z. B. myproject/META-INF/vault/filter.xml); Weitere Informationen zur Struktur der filter.xml-Datei finden Sie in der Definition des Arbeitsbereichsfilters.

Im Menü Datei von Brackets wählen Sie Ordner öffnen… und wählen Sie entweder den Ordner jcr_root oder den übergeordneten Projektordner.

HINWEIS

Wenn Sie kein eigenes Projekt mit einem Inhaltspaket haben, können Sie das HTL TodoMVC Beispiel ausprobieren. Klicken Sie auf GitHub auf ZIP herunterladen, extrahieren Sie die Dateien lokal und öffnen Sie, wie oben beschrieben, den Ordner jcr_root in Brackets. Gehen Sie dann wie folgt vor, um Projekteinstellungen einzurichten, und laden Sie dann das gesamte Paket in Ihre AEM Entwicklungsinstanz hoch, indem Sie ein Inhaltspaket exportieren ausführen, wie im Abschnitt "Synchronisierung des vollständigen Inhalts-Pakets"weiter unten beschrieben.

Nach diesen Schritten sollten Sie auf die /content/todo.html-URL in Ihrer AEM-Entwicklungsinstanz zugreifen können. Sie können Beginn mit Codeänderungen in Klammern ausführen und sehen, wie die Änderungen nach einer Aktualisierung im Webbrowser sofort mit dem AEM synchronisiert wurden.

Projekteinstellungen

Um Ihren Inhalt mit einer AEM-Entwicklungsinstanz zu synchronisieren, müssen Sie Ihre Projekteinstellungen definieren. Dies können Sie tun, indem Sie im Menü AEM Projekteinstellungen… wählen.

chlimage_1-55

Die Projekteinstellungen erlauben die Definition von Folgendem:

  1. Die Server-URL (z. http://localhost:4502)
  2. Tolerieren von Servern ohne gültiges HTTPS-Zertifikat (deaktivieren Sie nicht, sofern nicht erforderlich)
  3. Benutzername, der für die Synchronisierung von Inhalten verwendet wird (z. B. admin)
  4. Das Kennwort des Benutzers (z. B. admin)

Synchronisieren von Inhalten

Die AEM Brackets Extension bietet folgende Arten der Inhaltssynchronisierung für Dateien und Ordner, die durch die in filter.xml definierten Filterregeln zulässig sind:

Automatisierte Synchronisierung von geänderten Dateien

Diese synchronisiert nur Änderungen von Brackets mit der AEM-Instanz, aber niemals umgekehrt.

Manuelle bidirektionale Synchronisierung

Öffnen Sie im Project Explorer das Kontextmenü, indem Sie mit der rechten Maustaste auf eine beliebige Datei oder einen beliebigen Ordner klicken. Auf die Optionen In Server exportieren oder Aus Server importieren können Sie zugreifen.

chlimage_1-56

HINWEIS

Wenn sich der ausgewählte Eintrag außerhalb des Ordners jcr_root befindet, sind die Kontextmenüeinträge Nach Server exportieren und Aus Server importieren deaktiviert.

Vollständige Content-Package-Synchronisierung

Im Menü AEM können die Optionen Inhaltspaket exportieren oder Inhaltspaket importieren das gesamte Projekt mit dem Server synchronisieren.

chlimage_1-57

Synchronisierungsstatus

Die AEM Brackets-Erweiterung verfügt über ein Benachrichtigungssymbol in der Symbolleiste rechts im Fenster „Brackets“, das den Status der letzten Synchronisierung angibt:

  • grün - alle Dateien wurden erfolgreich synchronisiert
  • blau - eine Synchronisierung wird ausgeführt
  • gelb - einige der Dateien wurden nicht synchronisiert
  • rot - keine Dateien wurden synchronisiert

Wenn Sie auf das Benachrichtigungssymbol klicken, wird das Dialogfeld „Synchronisierungsstatusbericht“ geöffnet, das den Status aller synchronisierten Dateien anzeigt.

chlimage_1-58

HINWEIS

Nur Inhalt, der in den Filterregeln von filter.xml als enthalten gekennzeichnet ist, wird unabhängig von der verwendeten Synchronisierungsmethode synchronisiert.

Darüber hinaus werden .vltignore-Dateien unterstützt, um Inhalte von der Synchronisierung zum und vom Repository auszuschließen.

Bearbeiten von HTL-Code

Die AEM Brackets-Erweiterung bietet auch eine automatische Vervollständigung, um das Schreiben von HTL-Attributen und -Ausdrücken zu vereinfachen.

Automatische Vervollständigung von Attributen

  1. Geben Sie in einem HTML-Attribut sly ein. Das Attribut wird automatisch zu data-sly- - vervollständigt.
  2. Wählen Sie das HTL-Attribut in der Dropdown-Liste aus.

Automatische Vervollständigung von Ausdrücken

Innerhalb eines Ausdrucks ${} werden allgemeine Variablennamen automatisch ausgefüllt.

Weitere Informationen

Die AEM Brackets-Erweiterung ist ein Open-Source-Projekt, das von Adobe Marketing Cloud unter der Apache-Lizenz Version 2.0 auf GitHub gehostet wird:

Der Brackets-Code-Editor ist auch ein Open-Source-Projekt, das auf GitHub von der Adobe Systems Incorporated Organisation gehostet wird:

Sie können gern dazu beitragen!

Auf dieser Seite