Configuration des outils de développement

Le développement d’Adobe Experience Manager (AEM) nécessite l’installation et la configuration d’un ensemble minimal d’outils de développement sur l’ordinateur 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, 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échargez et installez 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

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.
  4. Vérifiez que Homebrew est installé en exécutant la commande : brew --version

Homebrew

Si vous utilisez Homebrew, suivez les instructions de la section 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. Il est donc nécessaire pour le développement.

  • Installation de 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é à l’aide de la commande : git --version
  • Ou, téléchargez et installez Git (macOS, Linux ou Windows).
    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. jsis : environnement d’exécution JavaScript utilisé pour fonctionner avec les ressources front-end du sous-projet ui. d’un projet AEM. Node.js est distribué avec npm, est le gestionnaire de modules Node.js par défaut, utilisé pour gérer les dépendances JavaScript.

  • Installation de 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
  • Ou, téléchargez et installez Node.js (macOS, Linux ou Windows).
    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 Projets AEM basés sur’archétype de projet 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 AEM Project Reactor pom.xml pour savoir où trouver les versions de build Node.js et npm.

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.

  • Installation de 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
  • Ou, téléchargez et installez Maven (macOS, Linux ou Windows).
    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 ligne de commande d’Adobe I/O ou aio permet d’accéder à divers services d’Adobe, y compris 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 en tant que Cloud Service, car elle permet aux développeurs de :

  • Suivi des journaux à partir d’AEM as a Cloud Services services
  • Gestion des pipelines de Cloud Manager à partir de l’interface de ligne de commande

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 d’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

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’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 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’AEM de générer et d’exécuter des objets Worker 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 de l’interface de ligne de commande Adobe I/O

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

  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 Adobe
  3. Créez ou ouvrez un programme d’Adobe I/O existant.
    • 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é (ou "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 renseigner la 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 de l’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 de l’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.

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 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 AEM développement, mais la version Ultimate développe son ensemble de fonctionnalités.

Code Microsoft Visual Studio

Visual Studio Code (VS Code) est un outil gratuit et open source pour les développeurs front-end. Le code Visual Studio 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 de Java via les 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 Java. Il prend en charge le plug-in AEM Developer Toolsd fourni par Adobe, fournissant une interface utilisateur graphique intégrée (GUI) pour la création et la synchronisation de contenu JCR avec une instance AEM locale.

Sur cette page