DokumentationAEMAnleitung zu den Hauptkomponenten

Verwenden von Kernkomponenten using-core-components

Last update: Mon Dec 30 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Erstellt für:

  • Entwickler
  • Admin
  • Benutzende

Um mit Kernkomponenten in Ihrem eigenen Projekt produktiv zu werden, sind vier Schritte erforderlich, die in den folgenden Abschnitten einzeln erläutert werden:

  1. Herunterladen und installieren
  2. Proxy-Komponenten erstellen
  3. Kernstile laden
  4. Komponenten aktivieren
TIP
Das folgende mehrteilige Tutorial bietet eine ausführliche Anleitung, wie Sie mit der Projekteinrichtung, den Kernkomponenten, den bearbeitbaren Vorlagen, den Client-Bibliotheken und der Komponentenentwicklung von Grund auf neu beginnen können:
Erste Schritte mit AEM Sites - WKND-Tutorial
TIP
Wenn Sie den AEM-Projektarchetyp verwenden, werden die Kernkomponenten automatisch in Ihr Projekt aufgenommen, basierend auf den Empfehlungen für Best Practices von Adobe.

Herunterladen und installieren download-and-install

Einer der treibenden Ideen hinter den Kernkomponenten ist Flexibilität. Durch die häufigere Veröffentlichung neuer Versionen der Kernkomponenten kann Adobe bei der Bereitstellung neuer Funktionen flexibler sein. Entwickler wiederum können flexibel entscheiden, welche Komponenten sie in ihre Projekte integrieren und wie oft sie diese aktualisieren möchten. Dies führt zu einem separaten Veröffentlichungsprozess für AEM und die Kernkomponenten.

Daher hängen die Installationsschritten davon ab, ob Sie AEM as a Cloud Service oder On-Premise ausführen.

AEM as a Cloud Service aemaacs

Es gibt keinen Schritt eins! AEM as a Cloud Service wird automatisch mit der neuesten Version der Kernkomponenten geliefert. AEMaaCS bietet Ihnen nicht nur die neuesten Funktionen von AEM, sondern hält Sie auch automatisch mit der neuesten Version der Kernkomponenten auf dem aktuellen Stand.

Einige Punkte, die Sie beachten sollten, wenn Sie die Kernkomponenten in AEMaaCS verwenden:

  • Die Kernkomponenten sind in /libs enthalten.
  • Die Projekt-Build-Pipeline erzeugt Warnungen im Protokoll, wenn sie die Kernkomponenten erneut als Teil von /apps einbindet, und ignoriert die als Teil Ihres Projekts eingebettete Version.
    • In einer kommenden Version wird das Einbinden der Kernkomponenten den Pipeline-Build erneut fehlschlagen lassen.
  • Wenn Ihr Projekt zuvor die Kernkomponenten in /apps enthielt, müssen Sie Ihr Projekt möglicherweise anpassen.
  • Auch wenn sich die Kernkomponenten jetzt in /libs befinden, ist es nicht empfehlenswert, ein Overlay des gleichen Pfades in /apps zu erstellen. Stattdessen sollte das Proxy-Komponentenmuster verwendet werden, wenn irgendein Aspekt der Komponenten angepasst werden muss.
  • Damit die Inhaltsverzeichnis-Komponente ihren Inhalt rendern kann, muss ein Filter in OSGi konfiguriert werden.

AEM 6.5 und älter aem-65

Die Kernkomponenten sind nicht Teil des Schnellstarts, wenn Sie im Produktionsmodus (ohne Beispielinhalt) beginnen. Der erste Schritt besteht darin, das neueste veröffentlichte Inhaltspaket von GitHub herunterzuladen und es in Ihren AEM-Umgebungen zu installieren.

Es gibt verschiedene Möglichkeiten, dies zu automatisieren, aber die einfachste Möglichkeit, ein Inhaltspaket schnell auf einer Instanz zu installieren, erfolgt über den Package Manager; siehe Installieren von Paketen. Sobald Sie außerdem eine Veröffentlichungsinstanz ausgeführt haben, müssen Sie dieses Paket für den Herausgeber replizieren. Siehe Replizieren von Paketen.

