Dokumentation AEM as a Cloud Service Benutzerhandbuch

Vorabversionskanal für Adobe Experience Manager as a Cloud Service prerelease-channel

Last update: Tue Jul 01 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Gilt für:
Experience Manager as a Cloud Service

Themen:

Erstellt für:

Admin

Erfahren Sie, wie Sie über den Vorabversionskanal eine Vorschau bevorstehender Funktionen von AEM as a Cloud Service erhalten.

Einführung introduction

Adobe Experience Manager as a Cloud Service führt regelmäßig neue Funktionen ein. Die Liste der neuen und bevorstehenden Funktionen bestimmter Funktionsveröffentlichungen finden Sie in den Versionshinweisen.

Bevorstehende Funktionen werden in der Regel auf eine von zwei Arten verfügbar gemacht:

Im Rahmen eines Alpha- oder Beta-Programms bzw. als Funktion mit eingeschränkter Verfügbarkeit
Im Rahmen des Vorabversionskanals

In diesem Dokument wird das Aktivieren des Vorabversionskanals beschrieben. Der Vorabversionskanal bietet Zugriff auf neue Funktionen, die in einer zukünftigen Funktionsversion von AEM eingeführt werden. Dadurch haben Sie die Möglichkeit, neue Funktionen zu prüfen und deren Einführung vor ihrer zukünftigen Veröffentlichung zu planen. Weitere Informationen zum AEM-Veröffentlichungszeitplan finden Sie im Dokument Versionshinweise für Adobe Experience Manager (AEM) as a Cloud Service.

Aktivieren des Vorabversionskanals für das Zugreifen auf und Ausprobieren von bevorstehenden Funktionen enable-prerelease

Der Vorabversionskanal kann in jeder beliebigen Entwicklungs- oder Sandbox-Umgebung aktiviert werden. Der Vorabversionskanal kann nicht in Staging- oder Produktionsumgebungen aktiviert werden.

Es kann auf zwei unterschiedliche Arten auf den Vorabversionskanal zugegriffen werden:

Cloud-Umgebungen
Lokales SDK

Cloud-Umgebungen cloud-environments

Um eine Cloud-Umgebung zu aktualisieren und den Vorabversionskanal zu verwenden, müssen Sie eine neue Umgebungsvariable hinzufügen. Dies ist entweder über die Cloud Manager-Benutzeroberfläche oder über die CLI möglich.

Hinzufügen der Umgebungsvariable über die Benutzeroberfläche add-with-ui

Melden Sie sich unter my.cloudmanager.adobe.com bei Cloud Manager an und wählen Sie die entsprechende Organisation aus.
Navigieren Sie zu dem Programm, für das Sie den Vorabversionskanal aktivieren möchten.
Wählen Sie die Umgebung aus, in der Sie den Vorabversionskanal aktivieren möchten, und greifen Sie über Programm > Umgebung > Umgebungskonfiguration auf ihre Konfiguration zu.

Fügen Sie eine neue Umgebungsvariable hinzu:

table 0-row-4 1-row-4
Name	Wert	Service angewendet	Typ
`AEM_RELEASE_CHANNEL`	`prerelease`	Alle	Variable

Speichern Sie die Änderungen und die Umgebung wird aktualisiert, wenn der Vorabversionskanal aktiviert ist.

Hinzufügen der Umgebungsvariable mithilfe der CLI add-with-cli

Sie können auch die Cloud Manager-API und -CLI verwenden, um die Umgebungsvariablen zu aktualisieren.

Legen Sie mithilfe des Umgebungsvariablen-Endpunkts der Cloud Manager-API die Umgebungsvariable AEM_RELEASE_CHANNEL auf den Wert prerelease fest.

code language-text
`PATCH /program/{programId}/environment/{environmentId}/variables [ { "name" : "AEM_RELEASE_CHANNEL", "value" : "prerelease", "type" : "string" } ]`

Die Cloud Manager-CLI kann auch verwendet werden.

code language-shell
`aio cloudmanager:environment:set-variables <ENVIRONMENT_ID> --programId=<PROGRAM_ID> --variable AEM_RELEASE_CHANNEL "prerelease`

Die Variable kann gelöscht werden, wenn Sie die Umgebung auf das Standardverhalten (nicht das Verhalten des Vorabversionskanals) zurücksetzen möchten.

Lokales SDK local-sdk

Sie können im Vorabversionskanal in Ihrem lokalen Schnellstart-SDK auf bevorstehende Funktionen zugreifen und Code für neue APIs erstellen, indem Sie Ihr Maven-Projekt auf den Vorabversionskanal API Jar in Maven Central verweisen. Sie können auch auf den Vorabversionskanal in Ihrer lokalen Entwicklungsumgebung zugreifen, indem Sie das reguläre Schnellstart-SDK im Vorabversionsmodus starten.

Starten des Schnellstart-SDK im Vorabversionsmodus prerelease-mode

Laden Sie das SDK vom Software Distribution-Portal herunter und installieren Sie es wie unter Zugriff auf das AEM as a Cloud Service-SDK beschrieben.
Fügen Sie beim Starten des QuickStart-SDK das Argument -r prerelease hinzu.

