DocumentationAEMTutoriels AEMTutoriels d’AEM as a Cloud Service

Configurer des outils de développement set-up-development-tools

Last update: Mon Sep 23 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Créé pour :

  • Débutant
  • Développeur

Le développement d’Adobe Experience Manager (AEM) nécessite l’installation et la configuration d’un jeu minimal d’outils de développement sur la machine du développeur ou de la développeuse. Ces outils prennent en charge le développement et la création de projets AEM.

Notez que ~ est utilisé comme raccourci pour le répertoire de l’utilisateur ou de l’utilisatrice. Sous Windows, il s’agit de l’équivalent de %HOMEPATH%.

Installer Java

Experience Manager est une application Java qui requiert donc le SDK Java pour prendre en charge le développement et le SDK AEM as a Cloud Service.

  1. Télécharger et installer la dernière version du SDK Java 11
  2. Vérifiez que le SDK Oracle Java 11 est installé en exécutant la commande :
macOS
code language-shell 
$ java --version
Windows
code language-shell 
$ java -version
Linux
code language-shell 
$ java --version

Java.

Installer Homebrew

L’utilisation de Homebrew est facultative, mais recommandée.

Homebrew est un gestionnaire de packages Open Source pour macOS, Windows et Linux. Tous les outils de prise en charge peuvent être installés séparément. Homebrew offre un moyen pratique d’installer et de mettre à jour divers outils de développement requis pour le développement d’Experience Manager.

  1. Ouvrez votre terminal.
  2. Vérifiez si Homebrew est déjà installé en exécutant la commande : brew --version.
  3. Si Homebrew n’est pas installé, installez Homebrew.
macOS

Homebrew sur macOS nécessite Xcode ou les outils de ligne de commande, qui peuvent être installés via la commande :

code language-shell 
$ xcode-select --install
Windows
Installer Homebrew sous Windows 10
Linux
Installer Homebrew sous Linux
  1. Vérifiez que Homebrew est installé en exécutant la commande : brew --version.

Homebrew.

Si vous utilisez Homebrew, suivez les instructions Installation à l’aide de Homebrew dans les sections ci-dessous. Si vous n’utilisez pas Homebrew, installez les outils à l’aide des liens spécifiques au système d’exploitation.

Installer Git

Git est le système de gestion du contrôle de code source utilisé par Adobe Cloud Manager, et est donc nécessaire au développement.

Installer Git à l’aide de Homebrew

  1. Ouvrez votre invite de commande/terminal.

  2. Exécutez la commande : $ brew install git

  3. Vérifiez que Git est installé en exécutant la commande : $ git --version.

Télécharger et installer Git

  1. Télécharger et installer Git

  2. Ouvrez votre invite de commande/terminal.

  3. Vérifiez que Git est installé en exécutant la commande : $ git --version.

Git.

Installer Node.js (et npm) node-js

Node.js est un environnement d’exécution JavaScript utilisé pour fonctionner avec les ressources front-end du sous-projet ui.frontend d’un projet AEM. Node.js est distribué avec npm, qui est de facto le gestionnaire de packages Node.js utilisé pour gérer les dépendances JavaScript.

Installer Node.js à l’aide de Homebrew

  1. Ouvrez votre invite de commande/terminal.

  2. Exécutez la commande : $ brew install node

  3. Vérifiez que Node.js est installé à l’aide de la commande : $ node -v.

  4. Vérifiez que npm est installé à l’aide de la commande : $ npm -v.

Télécharger et installer Node.js

  1. Télécharger et installer Node.js

  2. Ouvrez votre invite de commande/terminal.

  3. Vérifiez que Node.js est installé à l’aide de la commande : $ node -v.

  4. Vérifiez que npm est installé à l’aide de la commande : $ npm -v.

Node.js et npm.

TIP
Les projets AEM basés sur l’archétype de projet AEM installent une version isolée de Node.js au moment de la création. Il est conseillé de conserver la version du système de développement local synchronisée (ou proche) des versions Node.js et npm spécifiées dans le fichier Reactor pom.xml de votre projet Maven AEM.
Voir cet exemple fichier Reactor pom.xml de projet AEM pour savoir où trouver les versions build Node.js et npm.

Installer Maven

Apache Maven est l’outil de ligne de commande Java open source utilisé pour créer des projets AEM générés à partir de l’archétype Maven de projet AEM. Tous les principaux IDE (IntelliJ IDEA, Visual Studio Code, Eclipse, etc.) ont intégré la prise en charge de Maven.

Installer Maven à l’aide de Homebrew

  1. Ouvrez votre invite de commande/terminal.

  2. Exécutez la commande : $ brew install maven

  3. Vérifiez que Maven est installé à l’aide de la commande : $ mvn -v

Télécharger et installer Maven

  1. Télécharger Maven

  2. Installer Maven

  3. Ouvrez votre invite de commande/terminal.

  4. Vérifiez que Maven est installé à l’aide de la commande : $ mvn -v

Maven.

Configurer l’interface de ligne de commande Adobe I/O aio-cli

L’Interface de ligne de commande Adobe I/O, ou aio, permet d’accéder à divers services Adobe en ligne de commande, notamment : Cloud Manager et Asset Compute. L’interface de ligne de commande d’Adobe I/O joue un rôle essentiel dans le développement sur AEM as a Cloud Service, car elle permet aux développeurs et aux développeuses de :

  • Suivre des journaux à partir des services AEM as a Cloud Services.
  • Gérer des pipelines de Cloud Manager à partir de l’interface de ligne de commande.
  • Effectuer le déploiement sur des environnements de développement rapide AEM.

