DokumentationAEMSjälvstudiekurser om AEMSjälvstudiekurser om AEM Sites WKND

Projektinställningar

Last update: Mon May 05 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Gäller:
  • Experience Manager 6.5
  • Experience Manager as a Cloud Service
  • Ämnen:
  • Projektarketyp för AEM

Skapat för:

  • Nybörjare
  • Utvecklare

I den här självstudiekursen beskrivs hur du skapar ett Maven Multi Module-modulprojekt för att hantera kod och konfigurationer för en Adobe Experience Manager-webbplats.

Förutsättningar

Granska de verktyg och instruktioner som krävs för att konfigurera en lokal utvecklingsmiljö. Se till att du har en ny instans av Adobe Experience Manager tillgänglig lokalt och att inga fler exempel-/demopaket har installerats (förutom obligatoriska Service Pack).

Syfte

  1. Lär dig hur du skapar ett nytt AEM-projekt med en Maven-arketype.
  2. Förstå de olika moduler som genereras av AEM Project Archetype och hur de fungerar tillsammans.
  3. Förstå hur AEM Core Components ingår i ett AEM-projekt.

Vad du ska bygga

video poster

https://video.tv.adobe.com/v/30152?quality=12&learn=on

I det här kapitlet genererar du ett nytt Adobe Experience Manager-projekt med AEM Project Archetype. Ditt AEM-projekt innehåller fullständig kod, fullständigt innehåll och konfigurationer som används för en Sites-implementering. Det projekt som genereras i detta kapitel utgör grunden för en implementering av WKND-webbplatsen och är byggt på i framtida kapitel.

Vad är ett Maven-projekt? - Apache Maven är ett programhanteringsverktyg för att skapa projekt. Alla Adobe Experience Manager-implementeringar använder Maven-projekt för att skapa, hantera och distribuera anpassad kod ovanpå AEM.

Vad är en Maven-arketype? - En Maven-arketyp är en mall eller ett mönster för generering av nya projekt. Med AEM Project-arkitekturen kan du skapa nya projekt med ett anpassat namnutrymme och inkludera en projektstruktur som följer vedertagna standarder, vilket avsevärt snabbar upp projektutvecklingen.

Skapa projektet

Det finns ett par sätt att skapa ett flermodulsprojekt i Maven för AEM. I den här självstudien används Maven AEM Project Archetype 35. Cloud Manager innehåller också en gränssnittsguide som startar skapandet av ett AEM-programprojekt. Det underliggande projektet som genereras av Cloud Manager UI ger samma struktur som att använda arkitypen direkt.

NOTE
I den här självstudien används version 35 av arketypen. Det är alltid en god vana att använda den senaste-versionen av arkitypen för att generera ett nytt projekt.

Nästa serie steg kommer att utföras med en UNIX®-baserad kommandoradsterminal, men de bör vara lika om en Windows-terminal används.

  1. Öppna en kommandoradsterminal. Kontrollera att Maven är installerad:

    $ mvn --version
Apache Maven 3.6.2
Maven home: /Library/apache-maven-3.6.2
Java version: 11.0.4, vendor: Oracle Corporation, runtime: /Library/Java/JavaVirtualMachines/jdk-11.0.4.jdk/Contents/Home

  2. Navigera till en katalog där du vill generera AEM-projektet. Detta kan vara vilken katalog som helst där du vill underhålla projektets källkod. En katalog med namnet code under användarens arbetskatalog:

    $ cd ~/code

  3. Klistra in följande i kommandoraden för att generera projektet i batchläge:

    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=39 \
    -D appTitle="WKND Sites Project" \
    -D appId="wknd" \
    -D groupId="com.adobe.aem.guides" \
    -D artifactId="aem-guides-wknd" \
    -D package="com.adobe.aem.guides.wknd" \
    -D version="0.0.1-SNAPSHOT" \
    -D aemVersion="cloud"
    NOTE
    Om du vill använda AEM 6.5.14+ ersätter du aemVersion="cloud" med aemVersion="6.5.14".
    Använd även alltid den senaste archetypeVersion genom att gå till AEM Project Archetype > Usage

    En fullständig lista över tillgängliga egenskaper för konfigurering av projektet finns här.

  4. Följande mapp- och filstruktur genereras av Maven-typen i det lokala filsystemet:

     ~/code/
    |--- aem-guides-wknd/
        |--- all/
        |--- core/
        |--- ui.apps/
        |--- ui.apps.structure/
        |--- ui.config/
        |--- ui.content/
        |--- ui.frontend/
        |--- ui.tests /
        |--- it.tests/
        |--- dispatcher/
        |--- pom.xml
        |--- README.md
        |--- .gitignore