Proxy-Komponenten erstellen create-proxy-components

Aus den im Abschnitt Proxy-Komponentenmuster erläuterten Gründen dürfen Kernkomponenten nicht direkt über den Inhalt referenziert werden. Um dies zu vermeiden, gehören alle zu einer ausgeblendeten Komponentengruppe (.core-wcm oder .core-wcm-form), was verhindert, dass sie direkt im Editor angezeigt werden.

Stattdessen müssen Site-spezifische Komponenten erstellt werden, die den gewünschten Komponentennamen und die gewünschte Gruppe definieren, die für Seitenautoren angezeigt werden sollen, und jede auf eine Kernkomponente als ihren übergeordneten Typ verweisen. Diese Site-spezifischen Komponenten werden manchmal als „Proxy-Komponenten“ bezeichnet, da sie nichts enthalten und hauptsächlich zur Definition der Version einer Komponente dienen, die für die Site verwendet werden soll. Beim Anpassen der Kernkomponenten spielen diese Proxy-Komponenten jedoch eine wesentliche Rolle für die Anpassung von Markup und Logik.

Für jede Kernkomponente, die für eine Site verwendet werden soll, müssen Sie also Folgendes tun:

  1. Erstellen Sie eine entsprechende Proxy-Komponente im Komponentenordner der Site.

    Beispiel
    Unter /apps/my-site/components Erstellen eines Titelknotens des Typs cq:Component

  2. Verweisen Sie auf die entsprechende Kernkomponentenversion mit dem übergeordneten Typ.

    Beispiel
    Fügen Sie folgende Eigenschaft hinzu:
    sling:resourceSuperType="core/wcm/components/title/v1/title"

  3. Definieren Sie die Gruppe, den Titel und optional die Beschreibung der Komponente. Diese Werte sind projektspezifisch und bestimmen, wie die Komponente Autoren offensteht.

    Beispiel
    Fügen Sie folgende Eigenschaften hinzu:

    code language-shell 
    componentGroup="My Site"
jcr:title="Title"
jcr:description="Section Heading"

Betrachten Sie beispielsweise die Titelkomponente der WKND-Site. Dies ist ein gutes Beispiel für eine Proxy-Komponente, die auf diese Weise aufgebaut ist.

Kernstile laden load-the-core-styles

  1. Erstellen Sie eine Client-Bibliothek, die alle CSS- und JS-Dateien enthält, die für Ihre Site benötigt werden, falls noch nicht geschehen.

  2. Fügen Sie in der Client-Bibliothek Ihrer Site die Abhängigkeiten zu den Kernkomponenten hinzu, die möglicherweise benötigt werden. Dies geschieht durch Hinzufügen einer embed Eigenschaft.

    Um beispielsweise die Client-Bibliotheken aller v1 Kernkomponenten einzubeziehen, lautet die hinzuzufügende Eigenschaft:

    code language-shell 
    embed="[
core.wcm.components.image.v1,
core.wcm.components.list.v1,
core.wcm.components.breadcrumb.v1,
core.wcm.components.form.container.v1,
core.wcm.components.form.text.v1
]"

Stellen Sie sicher, dass Ihre Proxy-Komponenten und Client-Bibliotheken in Ihrer AEM-Umgebung bereitgestellt wurden, bevor Sie zum nächsten Abschnitt übergehen.

Komponenten zulassen allow-the-components

Die folgenden Schritte werden im Vorlageneditor ausgeführt.

  1. Wählen Sie im Vorlageneditor den Layout-Container aus und öffnen Sie seine Richtlinie.
  2. Wählen Sie in der Liste der zulässigen Komponenten die zuvor erstellten Proxy-Komponenten aus, die unter der ihnen zugewiesenen Komponentengruppe angezeigt werden sollen. Übernehmen Sie anschließend die Änderungen.
  3. Optional können sie für Komponenten, die ein Dialogfeld „Design“ haben, vorkonfiguriert werden.

Das war´s! In den aus der bearbeiteten Vorlage erstellten Seiten sollten Sie jetzt die neu erstellten Komponenten verwenden können.

Lesen Sie als Nächstes:

recommendation-more-help
d2be9096-a81e-404b-9952-d8925af7219c