Installer l’interface de ligne de commande d’Adobe I/O

  1. Assurez-vous que Node.js est installé, car l’interface de ligne de commande Adobe I/O est un module npm.
    • Exécutez node --version pour confirmer.
  2. Exécutez npm install -g @adobe/aio-cli pour installer le module npm aio globalement.

Configurer l’interface de ligne de commande d’Adobe I/O avec le plug-in Cloud Manager aio-cloud-manager

Le plug-in Adobe I/O Cloud Manager permet à l’interface de ligne de commande d’Adobe I/O d’interagir avec Adobe Cloud Manager via la commande aio cloudmanager.

  1. Exécutez aio plugins:install @adobe/aio-cli-plugin-cloudmanager pour installer le plug-in Adobe I/O Cloud Manager.

Configurer l’authentification de l’interface de ligne de commande d’Adobe I/O

Pour que l’interface de ligne de commande d’Adobe I/O communique avec Cloud Manager, une intégration de Cloud Manager doit être créée dans la console Adobe I/O, et les informations d’identification doivent être obtenues pour une authentification réussie.

  1. Connectez-vous à console.adobe.io.

  2. Assurez-vous que votre organisation qui comprend le produit Cloud Manager auquel se connecter est active dans le sélecteur d’organisations Adobe.

  3. Ouvrez un programme Adobe I/O existant ou créez-en un.

    • Les projets de console Adobe I/O sont simplement des regroupements organisationnels d’intégrations. Créez ou utilisez un projet existant en fonction de la manière dont vous souhaitez gérer vos intégrations.
    • Si vous créez un projet, sélectionnez « Projet vide », le cas échéant (au lieu de « Créer à partir d’un modèle »).
    • Les programmes de console Adobe I/O sont des concepts différents des programmes Cloud Manager.

  4. Créer une intégration d’API Cloud Manager

    • Sélectionnez le type d’authentification obsolète « Compte de service (JWT) » (OAuth n’est pour l’instant pas pris en charge pour l’interface de ligne de commande).
    • Créez ou chargez des clés.
    • Sélectionnez le profil de produit « Développeur - Cloud Service ».

  5. Obtenez les informations d’identification du compte de service (JWT) nécessaires pour remplir le fichier config.json de l’interface de ligne de commande d’Adobe I/O.

    code language-json 
    //config.json
{
   "client_id": "Client ID from Service Account (JWT) credential",
   "client_secret": "Client Secret from Service Account (JWT) credential",
   "technical_account_id": "Technical Account ID from Service Account (JWT) credential",
   "ims_org_id": "Organization ID from Service Account (JWT) credential",
   "meta_scopes": [
     "ent_cloudmgr_sdk"
   ]
}

  6. Chargez le fichier config.json dans l’interface de ligne de commande d’Adobe I/O.

    • $ aio config:set ims.contexts.aio-cli-plugin-cloudmanager ./path/to/config.json --file --json

  7. Chargez le fichier private.key dans l’interface de ligne de commande d’Adobe I/O.

    • $ aio config:set ims.contexts.aio-cli-plugin-cloudmanager.private_key ./path/to/private.key --file

Commencez à exécuter des commandes pour Cloud Manager via l’interface de ligne de commande d’Adobe I/O.

Configurer le plug-in Environnements de développement rapide AEM rde

Le plug-in Environnements de développement rapide AEM permet à l’interface de ligne de commande d’AIO d’interagir avec les environnements de développement rapide AEM as a Cloud Service via la commande aio aem:rde.

  1. Exécutez aio plugins:install @adobe/aio-cli-plugin-aem-rde pour installer le plug-in Environnements de développement rapide AEM.

Configurer le plug-in Asset Compute de l’interface de ligne de commande d’Adobe I/O aio-asset-compute

Le plug-in Cloud Manager d’Adobe I/O permet à l’interface de ligne de commande d’AIO de générer et d’exécuter des programmes de travail Asset Compute via la commande aio asset-compute.

  1. Exécutez aio plugins:install @adobe/aio-cli-plugin-asset-compute pour installer le plug-in Asset Compute d’AIO.

Configurer l’IDE de développement

Le développement AEM consiste principalement en un développement Java et front-end (JavaScript, CSS, etc.) et en une gestion XML. Voici les IDE les plus appréciés pour le développement AEM.

IntelliJ IDEA

IntelliJ IDEA est un IDE puissant pour le développement Java. IntelliJ IDEA est disponible en deux versions, une édition Community gratuite et une version Ultimate commerciale (payante). La version Community gratuite est suffisante pour le développement AEM, mais la version Ultimate élargit ses fonctionnalités..

https://video.tv.adobe.com/v/39739?quality=12&learn=on&captions=fre_fr

Microsoft Visual Studio Code

Visual Studio Code (VS Code) est un outil gratuit et open source pour les développeurs et les développeuses front-end. Visual Studio Code peut être configuré pour intégrer la synchronisation de contenu avec AEM à l’aide d’un outil Adobe, Repo.

Visual Studio Code est le choix idéal pour les développeurs et les développeuses front-end qui créent principalement du code front-end : JavaScript, CSS et HTML. Bien que VS Code dispose d’une prise en charge Java via les extensions, il peut ne pas disposer de certaines fonctionnalités avancées fournies par des outils plus spécifiques à Java.

https://video.tv.adobe.com/v/25907?quality=12&learn=on

Eclipse

Eclipse IDE est un IDE populaire pour le développement Java et prend en charge le plug-in Outils de développement AEM fourni par Adobe, fournissant une interface utilisateur graphique intégrée pour la création et la synchronisation du contenu JCR avec une instance AEM locale.

https://video.tv.adobe.com/v/25906?quality=12&learn=on

recommendation-more-help
4859a77c-7971-4ac9-8f5c-4260823c6f69