DokumentationAEMSjälvstudiekurser om AEMSjälvstudiekurser om AEM as a Cloud Service

Konfigurera lokal AEM SDK set-up-local-aem-sdk

Last update: Sun Jul 14 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Skapat för:

  • Nybörjare
  • Utvecklare

Adobe Experience Manager (AEM) kan köras lokalt med AEM as a Cloud Service SDK's Quickstart Jar. Detta gör att utvecklare kan distribuera till och testa anpassad kod, konfiguration och innehåll innan de implementerar det i källkontrollen och distribuerar det i en AEM as a Cloud Service-miljö.

Observera att ~ används som kortskrift för användarens katalog. I Windows motsvarar detta %HOMEPATH%.

Installera Java™

Experience Manager är en Java™-applikation och därför krävs Oraclet Java™ SDK för utvecklingsverktygen.

  1. [Hämta och installera den senaste Java™ SDK 11](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%2FDK jcr%3AlastModified&orderby.sort=desc&layout=list&p.offset=0&p.limit=14)
  2. Kontrollera att Oraclet Java™ 11 SDK är installerat genom att köra kommandot:
macOS
code language-shell 
$ java --version
Windows
code language-shell 
$ java -version
Linux®
code language-shell 
$ java --version

Java

Hämta AEM as a Cloud Service SDK

AEM as a Cloud Service SDK, eller AEM SDK, innehåller den QuickStart Jar som används för att köra AEM Author och Publish lokalt för utveckling, samt den kompatibla versionen av Dispatcher Tools.

  1. Logga in på https://experience.adobe.com/#/downloads med din Adobe ID
    • Observera att din Adobe-organisation måste etableras för att AEM as a Cloud Service ska kunna hämta AEM as a Cloud Service SDK.
  2. Gå till fliken AEM as a Cloud Service
  3. Sortera efter Publicerat den i Fallande ordning
  4. Klicka på den senaste AEM SDK-resultatraden
  5. Granska och godkänn slutanvändaravtalet och tryck på knappen Hämta

Extrahera Quickstart Jar från AEM SDK-zip

  1. Zippa upp den hämtade aem-sdk-XXX.zip-filen

Konfigurera lokal AEM Author Service set-up-local-aem-author-service

Den lokala AEM författartjänsten ger utvecklare en lokal upplevelse som digitala marknadsförare/innehållsförfattare delar för att skapa och hantera innehåll. AEM Author Service är utformad både som en redigerings- och förhandsvisningsmiljö, vilket gör att de flesta valideringar av funktionsutveckling kan utföras mot den, vilket gör den till en viktig del i den lokala utvecklingsprocessen.

  1. Skapa mappen ~/aem-sdk/author

  2. Kopiera Quickstart JAR-filen till ~/aem-sdk/author och byt namn på den till aem-author-p4502.jar

  3. Starta den lokala AEM Author Service genom att köra följande från kommandoraden:

    • java -jar aem-author-p4502.jar
      • Ange administratörslösenordet som admin. Alla administratörslösenord är tillåtna, men du bör använda standardvärdet för lokal utveckling för att minska behovet av att konfigurera om.

    Du kan inte starta AEM som Cloud Service Quickstart Jar genom att dubbelklicka på.

  4. Gå till den lokala AEM författartjänsten på http://localhost:4502 i en webbläsare

macOS
code language-shell 
$ mkdir -p ~/aem-sdk/author
$ cp aem-sdk-Quickstart-XXX.jar ~/aem-sdk/author/aem-author-p4502.jar
$ cd ~/aem-sdk/author
$ java -jar aem-author-p4502.jar
Windows
code language-shell 
$ mkdir -p c:\Users\<My User>\aem-sdk\author
$ copy aem-sdk-Quickstart-XXX.jar c:\Users\<My User>\aem-sdk\author\aem-author-p4502.jar
$ cd c:\Users\<My User>\aem-sdk\author
$ java -jar aem-author-p4502.jar
Linux®
code language-shell 
$ mkdir -p ~/aem-sdk/author
$ cp aem-sdk-Quickstart-XXX.jar ~/aem-sdk/author/aem-author-p4502.jar
$ cd ~/aem-sdk/author
$ java -jar aem-author-p4502.jar

