Configuration des outils de développement

Le développement de Adobe Experience Manager (AEM) nécessite un ensemble minimal d'outils de développement à installer et à configurer sur la machine de développement. Ces outils soutiennent le développement et la création de projets AEM.

Notez que ~ est utilisé comme abrégé pour le Répertoire d'utilisateur. Sous Windows, il s’agit de l’équivalent de %HOMEPATH%.

Installer Java

Experience Manager est une application Java et nécessite donc le SDK Java pour prendre en charge le développement et l’AEM en tant que SDK Cloud Service.

1. Téléchargement et installation de la dernière version du SDK Java 11
2. Vérifiez que le SDK Java 11 est installé en exécutant la commande :
   • Windows : java -version
   • macOS / Linux : java --version

Installer Homebrew

L'utilisation de l'hébreu est facultative, mais recommandée.

Homebrew est un gestionnaire de paquets open-source pour macOS, Windows et Linux. Tous les outils de support peuvent être installés séparément, Homebrew offre un moyen pratique d'installer et de mettre à jour une variété d'outils de développement requis pour le développement Experience Manager.

1. Ouvrir 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.
   • Installer Homebrew sur macOS
     • Homebrew sur macOS requiert Xcode ou Outils de ligne de commande, installable via la commande :
       • xcode-select --install
   • Installer Homebrew sous Linux
   • Installer Homebrew sous Windows 10
4. Vérifiez que Homebrew est installé en exécutant la commande : brew --version

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

Installer Git

Gitis est le système de gestion du contrôle de code source utilisé par Adobe Cloud Manager et est donc requis pour le développement.

• Installer Git à l'aide de Homebrew
  1. Ouvrez l'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
• Ou, téléchargez et installez Git (macOS, Linux ou Windows).
  1. Téléchargement et installation de Git
  2. Ouvrez l'invite de commande/terminal.
  3. Vérifiez que Git est installé à l’aide de la commande : git --version

Installer Node.js (et npm)

Node. jsis est un environnement d’exécution JavaScript utilisé pour travailler avec les actifs frontaux du projet ui. frontendsub d’un projet AEM. Node.js est distribué avec npm, est le gestionnaire de package de Node.js utilisé par défaut pour gérer les dépendances JavaScript.

• Installation de Node.js à l’aide de Homebrew
  1. Ouvrez l'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
• Ou, téléchargez et installez Node.js (macOS, Linux ou Windows).
  1. Téléchargement et installation de Node.js
  2. Ouvrez l'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

Installation de Maven

Apache Maven est l'outil de ligne de commande Java open-source utilisé pour construire AEM projets générés à partir de l'archétype AEM Project Maven. Tous les principaux IDE (IntelliJ IDEA, Code Visual Studio, Eclipse, etc.) sont pris en charge par Maven.

• Installation de Maven à l’aide de Homebrew
  1. Ouvrez l'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
• Ou, téléchargez et installez Maven (macOS, Linux ou Windows)
  1. Télécharger Maven
  2. Installation de Maven
  3. Ouvrez l'invite de commande/terminal.
  4. Vérifiez que Maven est installé à l’aide de la commande : mvn -v

Configurer l'interface de ligne de commande de l'Adobe I/O

L'Adobe I/O CLI, ou aio, permet d'accéder en ligne de commande à divers services d'Adobe, y compris Cloud Manager et Asset compute. L'interface de ligne de commande de l'Adobe I/O joue un rôle essentiel dans le développement de l'AEM en tant que Cloud Service car elle permet aux développeurs de :

• Journaux de suivi des AEM en tant que services Cloud Services
• Gestion des pipelines Cloud Manager à partir de l’interface de ligne de commande

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

1. Assurez-vous que Node.js est installé car l’interface de ligne de commande de l’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 aio npm globalement.

Configuration du module Adobe I/O CLI Cloud Manager

Le module externe Adobe I/O Cloud Manager permet à l’interface de ligne de commande d’aio 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 module externe aio Cloud Manager.

Configuration du module Adobe I/O CLI Asset compute plugin

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 agents d’Asset compute via la commande aio asset-compute.

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

Configuration de l’authentification CLI Adobe I/O

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

1. Connectez-vous à console.adobe.io
2. Assurez-vous que votre organisation qui comprend le produit Cloud Manager auquel se connecter est principale dans le sélecteur d’organisation d’Adobes.
3. Créez ou ouvrez un programme d'Adobe I/O existant.
   • Les programmes de la console Adobe I/O sont simplement des regroupements organisationnels d'intégrations, de créer ou d'utiliser et des programmes existants en fonction de la façon dont vous souhaitez gérer vos intégrations.
   • Si vous créez un projet, sélectionnez "Projet vide" si vous y êtes invité (par rapport à Créer à partir d’un modèle).
   • Les programmes de la console Adobe I/O sont différents des concepts des programmes de Cloud Manager.
4. Créer une nouvelle intégration de l’API Cloud Manager avec le profil "Développeur - Cloud Service"
5. Obtenez les informations d’identification du compte de service (JWT) nécessaires pour renseigner l’interface de ligne de commande config.json de l’Adobe I/O.
6. Charger le fichier config.json dans l'interface de ligne de commande de l'Adobe I/O
   • $ aio config:set jwt-auth PATH_TO_CONFIG_JSON_FILE --file --json
7. Charger le fichier private.key dans l'interface de ligne de commande de l'Adobe I/O
   • $ aio config:set jwt-auth.jwt_private_key PATH_TO_PRIVATE_KEY_FILE --file

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

Configuration de l'IDE de développement

Le développement AEM consiste principalement en le développement Java et frontal (JavaScript, CSS, etc.) et la gestion XML. Voici les IDE les plus utilisés pour le développement AEM.

IDÉE IntelliJ

IntelliJ IDEAest un puissant IDE 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 gratuite est suffisante pour le développement AEM, mais l'Ultimate étend sa capacité .

• Télécharger IntelliJ IDEA
• Téléchargement de l'outil Repo

Code Microsoft Visual Studio

Visual Studio Code (VS Code) est un outil gratuit et open source pour les développeurs frontaux. Le code Visual Studio peut être configuré pour intégrer la synchronisation de contenu avec AEM à l'aide d'un outil d'Adobe, repo.

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

• Téléchargement du code Visual Studio
• Téléchargement de l'outil Repo
• Téléchargement de l'extension de code VS aemfed
• Télécharger AEM Sync VS Code extension

Eclipse

Eclipse IDEs est un IDE très utilisé pour le développement de Java. Il prend en charge le module externe AEM Developer Toolsfourni par Adobe, fournissant une interface utilisateur graphique intégrée pour la création et la synchronisation de contenu JCR avec une instance AEM locale.

• Télécharger Eclipse
• Téléchargement des outils de développement Eclipse