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.
- Laden Sie die neueste Java SDK 11-Version herunter und installieren Sie sie
- Prüfen Sie, ob das Java 11 SDK installiert ist, indem Sie den folgenden Befehl ausführen:
code language-shell |
---|
|
code language-shell |
---|
|
code language-shell |
---|
|
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.
- Öffnen Sie Ihr Terminal
- Überprüfen Sie, ob Homebrew bereits installiert ist, indem Sie den folgenden Befehl ausführen:
brew --version
- Wenn Homebrew nicht installiert ist, installieren Sie Homebrew
🔗Homebrew auf macOS erfordert Xcode oder Command Line Tools, die über den folgenden Befehl installiert werden können:
code language-shell |
---|
|
- Stellen Sie sicher, dass Homebrew installiert ist, indem Sie den folgenden Befehl ausführen:
brew --version
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.
-
Öffnen Sie Ihr Terminal/Ihre Eingabeaufforderung
-
Führen Sie den folgenden Befehl aus:
$ brew install git
-
Stellen Sie mithilfe des folgenden Befehls sicher, dass Git installiert ist:
$ git --version
-
Öffnen Sie Ihr Terminal/Ihre Eingabeaufforderung
-
Stellen Sie mithilfe des folgenden Befehls sicher, dass Git installiert ist:
$ git --version
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.
-
Öffnen Sie Ihr Terminal/Ihre Eingabeaufforderung
-
Führen Sie den folgenden Befehl aus:
$ brew install node
-
Stellen Sie mithilfe des folgenden Befehls sicher, dass Node.js installiert ist:
$ node -v
-
Stellen Sie mithilfe des folgenden Befehls sicher, dass npm installiert ist:
$ npm -v
-
Öffnen Sie Ihr Terminal/Ihre Eingabeaufforderung
-
Stellen Sie mithilfe des folgenden Befehls sicher, dass Node.js installiert ist:
$ node -v
-
Stellen Sie mithilfe des folgenden Befehls sicher, dass npm installiert ist:
$ npm -v
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.
-
Öffnen Sie Ihr Terminal/Ihre Eingabeaufforderung
-
Führen Sie den folgenden Befehl aus:
$ brew install maven
-
Stellen Sie mithilfe des folgenden Befehls sicher, dass Maven installiert ist:
$ mvn -v
-
Öffnen Sie Ihr Terminal/Ihre Eingabeaufforderung
-
Stellen Sie mithilfe des folgenden Befehls sicher, dass Maven installiert ist:
$ mvn -v
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:
- Protokollverfolgung von AEM as a Cloud Services
- Verwalten von Cloud Manager-Pipelines über die CLI
- Bereitstellen in Schnelle Entwicklungsumgebungen von AEM
Installieren der Adobe I/O-CLI
- 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
- Führen Sie
- Führen Sie
npm install -g @adobe/aio-cli
aus, um das npm-Modulaio
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
.
- 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.
-
Melden Sie sich bei console.adobe.io an
-
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.
-
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
-
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.
-
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" ] }
-
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
-
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
.
- 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.
- 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.