Konfigurera lokal AEM Publish-tjänst

Den lokala AEM Publish-tjänsten förser utvecklarna med den lokala upplevelse som slutanvändarna av AEM har, till exempel genom att surfa på den AEM webbplatsen. En lokal AEM Publish-tjänst är viktig eftersom den integreras med AEM SDK:s Dispatcher-verktyg och gör att utvecklare kan röka och finjustera slutanvändarupplevelsen.

  1. Skapa mappen ~/aem-sdk/publish

  2. Kopiera Quickstart JAR-filen till ~/aem-sdk/publish och byt namn på den till aem-publish-p4503.jar

  3. Starta den lokala AEM Publish-tjänsten genom att köra följande från kommandoraden:

    • java -jar aem-publish-p4503.jar
      • Ange administratörslösenordet som admin. Alla administratörslösenord är tillåtna, men du bör använda standardvärdet för lokal utveckling för att minska behovet av att konfigurera om.

    Du kan inte starta AEM som Cloud Service Quickstart Jar genom att dubbelklicka på.

  4. Åtkomst till den lokala AEM Publish-tjänsten på http://localhost:4503 i en webbläsare

macOS
code language-shell 
$ mkdir -p ~/aem-sdk/publish
$ cp aem-sdk-Quickstart-XXX.jar ~/aem-sdk/publish/aem-publish-p4503.jar
$ cd ~/aem-sdk/publish
$ java -jar aem-publish-p4503.jar
Windows
code language-shell 
$ mkdir -p c:\Users\<My User>\aem-sdk\publish
$ copy aem-sdk-Quickstart-XXX.jar c:\Users\<My User>\aem-sdk\publish\aem-publish-p4503.jar
$ cd c:\Users\<My User>\aem-sdk\publish
$ java -jar aem-publish-p4503.jar
Linux®
code language-shell 
$ mkdir -p ~/aem-sdk/publish
$ cp aem-sdk-Quickstart-XXX.jar ~/aem-sdk/publish/aem-publish-p4503.jar
$ cd ~/aem-sdk/publish
$ java -jar aem-publish-p4503.jar

Konfigurera lokala AEM i förhandsversionsläge

Den lokala AEM-miljön kan startas i prerelease-läge, vilket gör att en utvecklare kan bygga mot funktionerna i AEM as a Cloud Service nästa version. Förhandsversionen aktiveras genom att argumentet -r prerelease skickas från den lokala AEM körningens första start. Detta kan användas med både den lokala AEM författaren och AEM Publish-tjänster.

macOS
code language-shell 
# For AEM Author service in prerelease mode
$ java -jar aem-author-p4502.jar -r prerelease

# For AEM Publish service in prerelease mode
$ java -jar aem-publish-p4503.jar -r prerelease
Windows
code language-shell 
# For AEM Author service in prerelease mode
$ java -jar aem-author-p4502.jar -r prerelease

# For AEM Publish service in prerelease mode
$ java -jar aem-publish-p4503.jar -r prerelease
Linux®
code language-shell 
# For AEM Author service in prerelease mode
$ java -jar aem-author-p4502.jar -r prerelease

# For AEM Publish service in prerelease mode
$ java -jar aem-publish-p4503.jar -r prerelease

Simulera innehållsdistribution content-distribution

I en riktig Cloud Service-miljö distribueras innehåll från författartjänsten till Publish-tjänsten med hjälp av Sling Content Distribution och Adobe Pipeline. Adobe Pipeline är en isolerad mikrotjänst som bara är tillgänglig i molnmiljön.

Under utvecklingen kan det vara önskvärt att simulera distributionen av materialet med hjälp av den lokala tjänsten Författare och Publish. Detta kan uppnås genom att aktivera de äldre replikeringsagenterna.

