Aktualisieren des aem.js-Textbausteins in Adobe Experience Manager as a Cloud Service

Letzte Aktualisierung: 30. Oktober 2026

Dieser Artikel enthält Anleitungen zum Aktualisieren des aem.js-Textbausteins in Adobe Experience Manager as a Cloud Service und hebt Überlegungen zur Kompatibilität, Auswirkungen auf Workflows und empfohlene Best Practices hervor.

Beschreibung description

Umgebung

Adobe Experience Manager as a Cloud Service (alle Versionen), aem.js Textbaustein v3.0.0-v3.1.8

Problem/Symptome

Sie möchten Upstream-Änderungen an aem.js in ein vorhandenes Projekt integrieren.
Sie müssen die Auswirkungen auf benutzerdefinierte Blöcke, Skripte, die Vorschau oder die Veröffentlichung überprüfen, bevor Sie die Änderungen zusammenführen.

Ursache

Das AEM-Textbaustein ist ein Ausgangsprojekt. Änderungen am vorgelagerten Textbaustein aktualisieren ein vorhandenes Projekt nicht automatisch; Entwickler überprüfen die Änderungen und integrieren sie in ihr Projekt-Repository. Projektspezifisches Verhalten gehört in Erweiterungen außerhalb von aem.js, nicht in lokale Änderungen an der Bibliothek.

Lösung resolution

Gehen Sie wie folgt vor, um das Problem zu beheben:

Überprüfen Sie die Änderungen, die zwischen den Versionen 3.0.0 und 3.1.8 im Textbaustein aem.js eingeführt wurden.
Überprüfen Sie, ob Ihre Implementierung Version 3.1.0 verwendet. Mit dieser Version wurde eine grundlegende Änderung eingeführt, durch die die Behandlung von Abschnittsmetadaten aus decorateSections() entfernt wurde. Die Änderung wurde als Regression identifiziert und in Version 3.1.1 rückgängig gemacht.
Wenn Ihre Implementierung Version 3.1.0 verwendet, führen Sie ein Upgrade auf Version 3.1.1 oder höher durch, um die Verarbeitung von Abschnittsmetadaten wiederherzustellen.
Überprüfen Sie die Änderungen, die in den Versionen 3.1.1 bis 3.1.8 eingeführt wurden. Diese Versionen umfassen Abhängigkeitsaktualisierungen und kleinere Fehlerbehebungen, z. B. das Auflösen doppelter Kopf- und Fußzeilenblöcke und das Aktualisieren der Auflösung des Codepfads.
Bewerten Sie die Auswirkungen auf Ihre Implementierung und stellen Sie sicher, dass keine grundlegenden Änderungen die Veröffentlichungs-, Vorschau- oder Block-Rendering-Workflows beeinträchtigen. Abgesehen von der Regression in Version 3.1.0 wurden in diesen Workflows keine grundlegenden Änderungen festgestellt.
Validieren von Änderungen in einer Funktionsverzweigung vor dem Upgrade. Konfigurieren Sie die Verzweigung für die Verwendung einer Vorschauumgebung und überprüfen Sie die Änderungen, nachdem Sie den aktualisierten Code per Push übertragen haben.

Testen Sie die Änderungen lokal, bevor Sie sie veröffentlichen. Verwenden Sie die AEM-CLI, um Inhalte abzurufen und Aktualisierungen zu validieren. Die folgenden Befehle können Ihnen dabei helfen, Änderungen vor der Veröffentlichung zu überprüfen:

code language-none
`aem content clone aem up aem content diff aem content push --dry-run`

Konfigurieren Sie die Verzweigungsschutzregeln für die Hauptverzweigung und erfordern Sie Pull-Anforderungen, Statusprüfungen und aktuelle Verzweigungen, bevor Sie Änderungen zusammenführen. Dadurch wird sichergestellt, dass alle Änderungen in einer Vorschauumgebung geprüft und validiert werden, bevor sie in die Produktionsumgebung gelangen.
Testen Sie nach dem Upgrade benutzerdefinierte Blöcke und Skriptabhängigkeiten sowohl in der lokalen Umgebung als auch in der Vorschau-Umgebung sorgfältig, um die Kompatibilität zu überprüfen.
Überprüfen Sie nach dem Upgrade, ob Veröffentlichung, Vorschau, Block-Rendering, Verarbeitung von Abschnittsmetadaten, benutzerdefinierte Blöcke und Skriptabhängigkeiten erwartungsgemäß funktionieren.

recommendation-more-help

experience-cloud-kcs-help-kbarticles