Einrichten von Entwicklungs-Tools set-up-development-tools

Für Entwicklungsaufgaben in Adobe Experience Manager (AEM) müssen nur wenige Entwicklungs-Tools auf dem Computer des Entwicklers bzw. der Entwicklerin installiert und eingerichtet werden. Diese Tools die Entwicklung und den Aufbau von AEM.

Beachten Sie, dass ~ als Abkürzung für das Benutzerverzeichnis verwendet wird. Unter Windows entspricht dies %HOMEPATH%.

Installieren von Java

Experience Manager ist eine Java-Applikation und erfordert daher das Java-SDK, um die Entwicklung und das AEM as a Cloud Service-SDK zu unterstützen.

  1. Laden Sie die neueste Java SDK 11-Version herunter und installieren Sie sie
  2. Prüfen Sie, ob das Java 11 SDK installiert ist, indem Sie den folgenden Befehl ausführen:
macOS
code language-shell
$ java --version
Windows
code language-shell
$ java -version
Linux
code language-shell
$ java --version

Java

Installation von Homebrew

Die Verwendung von Homebrew ist optional, wird jedoch empfohlen.

Homebrew ist ein Open-Source-Package Manager für macOS, Windows und Linux. Alle unterstützenden Tools können separat installiert werden. Homebrew bietet eine praktische Möglichkeit, eine Vielzahl von Entwicklungs-Tools zu installieren und zu aktualisieren, die für die Entwicklung von Experience Manager erforderlich sind.

  1. Öffnen Sie Ihr Terminal
  2. Überprüfen Sie, ob Homebrew bereits installiert ist, indem Sie den folgenden Befehl ausführen: brew --version
  3. Wenn Homebrew nicht installiert ist, installieren Sie Homebrew
macOS

Homebrew auf macOS erfordert Xcode oder Command Line Tools, die über den folgenden Befehl installiert werden können:

code language-shell
$ xcode-select --install
Windows
Installieren von Homebrew unter Windows 10
Linux
Installieren von Homebrew unter Linux
  1. Stellen Sie sicher, dass Homebrew installiert ist, indem Sie den folgenden Befehl ausführen: brew --version

Homebrew

Wenn Sie Homebrew verwenden, folgen Sie den Anweisungen Installation mit Homebrew in den folgenden Abschnitten. Wenn Sie Homebrew nicht verwenden, installieren Sie die Tools über die betriebssystemspezifischen Links.

Installieren von Git

Git ist das Versionsverwaltungssystem, das von Adobe Cloud Manager verwendet wird, und ist daher für die Entwicklung erforderlich.

Installieren von Git mithilfe von Homebrew
  1. Öffnen Sie Ihr Terminal/Ihre Eingabeaufforderung

  2. Führen Sie den folgenden Befehl aus: $ brew install git

  3. Stellen Sie mithilfe des folgenden Befehls sicher, dass Git installiert ist: $ git --version

Herunterladen und Installieren von Git
  1. Git herunterladen und installieren

  2. Öffnen Sie Ihr Terminal/Ihre Eingabeaufforderung

  3. Stellen Sie mithilfe des folgenden Befehls sicher, dass Git installiert ist: $ git --version

Git

Installieren von Node.js (und npm) node-js

Node.js ist eine JavaScript-Laufzeitumgebung, die für die Arbeit mit den Frontend-Assets des Unterprojekts ui.frontend eines AEM-Projekts verwendet wird. Node.js wird mit npm verteilt, dem defacto Package Manager von Node.js, der verwendet wird, um JavaScript-Abhängigkeiten zu verwalten.

Installieren von Node.js mithilfe von Homebrew
  1. Öffnen Sie Ihr Terminal/Ihre Eingabeaufforderung

  2. Führen Sie den folgenden Befehl aus: $ brew install node

  3. Stellen Sie mithilfe des folgenden Befehls sicher, dass Node.js installiert ist: $ node -v

  4. Stellen Sie mithilfe des folgenden Befehls sicher, dass npm installiert ist: $ npm -v

