Einrichten von Entwicklungs-Tools

Für die Entwicklung von Adobe Experience Manager (AEM) ist ein minimaler Satz von Entwicklungs-Tools erforderlich, die auf dem Entwicklercomputer installiert und eingerichtet werden. Diese Instrumente unterstützen die Entwicklung und den Aufbau von AEM.

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

Java installieren

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

  1. [Herunterladen und Installieren des neuesten Java 11-SDK-Releases] (https://experience.adobe.com/#/downloads/content/software-distribution/en/general.html?1_group.propertyvalues.property=.%2Fjcr%3Acontent%2Fmetadata%2Fdc%3AsoftwareType&1_group.propertyvalues.operation=equals&1_group.propertyvalues.0_values=software-type%3Atooling&fulltext=Oracle%7E+JDK%7E+11%7E&orderby=%40jcr%3Acontent Fjcr%3AlastModified&orderby.sort=desc&layout=list&p.offset=0&p.limit=14)
  2. Stellen Sie sicher, dass das Java 11 SDK installiert ist, indem Sie den Befehl ausführen:
    • Windows: java -version
    • macOS/Linux: java --version

Java

Installation von Homebrew

Die Verwendung von Homebrew ist optional, wird jedoch empfohlen.

Homebrew ist ein Open-Source-Paketmanager 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 Managern erforderlich sind.

  1. Terminal öffnen
  2. Überprüfen Sie, ob Homebrew bereits installiert ist, indem Sie den Befehl ausführen: brew --version.
  3. Wenn Homebrew nicht installiert ist, installieren Sie Homebrew
  4. Stellen Sie sicher, dass Homebrew installiert ist, indem Sie den Befehl ausführen: brew --version

Homebrew

Wenn Sie Homebrew verwenden, befolgen Sie die Anweisungen Installieren mit Homebrew in den folgenden Abschnitten. Wenn Sie nicht mit Homebrew arbeiten, installieren Sie die Tools unter Verwendung der betriebssystemspezifischen Links.

Git installieren

🔗 Gibt das von Adobe Cloud Manager verwendete Quellcodeverwaltungssystem an und ist daher für die Entwicklung erforderlich.

  • Git mithilfe von Homebrew installieren
    1. Öffnen Sie Ihr Terminal/Ihre Eingabeaufforderung.
    2. Führen Sie den Befehl aus: brew install git
    3. Stellen Sie mithilfe des Befehls sicher, dass Git installiert ist: git --version
  • Oder laden Sie Git (macOS, Linux oder Windows) herunter und installieren Sie es.
    1. Herunterladen und Installieren von Git
    2. Öffnen Sie Ihr Terminal/Ihre Eingabeaufforderung.
    3. Stellen Sie mithilfe des Befehls sicher, dass Git installiert ist: git --version

Git

Installieren von Node.js (und npm)

Node. jsis ist eine JavaScript-Laufzeitumgebung, die zum Arbeiten mit den Frontend-Assets des ui. frontendsub-Projekts eines AEM Projekts verwendet wird. Node.js wird mit npm bereitgestellt. Dies ist der De-facto-Paketmanager von Node.js, der zur Verwaltung von JavaScript-Abhängigkeiten verwendet wird.

  • Installieren von Node.js mithilfe von Homebrew
    1. Öffnen Sie Ihr Terminal/Ihre Eingabeaufforderung.
    2. Führen Sie den Befehl aus: brew install node
    3. Stellen Sie mithilfe des Befehls sicher, dass Node.js installiert ist: node -v
    4. Stellen Sie mithilfe des Befehls sicher, dass npm installiert ist: npm -v
  • Oder laden Sie Node.js (macOS, Linux oder Windows) herunter und installieren Sie es.
    1. Node.js herunterladen und installieren
    2. Öffnen Sie Ihr Terminal/Ihre Eingabeaufforderung.
    3. Stellen Sie mithilfe des Befehls sicher, dass Node.js installiert ist: node -v
    4. Stellen Sie mithilfe des Befehls sicher, dass npm installiert ist: npm -v

Node.js und npm

TIPP

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, synchronisieren (oder nahe daran) zu lassen.

In diesem Beispiel AEM Project Reactor pom.xml finden Sie Informationen dazu, wo Sie die Build-Versionen Node.js und npm finden.

Maven installieren

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

  • Maven mithilfe von Homebrew installieren
    1. Öffnen Sie Ihr Terminal/Ihre Eingabeaufforderung.
    2. Führen Sie den Befehl aus: brew install maven
    3. Stellen Sie mithilfe des Befehls sicher, dass Maven installiert ist: mvn -v
  • Oder laden Sie Maven (macOS, Linux oder Windows) herunter und installieren Sie es.
    1. Maven herunterladen
    2. Maven installieren
    3. Öffnen Sie Ihr Terminal/Ihre Eingabeaufforderung.
    4. Stellen Sie mithilfe des Befehls sicher, dass Maven installiert ist: mvn -v

Maven

Einrichten der Adobe I/O-CLI

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

  • Trackinglogs von AEM as a Cloud Services services
  • Verwalten von Cloud Manager-Pipelines über die CLI

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 aio npm-Modul global zu installieren.

Einrichten des Adobe I/O CLI Cloud Manager-Plug-ins

Mit dem Adobe I/O Cloud Manager-Plug-in kann die aio-CLI über den Befehl aio cloudmanager mit Adobe Cloud Manager interagieren.

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

Einrichten des Adobe I/O CLI Asset compute-Plug-ins

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 Adobe I/O CLI-Authentifizierung

Damit die Adobe I/O-CLI mit Cloud Manager kommunizieren kann, muss eine Cloud Manager-Integration in der Adobe I/O Console erstellt werden und die Anmeldeinformationen müssen für die erfolgreiche Authentifizierung erhalten werden.

  1. Melden Sie sich bei console.adobe.io an.
  2. Stellen Sie sicher, dass Ihr Unternehmen, das das Cloud Manager-Produkt enthält, mit dem eine Verbindung hergestellt werden soll, im Adobe Org-Umschalter aktiv ist.
  3. Erstellen Sie ein neues oder öffnen Sie ein vorhandenes Adobe I/O-Programm
    • Adobe I/O Console-Programme sind einfach organisatorische Zusammenstellungen von Integrationen, erstellen oder verwenden Sie ein vorhandenes Programm, je nachdem, wie Sie Ihre Integrationen verwalten möchten.
    • Wenn Sie ein neues Projekt erstellen, wählen Sie bei entsprechender Aufforderung (vs. "Aus Vorlage erstellen")
    • Adobe I/O Console-Programme unterscheiden sich von Cloud Manager-Programmen
  4. Erstellen Sie eine neue Cloud Manager-API-Integration mit dem Profil "Entwickler - Cloud Service".
  5. Rufen Sie die Anmeldedaten für das Dienstkonto (JWT) ab, um die config.json der Adobe I/O CLI zu füllen.
  6. Laden Sie die Datei config.json in die Adobe I/O-CLI.
    • $ aio config:set ims.contexts.aio-cli-plugin-cloudmanager PATH_TO_CONFIG_JSON_FILE --file --json
  7. Laden Sie die Datei private.key in die Adobe I/O-CLI.
    • $ aio config:set ims.contexts.aio-cli-plugin-cloudmanager.private_key PATH_TO_PRIVATE_KEY_FILE --file

Starten Sie Ausführen von Befehlen für Cloud Manager über die Adobe I/O-CLI.

Einrichten der Entwicklungs-IDE

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

IntelliJ IDEA

IntelliJ IDEAist eine leistungsstarke IDE zur Java-Entwicklung. IntelliJ IDEA ist in zwei Geschmacksrichtungen erhältlich: eine kostenlose Community-Edition und eine kommerzielle (bezahlte) Ultimate-Version. Die kostenlose Community-Version reicht für AEM Entwicklung aus, aber das Ultimate erweitert seinen Funktionssatz.

Microsoft Visual Studio Code

Visual Studio Code (VS Code) ist ein kostenloses Open-Source-Tool für Frontend-Entwickler. Visual Studio Code kann mithilfe eines Adobe-Tools, repo, eingerichtet werden, um die Inhaltssynchronisierung mit AEM zu integrieren.

Visual Studio Code ist die ideale Wahl für Frontend-Entwickler, die in erster Linie Frontend-Code erstellen. JavaScript, CSS und HTML. Obwohl VS-Code Java-Unterstützung über Erweiterungen bietet, fehlen möglicherweise einige der erweiterten Funktionen, die von Java-spezifischeren bereitgestellt werden.

Eclipse

Eclipse IDEs ist eine beliebte IDEs für die Java-Entwicklung und unterstützt das AEM Developer Toolslug-in von Adobe, das ein In-IDE-GUI für das Authoring und die Synchronisierung von JCR-Inhalten mit einer lokalen AEM-Instanz bereitstellt.

Auf dieser Seite