Distribuera och skapa projektet

Skapa och distribuera projektkoden till en lokal instans av AEM.

  1. Kontrollera att du har en författarinstans av AEM som körs lokalt på port 4502.

  2. Gå till projektkatalogen aem-guides-wknd från kommandoraden.

    $ cd aem-guides-wknd

  3. Kör följande kommando för att skapa och distribuera hela projektet till AEM:

    $ mvn clean install -PautoInstallSinglePackage

    Byggnaden tar ca en minut och ska avslutas med följande meddelande:

    ...
[INFO] ------------------------------------------------------------------------
[INFO] Reactor Summary for WKND Sites Project 0.0.1-SNAPSHOT:
[INFO]
[INFO] WKND Sites Project ................................. SUCCESS [  0.113 s]
[INFO] WKND Sites Project - Core .......................... SUCCESS [  3.136 s]
[INFO] WKND Sites Project - UI Frontend ................... SUCCESS [  4.461 s]
[INFO] WKND Sites Project - Repository Structure Package .. SUCCESS [  0.359 s]
[INFO] WKND Sites Project - UI apps ....................... SUCCESS [  1.732 s]
[INFO] WKND Sites Project - UI content .................... SUCCESS [  0.956 s]
[INFO] WKND Sites Project - UI config ..................... SUCCESS [  0.064 s]
[INFO] WKND Sites Project - All ........................... SUCCESS [  8.229 s]
[INFO] WKND Sites Project - Integration Tests ............. SUCCESS [  3.329 s]
[INFO] WKND Sites Project - Dispatcher .................... SUCCESS [  0.027 s]
[INFO] WKND Sites Project - UI Tests ...................... SUCCESS [  0.032 s]
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  23.189 s
[INFO] Finished at: 2023-01-10T11:12:23-05:00
[INFO] ------------------------------------------------------------------------

    Maven-profilen autoInstallSinglePackage kompilerar de enskilda modulerna i projektet och distribuerar ett paket till AEM-instansen. Som standard distribueras det här paketet till en AEM-instans som körs lokalt på port 4502 och med autentiseringsuppgifterna admin:admin.

  4. Navigera till Package Manager på din lokala AEM-instans: http://localhost:4502/crx/packmgr/index.jsp. Du bör se paket för aem-guides-wknd.ui.apps, aem-guides-wknd.ui.config, aem-guides-wknd.ui.content och aem-guides-wknd.all.

  5. Gå till webbplatskonsolen: http://localhost:4502/sites.html/content. WKND-platsen är en av platserna. Den innehåller en webbplatsstruktur med hierarkin USA och Språkmallsidor. Den här platshierarkin baseras på värdena för language_country och isSingleCountryWebsite när projektet genereras med arkivtypen.

  6. Öppna sidan US > English genom att markera sidan och klicka på knappen Redigera i menyraden:

    platskonsol

  7. Startinnehåll har redan skapats och flera komponenter är tillgängliga för att läggas till på en sida. Experimentera med de här komponenterna för att få en uppfattning om funktionerna. Du får lära dig grunderna för en komponent i nästa kapitel.

    Startinnehåll för startsida

    Exempelinnehåll som har genererats av arkitekturen

Inspektera projektet

