Configurer des outils de développement

Dernière mise à jour : 2024-01-26
  • Créé pour :
  • Beginner
    Developer

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 :
$ java --version
$ java -version
$ 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.

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

$ xcode-select --install
  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.

  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.

  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 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.

  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.

  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.

CONSEIL

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.

  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

  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

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

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’organisation Adobe.
  3. Ouvrez un programme Adobe I/O existant ou créez-en un.
    • Les programmes de console Adobe I/O sont simplement des regroupements organisationnels d’intégrations. Créez ou utilisez un programme 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 de l’API Cloud Manager avec le profil « Développement - 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.
  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 --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 --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

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

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..

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.

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.

Sur cette page