Entwickeln von Kernkomponenten developing-core-components
Wann sollten die Kernkomponenten verwendet werden? when-to-use-the-core-components
Da die Kernkomponenten völlig neu sind und mehrere Vorteile bieten, wird empfohlen, sie für neue AEM-Projekte zu verwenden. Bei vorhandenen Projekten sollte eine Migration Teil einer größeren Projektaufgabe sein, z. B. ein Rebranding oder eine Gesamtrefaktorierung.
Daher bietet Adobe folgende Empfehlungen:
- Neue Projekte
Neue Projekte sollten immer versuchen, Kernkomponenten zu verwenden. Wenn Kernkomponenten nicht direkt oder erweitert verwendet werden können, um die Projektanforderungen zu erfüllen, erstellen Sie eine benutzerdefinierte Komponente gemäß der Komponentenarchitektur, die in den Kernkomponenten festgelegt ist. Vermeiden Sie die Verwendung der Foundation-Komponenten, sofern möglich. - Existierende Projekte
Empfohlen wird, weiterhin die Foundation-Komponenten zu verwenden, es sei denn, es ist eine Refaktorierung von Sites oder Komponenten geplant.
Da sie sehr häufig von den meisten vorhandenen Projekten verwendet werden, werden die Foundation-Komponenten weiterhin unterstützt. - Neue benutzerdefinierte Komponenten
Überprüfen Sie, ob eine vorhandene Kernkomponente angepasst werden kann.
Wenn nicht, wird empfohlen, eine neue benutzerdefinierte Komponente zu erstellen, die den Komponentenrichtlinien folgt. - Vorhandene benutzerdefinierte Komponenten
Wenn Ihre Komponenten erwartungsgemäß funktionieren, behalten Sie sie unverändert bei.
Falls nicht, siehe oben „Neue benutzerdefinierte Komponenten“.
So haben Sie Erfolg mit den Kernkomponenten how-to-succeed
Die Kernkomponenten sind leistungsstark, flexibel und einfach zu verwenden und anzupassen. Die Einhaltung einiger wichtiger Richtlinien stellt sicher, dass Ihr Projekt mit den Kernkomponenten erfolgreich ist.
Migration zu den Kernkomponenten
Jedes neue Projekt sollte mit Kernkomponenten implementiert werden. Bestehende Projekte verfügen jedoch meist über umfassende Implementierungen der Foundation-Komponenten.
Migration von Foundation-Komponenten from-foundation
Eine größere Arbeit an einem vorhandenen Projekt (z. B. ein Rebranding oder eine Gesamtrefaktorierung) bietet oft eine Möglichkeit, zu den Kernkomponenten zu migrieren. Um diese Migration zu erleichtern, stellt Adobe eine Reihe von Migrationswerkzeugen bereit, um die Akzeptanz der Kernkomponenten und der neuesten AEM-Technologie zu fördern.
Die AEM-Modernisierungs-Tools ermöglichen eine einfache Konvertierung von:
- Statischen Vorlagen in bearbeitbare Vorlagen
- Design-Konfigurationen in Richtlinien
- Foundation-Komponenten in Kernkomponenten
- Klassische Benutzeroberfläche in Touch-optimierte Benutzeroberfläche
Weitere Informationen zur Verwendung dieser Werkzeuge finden Sie in der entsprechenden Dokumentation.
Migration mit Move zu AEM as a Cloud Service via-aemaacs
Da AEM as a Cloud Service automatisch mit der neuesten Version der Kernkomponenten geliefert wird, müssen Sie beim Wechsel von einer On-Premise-AEM-Installation alle Abhängigkeiten zu den Kernkomponenten in der Datei pom.xml
Ihres Projekts entfernen.
Ihre Proxy-Komponenten funktionieren weiterhin wie zuvor, da Proxys auf den erforderlichen Supertyp zeigen und der Supertyp-Pfad die Version enthält. Auf diese Weise ermöglicht das einfache Entfernen der Abhängigkeit, dass die Kernkomponenten in AEMaaCS genauso funktionieren, wie sie es On-Premise taten.
Wie bei jedem anderen AEMaaCS-Projekt müssen Sie auch eine Abhängigkeit zur AEM SDK-JAR-Datei hinzufügen. Dies ist nicht spezifisch für die Kernkomponenten, aber es ist erforderlich.
<dependency>
<groupId>com.adobe.aem</groupId>
<artifactId>aem-sdk-api</artifactId>
</dependency>
Weitere Informationen zu AEMaaCS-Projekten finden Sie im Dokument Projektstruktur in AEM.
Kernkomponentenunterstützung core-component-support
Kernkomponenten sind ein integraler Bestandteil von AEM und werden ohne Mängelgewähr unterstützt, zu den gleichen Bedingungen und Konditionen, als ob sie im Rahmen des Quickstarts geliefert würden.
Wie andere AEM-Produktmerkmale lautet die allgemeine Regel: Komponenten werden zunächst als veraltet angekündigt und frühestens in der folgenden AEM-Version entfernt. Dadurch erhalten Kunden mindestens einen Versionszyklus, um zur neuen Version der Komponente zu wechseln, bevor deren Unterstützung eingestellt wird.
Die Version jeder Komponente gibt eindeutig die AEM-Versionen an, die sie unterstützt. Wenn der Support für eine Version von AEM eingestellt wird, gilt das auch für die Unterstützung der Kernkomponenten für diese Version von AEM.
Weitere Informationen zur Unterstützung von Komponentenanpassungen finden Sie auf der Seite Anpassen von Kernkomponenten.
Technische Funktionen technical-capabilities
In der folgenden Tabelle finden Sie einen Überblick über die Unterschiede zwischen Kernkomponenten und Foundation-Komponenten.
Einzelheiten zu ihren Authoring-Fähigkeiten und Optionen zu ihrer Vorkonfiguration finden Sie auf der entsprechenden Authoring-Seite.
Komponentenliste component-list
In der folgenden Tabelle sind die verfügbaren Kernkomponenten mit Links zu ihrer API aufgeführt und es wird angegeben, welche Foundation-Komponenten sie ersetzen.
/libs/foundation/components/page /libs/wcm/foundation/components/page
/libs/foundation/components/text /libs/foundation/components/table /libs/wcm/foundation/components/text
/libs/foundation/components/image /libs/foundation/components/adaptiveimage /libs/foundation/components/logo /libs/foundation/components/mobileimage /libs/foundation/components/mobilelogo /libs/wcm/foundation/components/image
/libs/foundation/components/list /libs/foundation/components/mobilelist /libs/wcm/foundation/components/list
/libs/foundation/components/form/start /libs/foundation/components/form/end
/libs/foundation/components/form/text /libs/foundation/components/form/password
/libs/foundation/components/form/checkbox /libs/foundation/components/form/radio /libs/foundation/components/form/dropdown
/libs/foundation/components/form/submit
/libs/foundation/components/topnav /libs/foundation/components/mobiletopnav
-
/libs/foundation/components/search
-
-
/libs/foundation/components/carousel
/libs/cq/experience-fragments/editor/components/experiencefragment
Aktualisierung der Kernkomponenten upgrade-of-core-components
Ein Vorteil versionierter Komponenten besteht darin, dass die Migration auf eine neue AEM-Version von der Migration auf neue Komponentenversionen getrennt werden kann. Wenn neue Komponentenversionen verfügbar sind, wird außerdem die einzelne Migration jeder Komponente zur neuen Version ermöglicht.
Die Migration zu einer neuen AEM-Version wirkt sich nicht auf die Funktionsweise der Kernkomponenten aus, sofern ihre Versionen auch die neue AEM-Version unterstützen, auf die migriert wird. An den Kernkomponenten vorgenommene Anpassungen sollten ebenfalls nicht beeinträchtigt werden, sofern sie keine veralteten oder entfernten APIs verwenden.
Migrationen auf neue Versionen der Kernkomponenten wirken sich nicht auf die Funktionsweise der Komponente aus, aber es können ggf. neue Funktionen für Seitenautoren eingeführt werden, was möglicherweise einige Konfigurationen durch einen Vorlageneditor erfordert, falls das Standardverhalten nicht gewünscht wird. Anpassungen müssen jedoch ggf. angepasst werden. Weitere Informationen finden Sie auf der Seite Anpassen von Kernkomponenten.