DokumentationAEM 6.5Benutzerhandbuch

AEM Brackets-Erweiterung aem-brackets-extension

Last update: Thu Apr 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Erstellt für:

  • Developer

Übersicht overview

Die AEM Brackets-Erweiterung bietet einen reibungslosen Workflow für die Bearbeitung von AEM-Komponenten und Client-Bibliotheken und nutzt den Brackets-Code-Editor, um auf Photoshop-Dateien und -Ebenen zuzugreifen. 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 Unterstützung für die HTML Template Language (HTL), die JSP die Komplexität nimmt, um die Komponentenentwicklung einfacher und sicherer zu machen.

chlimage_1-53

Funktionen features

Die Hauptmerkmale der AEM Brackets-Erweiterung:

  • Automatische Synchronisierung geänderter Dateien mit der AEM-Entwicklungsinstanz
  • Manuelle bidirektionale Synchronisierung von Dateien und Ordnern
  • Vollständige Content-Package-Synchronisierung des Projekts
  • HTL-Code-Vervollständigung für Ausdrücke und data-sly-*-Blockanweisungen.

Zusätzlich bietet Brackets viele nützliche Funktionen für AEM-Front-End-Entwickelnde:

  • Photoshop-Dateiunterstützung zum Extrahieren von Informationen aus einer PSD-Datei, z. B. Ebenen, Maße, Farben, Schriften, Texte usw.
  • Code-Hinweise aus der PSD, um diese extrahierten Informationen im Code einfach wiederzuverwenden
  • CSS-Präprozessor-Unterstützung wie LESS und SCSS.
  • Hunderte zusätzlicher Erweiterungen für spezifischere Anforderungen

Installation installation

Brackets brackets

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

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

Die Erweiterung the-extension

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

  1. Öffnen Sie Brackets. Wählen Sie im Menü Datei die Option Extension Manager aus.

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

    chlimage_1-54

  3. Klicken Sie auf Installieren.

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

Erste Schritte getting-started

Das Content-Package-Projekt the-content-package-project

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

Das Projekt muss mindestens Folgendes enthalten:

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

  2. eine Datei filter.xml (z. B. myproject/META-INF/vault/filter.xml); für weitere Informationen zur Struktur der Datei filter.xml siehe Workspace-Filter-Definition

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

NOTE
Wenn Sie kein eigenes Projekt mit einem Inhaltspaket haben, können Sie die HTL TodoMVC-Beispiel. Klicken Sie auf GitHub auf Zip-Datei herunterladen, extrahieren Sie die Dateien lokal und öffnen Sie wie oben beschrieben den Ordner jcr_root in Brackets. Führen Sie dann die folgenden Schritte aus, um die Projekteinstellungen einzurichten, und laden Sie schließlich das gesamte Paket in Ihre AEM-Entwicklungsinstanz hoch, indem Sie das Content-Package exportieren, wie weiter unten im Abschnitt „Vollständige Content-Package-Synchronisierung“ beschrieben.
Nach diesen Schritten sollten Sie in der Lage sein, auf die URL /content/todo.html in Ihrer AEM-Entwicklungsinstanz zuzugreifen, und Sie können Änderungen am Code in Brackets vornehmen und sehen, wie nach einer Aktualisierung im Webbrowser die Änderungen sofort mit dem AEM-Server synchronisiert wurden.

Projekteinstellungen project-settings

Um Ihren Inhalt mit einer AEM-Entwicklungsinstanz zu synchronisieren, müssen Sie Ihre Projekteinstellungen definieren. Dies erreichen Sie, indem Sie das Menü AEM aufrufen und Projekteinstellungen wählen.

chlimage_1-55

In den Projekteinstellungen können Sie Folgendes definieren:

  1. Server-URL (z. B. http://localhost:4502)
  2. Ob Server ohne gültiges HTTPS-Zertifikat toleriert werden sollen (deaktivieren Sie diese Option, falls nicht erforderlich)
  3. Benutzername, der für die Synchronisierung von Inhalten verwendet wird (z. B. admin)
  4. Benutzerkennwort (z. B. admin)

Synchronisieren von Inhalten synchronizing-content

Die AEM Brackets-Erweiterung bietet folgende Arten der Inhaltssynchronisierung für Dateien und Ordner, die von den in filter.xml definierten Filterregeln zugelassen sind:

Automatisierte Synchronisierung geänderter Dateien automated-synchronization-of-changed-files

Dadurch werden nur Änderungen von Brackets mit der AEM-Instanz synchronisiert, jedoch niemals umgekehrt.

Manuelle bidirektionale Synchronisierung manual-bidirectional-synchronization

Öffnen Sie im Projekt-Explorer das Kontextmenü, indem Sie mit der rechten Maustaste auf eine Datei oder einen Ordner klicken. Dort können Sie auf die Optionen Auf Server exportieren oder Von Server importieren zugreifen.

chlimage_1-56

NOTE
Wenn sich der ausgewählte Eintrag außerhalb des Ordners jcr_root befindet, sind die Kontextmenüoptionen Auf Server exportieren und Von Server importieren deaktiviert.

Vollständige Content-Package-Synchronisierung full-content-package-synchronization

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

chlimage_1-57

Synchronisierungsstatus synchronization-status

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: Ein Synchronisierungsvorgang wird gerade ausgeführt.
  • Gelb: Einige der Dateien wurden nicht synchronisiert.
  • Rot: Es wurden keine Dateien wurde synchronisiert.

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

chlimage_1-58

NOTE
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 editing-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 attribute-auto-completion

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

Automatische Vervollständigung von Ausdrücken expression-auto-completion

Innerhalb eines ${}-Ausdrucks werden allgemeine Variablennamen automatisch vervollständigt.

Weitere Informationen more-information

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 ebenfalls ein Open-Source-Projekt, das von Adobe Systems Incorporated auf GitHub gehostet wird:

Sie können gern dazu beitragen!

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2