NOTE
Replikeringsagenter är bara tillgängliga för användning i den lokala Quickstart JAR och ger bara en simulering av innehållsdistribution.

  1. Logga in på tjänsten Författare och gå till http://localhost:4502/etc/replication/agents.author.html.

  2. Klicka på Standardagent (publicera) för att öppna standardsreplikeringsagenten.

  3. Klicka på Redigera för att öppna agentens konfiguration.

  4. Uppdatera följande fält på fliken Inställningar:

    • Aktiverad - kontrollera sant
    • Agentanvändar-ID - Lämna det här fältet tomt

    Konfiguration av replikeringsagent - Inställningar

  5. Uppdatera följande fält på fliken Transport:

    • URI - http://localhost:4503/bin/receive?sling:authRequestLogin=1
    • Användare - admin
    • Lösenord - admin

    Konfiguration av replikeringsagent - transport

  6. Klicka på OK om du vill spara konfigurationen och aktivera standard-replikeringsagenten.

  7. Nu kan du göra ändringar i innehåll på Författartjänsten och publicera dem på Publish-tjänsten.

Publish Page

Snabbstarta JAR-startlägen

Namnet på QuickStart Jar, aem-<tier>_<environment>-p<port number>.jar, anger hur det kommer att starta. När AEM har startats i ett visst skikt, författare eller publicering kan det inte ändras till det alternativa skiktet. Det gör du genom att ta bort mappen crx-Quickstart som skapades under den första körningen och köra Quickstart Jar igen. Miljö och portar kan ändras, men de kräver stopp/start för den lokala AEM.

Förändrade miljöer, dev, stage och prod, kan vara användbara för utvecklare för att säkerställa att miljöspecifika konfigurationer definieras och löses korrekt av AEM. Vi rekommenderar att lokal utveckling primärt utförs mot standardkörningsläget för miljön dev.

Tillgängliga permutationer är följande:

Quickstart JAR-filnamn
Lägesbeskrivning
aem-author-p4502.jar
Som författare i Dev-körningsläge på port 4502
aem-author_dev-p4502.jar
Som författare i Dev-körningsläge på port 4502 (samma som aem-author-p4502.jar)
aem-author_stage-p4502.jar
Som författare i mellanlagringsläge på port 4502
aem-author_prod-p4502.jar
Som författare i produktionskörningsläge på port 4502
aem-publish-p4503.jar
Som Publish i Dev-körningsläge på port 4503
aem-publish_dev-p4503.jar
Som Publish i Dev-körningsläge på port 4503 (samma som aem-publish-p4503.jar)
aem-publish_stage-p4503.jar
Som Publish i mellanlagringskörningsläge på port 4503
aem-publish_prod-p4503.jar
Som Publish i produktionskörningsläge på port 4503

Observera att portnumret kan vara vilken tillgänglig port som helst på den lokala utvecklingsdatorn, men enligt konvention:

  • Port 4502 används för den lokala AEM Author-tjänsten
  • Port 4503 används för den lokala AEM Publish-tjänsten

Om du ändrar dessa kan du behöva justera AEM SDK-konfigurationer

Stoppa en lokal AEM

Om du vill stoppa en lokal AEM, antingen AEM författare eller Publish, öppnar du kommandoradsfönstret som användes för att starta AEM körningsmiljö och trycker på Ctrl-C. Vänta på att AEM stängs av. Kommandoradsprompten är tillgänglig när avstängningsprocessen är slutförd.

Inställningsåtgärder för lokal AEM

När QuickStart Jar ska uppdateras

Uppdatera AEM SDK minst en gång i månaden, eller kort efter, den sista torsdagen i varje månad, vilket är versionsslutet för AEM as a Cloud Service"funktionsreleaser".

WARNING
Om du uppdaterar Quickstart Jar till en ny version måste du ersätta hela den lokala utvecklingsmiljön, vilket resulterar i att all kod, konfiguration och innehåll i de lokala AEM-databaserna går förlorad. Se till att kod, konfiguration eller innehåll som inte ska förstöras implementeras på ett säkert sätt i Git, eller exporteras från den lokala AEM instansen som AEM.

Så här undviker du innehållsförluster när du uppgraderar AEM SDK