Det genererade AEM-projektet består av enskilda Maven-moduler, var och en med olika roller. Den här självstudiekursen och den mesta utvecklingsinriktningen på dessa moduler:

  • core - Java Code, främst serverutvecklare.

  • ui.front - Innehåller källkod för CSS, JavaScript, Sass och TypeScript, främst för frontutvecklare.

  • ui.apps - Innehåller komponent- och dialogdefinitioner, bäddar in kompilerad CSS och JavaScript som klientbibliotek.

  • ui.content - innehåller strukturellt innehåll och konfigurationer som redigerbara mallar, metadatamappningar (https://experienceleague.adobe.com/content,%20/conf?lang=sv).

  • all - Detta är en tom Maven-modul som kombinerar ovanstående moduler i ett paket som kan distribueras till en AEM-miljö.

Maven Project Diagram

Mer information om alla Maven-modulerna finns i AEM Project Archetype-dokumentationen.

Inkludering av kärnkomponenter

AEM Core Components är en uppsättning standardiserade WCM-komponenter (Web Content Management) för AEM. Dessa komponenter utgör en basuppsättning av en funktion och är formaterade, anpassade och utökade för enskilda projekt.

AEM as a Cloud Service-miljön innehåller den senaste versionen av AEM Core Components. Därför innehåller projekt som genererats för AEM as a Cloud Service inte en inbäddning av AEM Core Components.

För projekt som skapats med AEM 6.5/6.4 bäddas AEM Core Components automatiskt in i projektet. Det är en god vana för AEM 6.5/6.4 att bädda in AEM Core Components för att säkerställa att den senaste versionen driftsätts i ditt projekt. Mer information om hur kärnkomponenter ingår i projektet finns här.

Source Control Management

Det är alltid en bra idé att använda någon form av källkontroll för att hantera koden i programmet. I den här självstudien används git och GitHub. Det finns flera filer som genereras av Maven och/eller valfri IDE som ska ignoreras av SCM.

Maven skapar en målmapp när du skapar och installerar kodpaketet. Målmappen och innehållet ska uteslutas från SCM.

Under ui.apps-modulen observeras att många .content.xml filer har skapats. Dessa XML-filer mappar nodtyperna och egenskaperna för innehåll som är installerat i JCR-läsaren. Dessa filer är viktiga och kan inte ignoreras.

AEM-projektarkitypen genererar ett exempel på en .gitignore-fil som kan användas som startpunkt för vilken filer kan ignoreras. Filen genereras <src>/aem-guides-wknd/.gitignore.

Grattis!

Grattis! Du har skapat ditt första AEM-projekt!

Nästa steg

Förstå den underliggande tekniken i en Adobe Experience Manager (AEM) Sites Component genom ett enkelt HelloWorld-exempel med självstudiekursen Component Basics .

Avancerade Maven-kommandon (Bonus)

Under utvecklingen kanske du bara arbetar med en av modulerna och vill undvika att bygga upp hela projektet för att spara tid. Du kanske också vill distribuera direkt till en AEM Publish-instans eller kanske till en instans av AEM som inte körs på port 4502.

Nu ska vi granska några av de Maven-profiler och kommandon du kan använda för större flexibilitet under utvecklingen.

Kärnmodul

Modulen core innehåller all Java™-kod som är associerad med projektet. Bygget av modulen core distribuerar ett OSGi-paket till AEM. Så här skapar du bara denna modul:

  1. Navigera till mappen core (under aem-guides-wknd):

    $ cd core/

  2. Kör följande kommando:

    $ mvn clean install -PautoInstallBundle
...
[INFO] --- sling-maven-plugin:2.4.0:install (install-bundle) @ aem-guides-wknd.core ---
[INFO] Installing Bundle aem-guides-wknd.core(~/code/aem-guides-wknd/core/target/aem-guides-wknd.core-0.0.1-SNAPSHOT.jar) to http://localhost:4502/system/console via WebConsole
[INFO] Bundle installed
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  8.558 s

  3. Gå till http://localhost:4502/system/console/bundles. Det här är OSGi-webbkonsolen och innehåller information om alla paket som är installerade på AEM-instansen.

  4. Växla sorteringskolumnen Id så ser du WKND-paketet som är installerat och aktivt.

    Kärnpaket

  5. Du kan se var behållaren finns i CRXDE-Lite:

    CRXDE-plats för JAR

Ui.apps och Ui.content-moduler

Modul ui.apps innehåller all återgivningskod som behövs för webbplatsen under /apps. Detta inkluderar CSS/JS som lagras i ett AEM-format med namnet clientlibs. Detta inkluderar även HTML-skript för återgivning av dynamiska HTML. Du kan tänka dig modulen ui.apps som en karta till strukturen i JCR, men i ett format som kan lagras i ett filsystem och implementeras för källkontroll. Modulen ui.apps innehåller bara kod.

Så här skapar du bara denna modul:

  1. Från kommandoraden. Navigera till mappen ui.apps (under aem-guides-wknd):

    $ cd ../ui.apps

  2. Kör följande kommando:

    $ mvn clean install -PautoInstallPackage
...
Package installed in 70ms.
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  2.987 s
[INFO] Finished at: 2023-01-10T11:35:28-05:00
[INFO] ------------------------------------------------------------------------

  3. Gå till http://localhost:4502/crx/packmgr/index.jsp. Du bör se paketet ui.apps som det första installerade paketet och det bör ha en senare tidsstämpel än något av de andra paketen.

    Ui.apps-paketet är installerat

  4. Återgå till kommandoraden och kör följande kommando (i mappen ui.apps):

    $ mvn -PautoInstallPackagePublish clean install
...
[INFO] --- content-package-maven-plugin:1.0.2:install (install-package-publish) @ aem-guides-wknd.ui.apps ---
[INFO] Installing aem-guides-wknd.ui.apps (/Users/sachinmali/Desktop/code/wknd-tutorial/aem-guides-wknd/ui.apps/target/aem-guides-wknd.ui.apps-0.0.1-SNAPSHOT.zip) to http://localhost:4503/crx/packmgr/service.jsp
[INFO] I/O exception (java.net.ConnectException) caught when processing request: Connection refused (Connection refused)
[INFO] Retrying request
[INFO] I/O exception (java.net.ConnectException) caught when processing request: Connection refused (Connection refused)
[INFO] Retrying request
[INFO] I/O exception (java.net.ConnectException) caught when processing request: Connection refused (Connection refused)
[INFO] Retrying request
[INFO] ------------------------------------------------------------------------
[INFO] BUILD FAILURE
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  2.812 s
[INFO] Finished at: 2023-01-10T11:37:28-05:00
[INFO] ------------------------------------------------------------------------
[ERROR] Failed to execute goal com.day.jcr.vault:content-package-maven-plugin:1.0.2:install (install-package-publish) on project aem-guides-wknd.ui.apps: Connection refused (Connection refused) -> [Help 1]

    Profilen autoInstallPackagePublish är avsedd att distribuera paketet till en publiceringsmiljö som körs på porten 4503. Ovanstående fel förväntas om det inte går att hitta en AEM-instans som körs på http://localhost:4503.

  5. Kör slutligen följande kommando för att distribuera paketet ui.apps på port 4504:

    $ mvn -PautoInstallPackage clean install -Daem.port=4504
...
[INFO] --- content-package-maven-plugin:1.0.2:install (install-package) @ aem-guides-wknd.ui.apps ---
[INFO] Installing aem-guides-wknd.ui.apps (/Users/dgordon/code/aem-guides-wknd/ui.apps/target/aem-guides-wknd.ui.apps-0.0.1-SNAPSHOT.zip) to http://localhost:4504/crx/packmgr/service.jsp
[INFO] I/O exception (java.net.ConnectException) caught when processing request: Connection refused (Connection refused)
[INFO] Retrying request
[INFO] I/O exception (java.net.ConnectException) caught when processing request: Connection refused (Connection refused)
[INFO] Retrying request
[INFO] I/O exception (java.net.ConnectException) caught when processing request: Connection refused (Connection refused)
[INFO] Retrying request
[INFO] ------------------------------------------------------------------------
[INFO] BUILD FAILURE
[INFO] --------------------------------------------------------------------

    Ett byggfel förväntas inträffa igen om det inte finns någon AEM-instans som körs på port 4504 tillgänglig. Parametern aem.port definieras i POM-filen på aem-guides-wknd/pom.xml.

Modulen ui.content är strukturerad på samma sätt som modulen ui.apps . Den enda skillnaden är att modulen ui.content innehåller det som kallas mutable -innehåll. Innehåll som kan ändras refererar i princip till icke-kodkonfigurationer som mallar, principer eller mappstrukturer som lagras i källkontrollen , men kan ändras direkt på en AEM-instans. Detta beskrivs mer ingående i kapitlet om sidor och mallar.

Samma Maven-kommandon som används för att skapa modulen ui.apps kan användas för att skapa modulen ui.content . Upprepa stegen ovan inifrån mappen ui.content.

Felsökning

Om det uppstår problem när du genererar projektet med AEM Project Archetype läser du listan med kända problem och en lista över öppna problem.

Grattis igen!

Grattis, för att du gått igenom bonusmaterialet.

Nästa steg

Förstå den underliggande tekniken i en Adobe Experience Manager (AEM) Sites Component genom ett enkelt HelloWorld-exempel med självstudiekursen Component Basics .

recommendation-more-help
b2a561c1-47c0-4182-b8c1-757a197484f9