Adobe Experience Manager as a Cloud Service offre de nouvelles fonctionnalités à une cadence mensuelle, conformément au planning de la feuille de route des versions d’Experience Manager. Pour vous familiariser avec les fonctionnalités programmées pour le mois suivant, les clients peuvent s’abonner au canal de version préliminaire, accessible en configurant de manière appropriée des environnements de développement de programme standard ou tout environnement de programme de test. Les clients peuvent prévisualiser les modifications apportées à la console Sites, mais aussi créer du code lié à toute nouvelle API de version préliminaire.
La liste des fonctionnalités de version préliminaire pour un mois donné est publiée dans les notes de mise à jour mensuelles.
Les fonctionnalités de la version préliminaire peuvent être expérimentées de différentes manières :
Pour afficher les nouvelles fonctionnalités de la console Sites dans les environnements de développement cloud, ainsi que le résultat de toute personnalisation de projet :
PATCH /program/{programId}/environment/{environmentId}/variables
[
{
"name" : "AEM_RELEASE_CHANNEL",
"value" : "prerelease",
"type" : "string"
}
]
L’interface de ligne de commande de Cloud Manager peut également être utilisée, conformément aux instructions à l’adresse https://github.com/adobe/aio-cli-plugin-cloudmanager#aio-cloudmanagerset-environment-variables-environmentid
aio cloudmanager:environment:set-variables <ENVIRONMENT_ID> --programId=<PROGRAM_ID> --variable AEM_RELEASE_CHANNEL “prerelease”
La variable peut être supprimée ou redéfinie sur une autre valeur si vous souhaitez que l’environnement soit restauré avec le comportement du canal normal (hors version préliminaire).
Vous pouvez voir les nouvelles fonctionnalités de la console Sites dans le SDK Quickstart local et le code par rapport aux nouvelles API dans la version préliminaire en demandant à votre projet Maven de référencer la version préliminaire API Jar
située dans Maven Central. Vous pouvez également voir ces fonctionnalités sur votre ordinateur local en démarrant le SDK Quickstart standard en mode version préliminaire :
-r prerelease
.Comme il peut y avoir plusieurs versions de maintenance AEM entre les versions mensuelles des fonctionnalités, vous pouvez télécharger ces nouveaux SDK et référencer les nouvelles versions du SDK API Jar dans les projets Maven. Les versions de maintenance n’ajouteront pas de fonctionnalités de version préliminaire supplémentaires, mais pourraient inclure d’autres modifications plus modestes comme des correctifs de bogues ou de sécurité et des améliorations de performances.
Les JavaDocs sont publiés sur Maven Central.
Pour créer un build à partir du SDK de version préliminaire :
modifiez le fichier pom.xml de votre projet maven pour référencer un fichier jar api du sdk de version préliminaire distinct, qui est publié sur Maven central. Il contient une nouvelle api Java éventuelle pour les fonctionnalités de la version préliminaire et possède une dépendance liée au jar de l’api du sdk. Il utilise la même version.
À titre d’exemple, voici un extrait de code de la section de gestion des dépendances du modèle pom parent faisant référence au fichier Jar d’API classique :
<dependencyManagement>
<dependencies>
<dependency>
<groupId>com.adobe.aem</groupId>
<artifactId>aem-sdk-api</artifactId>
<version>${aem.sdk.api}</version>
<scope>provided</scope>
</dependency>
Puis l’utilisation dans un module :
<dependencies>
<dependency>
<groupId>com.adobe.aem</groupId>
<artifactId>aem-sdk-api</artifactId>
</dependency>
Pour passer au SDK de la version préliminaire, remplacez simplement la dépendance de com.adobe.aem:aem-sdk-api
par com.adobe.aem:aem-prerelease-sdk-api
comme indiqué ci-dessous :
<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>
Comme d’habitude, les projets individuels peuvent utiliser la dépendance.
Déploiement sur votre serveur local
Si vous êtes satisfait de son fonctionnement local, validez le code d’une branche de développement et utilisez un pipeline hors production Cloud Manager pour le déploiement dans un environnement abonné au canal de version préliminaire.
L’artifactId aem-prerelease-sdk-api
ne doit jamais être utilisé lors d’un déploiement dans l’environnement intermédiaire ou de production. Utilisez toujours aem-sdk-api lors d’un déploiement via le pipeline de production. De même, les API de version préliminaire de référencement de code ne doivent pas être déployées via le pipeline de production.
Le module externe maven d’analyseur de build du SDK CS AEM version 1.0, et versions ultérieures détectera si l’api de version préliminaire est utilisée dans un projet en examinant les dépendances. Si l’analyseur le trouve, il utilisera l’api sdk de version préliminaire pour analyser le projet.
Éléments à retenir concernant le canal de version préliminaire :
Adobe Experience Manager 2021.4.5226.20210427T070726Z-210429-PRERELEASE
.