Genom att uppgradera AEM SDK skapas en helt ny AEM, inklusive en ny databas, vilket innebär att ändringar som gjorts i en tidigare AEM SDK-databas går förlorade. Följande är användbara strategier för att hjälpa till med bestående innehåll mellan AEM SDK-uppgraderingar och kan användas diskret eller i kombination:

  1. Skapa ett innehållspaket som är avsett för att innehålla exempelinnehåll som ska vara till hjälp vid utvecklingen, och behåll det i Git. Allt innehåll som ska bevaras genom AEM SDK-uppgraderingar kommer att finnas kvar i det här paketet och återdistribueras efter uppgraderingen av AEM SDK.
  2. Använd ek-upgrade med direktivet includepaths om du vill kopiera innehåll från den tidigare AEM SDK-databasen till den nya AEM SDK-databasen.
  3. Säkerhetskopiera allt innehåll med AEM Package Manager och innehållspaket på den tidigare AEM SDK:n och installera om dem på den nya AEM SDK:n.

Kom ihåg att om du använder ovanstående metoder för att underhålla kod mellan AEM SDK-uppgraderingar, så visas ett mönster för utveckling. Kod som inte kan användas för engångsbruk ska ha sitt ursprung i din utvecklingsutvecklingsutvecklingsutvecklingsmiljö och flöda in i AEM SDK via distributioner.

Felsökning

Om du dubbelklickar på Quickstart JAR-filen uppstår ett fel troubleshooting-double-click

När du dubbelklickar på QuickStart Jar för att starta visas ett felmodalt fel som förhindrar att AEM startas lokalt.

Felsökning - Dubbelklicka på QuickStart JAR-filen

Detta beror på att AEM as a Cloud Service Quickstart Jar inte stöder dubbelklickning på QuickStart Jar för att starta AEM lokalt. Du måste i stället köra JAR-filen från kommandoraden.

Om du vill starta AEM författartjänsten cd till katalogen som innehåller snabbstartsverktyget och kör kommandot:

macOS
code language-shell 
$ java -jar aem-author-p4502.jar
Windows
code language-shell 
$ java -jar aem-author-p4502.jar
Linux®
code language-shell 
$ java -jar aem-author-p4502.jar

eller, för att starta AEM Publish-tjänsten, cd till katalogen som innehåller snabbstartsverktyget och köra kommandot:

macOS
code language-shell 
$ java -jar aem-publish-p4503.jar
Windows
code language-shell 
$ java -jar aem-publish-p4503.jar
Linux®
code language-shell 
$ java -jar aem-publish-p4503.jar

Starten av snabbstartsgaren från kommandoraden avbryts omedelbart troubleshooting-java-8

När du startar Quickstart Jar från kommandoraden avbryts processen omedelbart och AEM startar inte, med följande fel:

➜  ~/aem-sdk/author: java -jar aem-author-p4502.jar
Loading quickstart properties: default
Loading quickstart properties: instance
java.lang.Exception: Quickstart requires a Java Specification 11 VM, but your VM (Java HotSpot(TM) 64-Bit Server VM / Oracle Corporation) reports java.specification.version=1.8
  at com.adobe.granite.quickstart.base.impl.Main.checkEnvironment(Main.java:1046)
  at com.adobe.granite.quickstart.base.impl.Main.<init>(Main.java:646)
  at com.adobe.granite.quickstart.base.impl.Main.main(Main.java:981)
Quickstart: aborting

Detta beror på att AEM as a Cloud Service kräver Java™ SDK 11 och du kör en annan version, troligtvis Java™ 8. Du löser det här problemet genom att hämta och installera [Oracle Java™ SDK 11](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%2FDK jcr%3AlastModified&orderby.sort=desc&layout=list&p.offset=0&p.limit=14).

När Oraclet Java™ 11 SDK är installerat kontrollerar du att det är den aktiva versionen genom att köra kommandot från kommandoraden:

macOS
code language-shell 
$ java --version
Windows
code language-shell 
$ java -version
Linux®
code language-shell 
$ java --version

Ytterligare resurser

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