Configuration des outils de développement

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. Ces outils prennent en charge le développement et la création de projets AEM.

Notez que ~ est utilisé comme abrégé pour le répertoire de l’utilisateur. Sous Windows, cela équivaut à %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 as a Cloud Service AEM.

  1. Téléchargez et installez 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 la saumure 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 de 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.
  1. Vérifiez que Homebrew est installé en exécutant la commande : brew --version

Homebrew

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

Installation de 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é à l’aide de 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é à l’aide de la commande : $ git --version

Git

Installation de Node.js (et npm)

Node.js est un environnement d’exécution JavaScript utilisé pour fonctionner avec les ressources front-end d’un projet AEM ui.frontend sous-projet. Node.js est distribué avec npm, est le gestionnaire de modules Node.js par défaut, 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

AEM Archétype de projetAEM Projets basés sur , installez 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 AEM Project Reactor pom.xml pour savoir où trouver les versions Node.js et npm build.

Installer Maven

Apache Maven est l’outil de ligne de commande Java open source utilisé pour créer AEM projets 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

Configuration de l’interface de ligne de commande Adobe I/O

La variable 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 de :

Installation de 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écuter node --version confirmer
  2. Exécuter npm install -g @adobe/aio-cli pour installer le aio module npm globalement

Configuration du module externe Adobe I/O CLI Cloud Manager

Le module externe Adobe I/O Cloud Manager permet à l’interface de ligne de commande d’AEM d’interagir avec Adobe Cloud Manager via l’interface de ligne de commande aio cloudmanager .

  1. Exécuter aio plugins:install @adobe/aio-cli-plugin-cloudmanager pour installer le module externe d’aio Cloud Manager.

Configuration de l’authentification de l’interface de ligne de commande Adobe I/O

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

  1. Connexion à 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. Créer ou ouvrir un Programme Adobe I/O
    • Les programmes Adobe I/O Console sont simplement des regroupements organisationnels d’intégrations, de créer ou d’utiliser et de programmes existants en fonction de la manière dont vous souhaitez gérer vos intégrations.
    • Si vous créez un projet, sélectionnez "Projet vide" si vous y êtes invité (au lieu de "Créer à partir d’un modèle").
    • Les programmes Adobe I/O Console sont des concepts différents des programmes Cloud Manager.
  4. Créez une nouvelle intégration de l’API Cloud Manager avec le profil "Développeur - Cloud Service"
  5. L’obtention des informations d’identification du compte de service (JWT) doit être renseignée dans l’interface de ligne de commande d’Adobe I/O. config.json
  6. Chargez la variable config.json dans l’interface de ligne de commande de l’Adobe I/O.
    • $ aio config:set ims.contexts.aio-cli-plugin-cloudmanager PATH_TO_CONFIG_JSON_FILE --file --json
  7. Chargez la variable private.key dans l’interface de ligne de commande de l’Adobe I/O.
    • $ aio config:set ims.contexts.aio-cli-plugin-cloudmanager.private_key PATH_TO_PRIVATE_KEY_FILE --file

Début exécution des commandes pour Cloud Manager via l’interface de ligne de commande d’Adobe I/O.

Configuration du module AEM Rapid Development Environment

Le module AEM Rapid Development Environment permet à l’interface de ligne de commande d’aio d’interagir avec AEM as a Cloud Service Environnements de développement rapide via le aio aem:rde .

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

Configuration du module Adobe I/O d’Asset compute de l’interface de ligne de commande

Le module externe Adobe I/O Cloud Manager permet à l’interface de ligne de commande d’aio de générer et d’exécuter des objets Worker Asset compute via l’interface de ligne de commande aio asset-compute .

  1. Exécuter aio plugins:install @adobe/aio-cli-plugin-asset-compute pour installer le module externe aio Asset compute.

Configuration de 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 populaires pour le développement AEM.

IntelliJ IDEA

IntelliJ IDEA est un IDE puissant pour le développement de Java. IntelliJ IDEA est disponible en deux versions, une édition communautaire gratuite et une version finale commerciale (payante). La version communautaire libre est suffisante pour AEM développement, mais la version Ultimate développe son ensemble de fonctionnalités..

Code Visual Studio Microsoft

Visual Studio Code (VS Code) est un outil libre et open source pour les développeurs 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 front-end qui créent principalement du code frontal : JavaScript, CSS et HTML. Bien que VS Code dispose d’une prise en charge Java via extensions, il peut ne pas disposer de certaines fonctionnalités avancées fournies par des fonctionnalités plus spécifiques à Java.

Eclipse

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

Sur cette page