Herunterladen und Installieren von Node.js
  1. Node.js herunterladen und installieren

  2. Öffnen Sie Ihr Terminal/Ihre Eingabeaufforderung

  3. Stellen Sie mithilfe des folgenden Befehls sicher, dass Node.js installiert ist: $ node -v

  4. Stellen Sie mithilfe des folgenden Befehls sicher, dass npm installiert ist: $ npm -v

Node.js und npm

TIP
AEM-Projektarchetyp-basierte AEM-Projekte installieren eine isolierte Version von Node.js zum Zeitpunkt der Erstellung. Es ist gut, die Version des lokalen Entwicklungssystems mit den Node.js- und npm-Versionen, die in der Reactor pom.xml Ihres AEM Maven-Projekts angegeben sind, zu synchronisieren (oder nahe daran zu halten).
Im folgenden Beispiel AEM Project Reactor pom.xml finden Sie weitere Informationen, wo die Node.js- und npm-Build-Versionen zu finden sind.

Installieren von Maven

Apache Maven ist das Open-Source-Java-Befehlszeilenwerkzeug, mit dem AEM-Projekte erstellt werden, die aus dem AEM-Projekt-Maven-Archetyp generiert wurden. Alle gängigen IDEs (IntelliJ IDEA, Visual Studio Code, Eclipse, usw.) haben integrierte Maven-Unterstützung.

Installieren von Maven mithilfe von Homebrew
  1. Öffnen Sie Ihr Terminal/Ihre Eingabeaufforderung

  2. Führen Sie den folgenden Befehl aus: $ brew install maven

  3. Stellen Sie mithilfe des folgenden Befehls sicher, dass Maven installiert ist: $ mvn -v

Herunterladen und Installieren von Maven
  1. Maven herunterladen

  2. Maven installieren

  3. Öffnen Sie Ihr Terminal/Ihre Eingabeaufforderung

  4. Stellen Sie mithilfe des folgenden Befehls sicher, dass Maven installiert ist: $ mvn -v

Maven

Einrichten der Adobe I/O-CLI aio-cli

Die Adobe I/O-CLI, oder aio, bietet Befehlszeilenzugriff auf eine Vielzahl von Adobe-Diensten, einschließlich Cloud Manager und Asset Compute. Die Adobe I/O-CLI spielt eine wesentliche Rolle bei der Entwicklung auf AEM as a Cloud Service, da sie Entwicklerinnen und Entwicklern Folgendes ermöglicht:

Installieren der Adobe I/O-CLI

  1. Stellen Sie sicher, dass Node.js installiert ist, da die Adobe I/O-CLI ein npm-Modul ist
    • Führen Sie node --version zur Bestätigung aus
  2. Führen Sie npm install -g @adobe/aio-cli aus, um das npm-Modul aio global zu installieren

Einrichten des Cloud Manager-Plug-ins der Adobe I/O-CLI aio-cloud-manager

Das Cloud Manager-Plug-in von Adobe I/O ermöglicht der AIO-CLI die Interaktion mit Adobe Cloud Manager über den Befehl aio cloudmanager.

  1. Führen Sie aio plugins:install @adobe/aio-cli-plugin-cloudmanager aus, um das AIO-Cloud Manager Plug-in zu installieren.

Einrichten der Adobe I/O CLI-Authentifizierung