Der Wert bleibt erhalten und kann deshalb nur beim ersten Starten ausgewählt werden. Installieren Sie das SDK neu, um die Befehlszeilenoption zu ändern.

Da es zwischen den monatlichen Funktionsveröffentlichungen mehrere AEM-Wartungsversionen geben kann, können Sie diese neuen SDKs herunterladen und in Maven-Projekten auf die neuen SDK-API-JAR-Versionen verweisen. Mit den Wartungsversionen werden keine zusätzlichen Vorabversionsfunktionen hinzugefügt. Sie könnten jedoch andere kleinere Änderungen wie Fehlerbehebungen, Sicherheitskorrekturen und Leistungsverbesserungen umfassen.
Javadocs werden in Maven Central veröffentlicht.

Erstellen von Code für das Vorabversions-SDK build-sdk

Ändern Sie das pom.xml Ihres Maven-Projekts, um auf ein bestimmtes Vorabversions-SDK-API-JAR zu verweisen, das in Maven Central veröffentlicht wird. Es enthält alle neuen Java-APIs für die Vorabversionsfunktionen und ist von der SDK-API-JAR-Datei abhängig. Es verwendet dieselbe Version.

Hier finden Sie beispielsweise ein Snippet aus dem Abschnitt zur Abhängigkeitsverwaltung des übergeordneten POM, das auf das reguläre API-JAR verweist:

code language-none
`<dependencyManagement> <dependencies> <dependency> <groupId>com.adobe.aem</groupId> <artifactId>aem-sdk-api</artifactId> <version>${aem.sdk.api}</version> <scope>provided</scope> </dependency>`

Und dann die Verwendung in einem Modul:

code language-none
`<dependencies> <dependency> <groupId>com.adobe.aem</groupId> <artifactId>aem-sdk-api</artifactId> </dependency>`

Um zum Vorabversions-SDK zu wechseln, ändern Sie einfach die Abhängigkeit von com.adobe.aem:aem-sdk-api zu com.adobe.aem:aem-prerelease-sdk-api wie unten beschrieben:

code language-none

code language-none
`<dependencyManagement> <dependencies> <dependency> <groupId>com.adobe.aem</groupId> <artifactId>aem-prerelease-sdk-api</artifactId> <version>${aem.sdk.api}</version> <scope>provided</scope> </dependency> <dependencies> <dependency> <groupId>com.adobe.aem</groupId> <artifactId>aem-prerelease-sdk-api</artifactId> </dependency>`

<dependencyManagement>
 <dependencies>
   <dependency>
         <groupId>com.adobe.aem</groupId>
         <artifactId>aem-prerelease-sdk-api</artifactId>
         <version>${aem.sdk.api}</version>
         <scope>provided</scope>
   </dependency>
<dependencies>
   <dependency>
      <groupId>com.adobe.aem</groupId>
      <artifactId>aem-prerelease-sdk-api</artifactId>
   </dependency>

Wie üblich können einzelne Projekte die Abhängigkeit verwenden.

Die Bereitstellung erfolgt auf Ihrem lokalen Server.
Wenn Sie sich vergewissert haben, dass die Bereitstellung lokal wie erwartet funktioniert, übertragen Sie den Code in eine Entwicklungsverzweigung und verwenden Sie eine produktionsfremde Pipeline von Cloud Manager, um die Bereitstellung in einer Umgebung durchzuführen, die den Vorabversionskanal aktiviert hat.

CAUTION

Die aem-prerelease-sdk-api artifactId darf nie bei der Bereitstellung in einer Staging- oder Produktionsumgebung verwendet werden. Verwenden Sie bei der Bereitstellung über die Produktions-Pipeline immer die aem-sdk-api. Ebenso sollte Code, der auf Vorabversions-APIs verweist, nicht über die Produktions-Pipeline bereitgestellt werden.

Das Build Analyzer Maven-Plug-in der AEM CS-SDK der Version 1.0 und höher erkennt, ob die Vorabversions-API in einem Projekt verwendet wird, indem es die Abhängigkeiten überprüft. Wenn der Analyzer sie findet, verwendet er die Vorabversions-SDK-API, um das Projekt zu analysieren.

Zu beachten considerations

Beim Verwenden des Vorabversionskanals sind einige Aspekte zu beachten.

Der Vorabversionskanal enthält nicht unbedingt alle neuen Funktionen, die in der folgenden Version eingeführt werden sollen.
Die Vorabversionsfunktionen durchlaufen eine strenge Kontrolle zur Qualitätssicherung und sind eher als vollständige Funktionen denn als Betaversionen konzipiert. Wenn Sie Probleme bemerken, melden Sie diese, genau wie Sie es tun würden, wenn Sie Fehler bei Funktionen in regulären AEM-Versionen vermuten.
Um festzustellen, ob eine Umgebung für den Vorabversionskanal konfiguriert ist, wechseln Sie zur Info-Seite der AEM-Konsole und überprüfen Sie, ob die AEM-Versionsnummer ein PRERELEASE-Suffix wie Adobe Experience Manager 2021.4.5226.20210427T070726Z-210429-PRERELEASE aufweist.

Info

recommendation-more-help

fbcff2a9-b6fe-4574-b04a-21e75df764ab