AEM-Projektarchetyp

Der AEM-Projektarchetyp ist eine Maven-Vorlage, anhand derer ein minimales, auf Best Practices basierendes Adobe Experience Manager (AEM)-Projekt als Ausgangspunkt für Ihre Website erstellt wird.

Ressourcen

• Dokumentation zum Archetyp (dieses Dokument): Überblick über die Architektur des Archetyps und die verschiedenen Module.
  • Verwenden des Archetyps: Weitere Informationen zur Verwendung des Archetyps und der verfügbaren Module
  • ui.frontend: Verwendung des Frontend-Build-Moduls
• Die folgenden Tutorials basieren auf diesem Archetyp:
  • WKND-Site: Erfahren Sie, wie eine neue Website beginnen.
  • WKND Single Page App: Erfahren Sie, wie Sie eine Web-App für React oder Angular erstellen, die vollständig in AEM erstellt werden kann.

Funktionen

• Best Practice: Laden Sie Ihre Website mit den neuesten empfohlenen Verfahren von Adobe.
• Wenig Code: Bearbeiten Sie Ihre Vorlagen, erstellen Sie Inhalte, stellen Sie Ihre CSS bereit und Ihre Website kann live geschaltet werden.
• Cloud-fähig: Falls gewünscht, verwenden Sie AEM as a Cloud Service, um in wenigen Tagen live zu gehen und Skalierbarkeit und Wartung zu erleichtern.
• Dispatcher: Ein Projekt ist nur mit einer Dispatcher-Konfiguration, die Geschwindigkeit und Sicherheit gewährleistet, abgeschlossen.
• Mehrere Websites: Bei Bedarf generiert der Archetyp die Inhaltsstruktur für eine Konfigurationen mit mehreren Sprachen und Regionen.
• Kernkomponenten: Autoren können mit unserem vielseitigen Satz standardisierter Komponenten nahezu jedes Layout erstellen.
• Bearbeitbare Vorlagen: Stellen Sie praktisch jede Vorlage ohne Code zusammen und legen Sie fest, was die Autoren bearbeiten dürfen.
• Responsives Layout: Definieren Sie auf Vorlagen oder einzelnen Seiten, wie die Elemente die definierten Breakpoints umfließen.
• Kopf- und Fußzeile: Stellen Sie sie mithilfe der Lokalisierungsfunktionen der Komponenten ohne Code zusammen und lokalisieren Sie sie.
• Stilsystem: Vermeiden Sie das Erstellen benutzerdefinierter Komponenten, indem Autoren verschiedene Stile anwenden können.
• Frontend-Build: Mit Webpack, TypeScript und SASS können Frontend-Entwickler AEM-Seiten modellieren und Client-Bibliotheken erstellen.
• Web-App-fähig: Verwenden Sie für Websites, die React oder Angular verwenden, das SPA-SDK, um die kontextbezogene Inhaltserstellung der App beizubehalten.
• Commerce aktiviert: Für Projekte, die AEM Commerce mithilfe der Commerce-Kernkomponenten mit Commerce-Lösungen wie Magento integrieren möchten.
• Beispiel-Code: Sehen Sie sich die Komponente „HelloWorld“ und die Beispielmodelle, -Servlets, -filter und -planungen an.
• Open Source: Wenn etwas nicht so ist, wie es sein sollte, bringen Sie Ihre Verbesserungen ein!

Nutzung

Passen Sie die folgende Befehlszeile an Ihre Anforderungen an, um ein Projekt zu erstellen:

mvn -B org.apache.maven.plugins:maven-archetype-plugin:3.2.1:generate \
 -D archetypeGroupId=com.adobe.aem \
 -D archetypeArtifactId=aem-project-archetype \
 -D archetypeVersion=XX \
 -D appTitle="My Site" \
 -D appId="mysite" \
 -D groupId="com.mysite" \

• Ersetzen Sie XX durch die neueste Archetyp-Versionsnummer.
• Legen Sie aemVersion=cloud für AEM as a Cloud Service fest.
  Legen Sie aemVersion=6.5.0 für Adobe Managed Services oder On-Premise fest.
  Die Abhängigkeit der Kernkomponenten wird nur für AEM-Versionen ohne Cloud Service hinzugefügt, da die Kernkomponenten für AEM as a Cloud Service standardmäßig bereitgestellt werden.
• Passen Sie appTitle="My Site" an, um den Titel der Website und die Komponentengruppen festzulegen.
• Passen Sie appId="mysite" an, um die Maven-Artefakt-ID (artifactId), die Namen der Komponenten-, Konfigurations- und Inhaltsordner sowie die Namen der Client-Bibliotheken festzulegen.
• Passen Sie groupId="com.mysite" an, um die Maven-Gruppen-ID (groupId) und das Java-Quellpaket festzulegen.
• Durchsuchen Sie die Liste der verfügbaren Eigenschaften, um festzustellen, ob Sie weitere anpassen möchten.

Verfügbare Eigenschaften

Systemanforderungen

Richten Sie Ihre lokale Entwicklungsumgebung für das AEM as a Cloud Service-SDK oder ältere Versionen von AEM ein.

Bekannte Probleme

Bei Ausführung unter Windows und Generierung der Dispatcher-Konfiguration sollte die Ausführung in einer Eingabeaufforderung mit erhöhten Rechten oder im Windows-Subsystem für Linux erfolgen (siehe Nr. 329).

Wenn Sie den Archetyp im interaktiven Modus (ohne den Parameter -B) ausführen, können die Eigenschaften mit Standardwerten nicht geändert werden, es sei denn, die endgültige Bestätigung wird verworfen, wodurch die Fragen wiederholt und die Eigenschaften mit Standardwerten in die Fragen aufgenommen werden (Details siehe
ARCHETYPE-308).

Sie können diesen Archetyp nicht in Eclipse verwenden, wenn Sie ein neues Projekt mit File -> New -> Maven Project starten, da das Post-Generation-Skript archetype-post-generate.groovy aufgrund eines Problems mit Eclipse nicht ausgeführt wird. Die Lösung besteht darin, die oben genannte Befehlszeile zu verwenden und dann in Eclipse File -> Import -> Existing Maven Project zu verwenden.

Weiterführende Literatur

Weitere Informationen zur Verwendung des Archetyps, einschließlich der Vorteile, Optionen und der Funktionsweise der Module, finden Sie im Dokument Verwenden des Archetyps.

Ressourcen für Business.Adobe.com