Damit Adobe I/O-CLI mit Cloud Manager kommunizieren kann, muss eine Cloud Manager-Integration in der Adobe I/O Console erstellt werden, und es müssen Anmeldeinformationen zur erfolgreichen Authentifizierung eingeholt werden.

  1. Melden Sie sich bei console.adobe.io an

  2. Stellen Sie sicher, dass Ihre Organisation, die das Cloud Manager-Produkt umfasst, mit dem eine Verbindung hergestellt werden soll, im Umschalter für Adobe-Organisationen aktiv ist.

  3. Erstellen Sie ein neues Adobe I/O-Programm oder öffnen Sie ein bestehendes

    • Adobe I/O Console-Projekte sind einfach organisatorische Gruppierungen von Integrationen. Erstellen Sie ein Programm oder verwenden Sie ein vorhandenes Projekt, je nachdem, wie die Integrationen verwaltet werden sollen.
    • Wenn Sie ein neues Projekt erstellen, wählen Sie bei entsprechender Aufforderung „Leeres Projekt“ aus (vs. „Aus Vorlage erstellen“)
    • Adobe I/O Console-Programme unterscheiden sich von Cloud Manager-Programmen
  4. Erstellen Sie eine neue Cloud Manager-API-Integration.

    • Wählen Sie den veralteten Authentifizierungstyp „Service-Konto (JWT)“ aus (OAuth wird derzeit für die CLI nicht unterstützt).
    • Erstellen Sie Schlüssel oder laden Sie sie hoch.
    • Wählen Sie das Produktprofil „Entwickler – Cloud Service“ aus.
  5. Rufen Sie die Anmeldeinformationen für das Dienstkonto (JWT) ab, die zum Auffüllen der Datei config.json der Adobe I/O-CLI erforderlich sind.

    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. Laden Sie die config.json-Datei in die Adobe I/O-CLI

    • $ aio config:set ims.contexts.aio-cli-plugin-cloudmanager ./path/to/config.json --file --json
  7. Laden Sie die private.key-Datei in die Adobe I/O-CLI

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

Beginnen Sie mit der Ausführung von Befehlen für Cloud Manager über die Adobe I/O-CLI.

Einrichten des Plug-ins der schnellen Entwicklungsumgebung von AEM rde

Das Plug-in der schnellen Entwicklungsumgebung von AEM ermöglicht der AIO-CLI die Interaktion mit den schnellen Entwicklungsumgebungen von AEM as a Cloud Service über den Befehl aio aem:rde.

  1. Führen Sie aio plugins:install @adobe/aio-cli-plugin-aem-rde aus, um das AEM-Plug-in für schnelle Entwicklungsumgebungen zu installieren.

Einrichten des Asset Compute-Plug-ins für Adobe I/O-CLI aio-asset-compute

Mit dem Adobe I/O Cloud Manager-Plug-in kann die AIO-CLI Asset Compute-Sekundäre über den Befehl aio asset-compute generieren und ausführen.

  1. Führen Sie aio plugins:install @adobe/aio-cli-plugin-asset-compute aus, um das AIO-Asset Compute-Plug-in zu installieren.

Einrichten der Entwicklungs-IDE

Die AEM-Entwicklung besteht in erster Linie aus der Java- und Frontend-Entwicklung (JavaScript, CSS usw.) sowie der XML-Verwaltung. Im Folgenden finden Sie die beliebtesten IDEs für die AEM-Entwicklung.

IntelliJ IDEA

IntelliJ IDEA ist eine leistungsstarke IDE für die Java-Entwicklung. IntelliJ IDEA gibt es in zwei Varianten, einer kostenlosen Community-Edition und einer kommerziellen (kostenpflichtigen) Ultimate-Version. Die kostenlose Community-Version ist für die AEM-Entwicklung ausreichend, die Ultimate-Version erweitert jedoch den Funktionsumfang.

Microsoft Visual Studio Code

Visual Studio-Code (VS Code) ist ein kostenloses Open-Source-Tool für Frontend-Entwicklerinnen und -Entwickler. Visual Studio Code kann mit Hilfe eines Adobe-Tools repo für die Integration der Inhaltssynchronisierung mit AEM eingerichtet werden.

Visual Studio Code ist die ideale Wahl für Frontend-Entwicklerinnen und -Entwickler, die hauptsächlich Frontend-Code erstellen: JavaScript, CSS und HTML. VS Code bietet zwar Java-Unterstützung über Erweiterungen, doch fehlen ihm möglicherweise einige der fortgeschrittenen Funktionen, die von Java-spezifischen Programmen bereitgestellt werden.

Eclipse

Eclipse IDE ist eine beliebte IDE für die Java-Entwicklung und unterstützt das von Adobe bereitgestellte AEM Developer Tools-Plug-in, das eine IDE-GUI für das Authoring und die Synchronisierung von JCR-Inhalten mit einer lokalen AEM-Instanz bietet.

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