Documentatie AEM Tutorials voor AEM Tutorials voor AEM as a Cloud Service

Lokale AEM SDK instellen set-up-local-aem-sdk

Last update: Mon May 05 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Van toepassing op:
Experience Manager as a Cloud Service

Onderwerpen:
Ontwikkelaarstools

Gemaakt voor:

Beginner
Ontwikkelaar

Adobe Experience Manager (AEM) kan lokaal worden uitgevoerd met de AEM as a Cloud Service SDK QuickStart Jar. Dit staat ontwikkelaars toe om op te stellen aan, en douanecode, configuratie, en inhoud te testen alvorens het aan broncontrole te bevestigen, en het op te stellen aan een milieu van AEM as a Cloud Service.

~ wordt gebruikt als steno voor de gebruikerslijst. In Windows is dit het equivalent van %HOMEPATH% .

Java™ installeren

Experience Manager is een Java™-toepassing en vereist daarom dat de Oracle Java™ SDK de ontwikkelingstool ondersteunt.

[ Download en installeer recentste 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%2fx jcr%3AlastModified&orderby.sort=desc&layout=list&p.offset=0&p.limit=14)
Controleer of Oracle Java™ 11 SDK is geïnstalleerd met de opdracht:

macOS

code language-shell
`$ java --version`

Vensters

code language-shell
`$ java -version`

Linux®

code language-shell
`$ java --version`

Java

Download de AEM as a Cloud Service SDK

De AEM as a Cloud Service SDK, of AEM SDK, bevat de Quickstart Jar die wordt gebruikt om AEM Author en Publish plaatselijk voor ontwikkeling, evenals de compatibele versie van de Hulpmiddelen van Dispatcher in werking te stellen.

Login aan https://experience.adobe.com/#/downloads/content/software-distribution/en/aemcloud.htmlmet uw Adobe ID
- Merk op dat uw organisatie van Adobe ____ provisioned voor AEM as a Cloud Service moet zijn om AEM as a Cloud Service SDK te downloaden.
Navigeer aan het AEM as a Cloud Service lusje
Soort door Gepubliceerde Datum in Aflopende orde
Klik op de recentste resultaatrij van AEM SDK van 0} {
Herzie en keur EULA goed, en tik de Download knoop

Quickstart Jar extraheren uit het zip van AEM SDK

Het gedownloade aem-sdk-XXX.zip bestand uitpakken

Lokale AEM Author-service instellen set-up-local-aem-author-service

De lokale AEM Author Service biedt ontwikkelaars een lokale ervaring met auteurs van digitale markten/content die ze delen om inhoud te maken en te beheren. De AEM Author Service is ontworpen als zowel een ontwikkelings- als een voorvertoningsomgeving, zodat de meeste validaties van de ontwikkeling van functies kunnen worden uitgevoerd, waardoor deze service een essentieel onderdeel van het lokale ontwikkelingsproces wordt.

De map maken ~/aem-sdk/author
Kopieer het QuickStart JAR dossier aan ~/aem-sdk/author en noem het aan aem-author-p4502.jar anders
Start de lokale AEM Auteur Service door het volgende uit te voeren vanaf de opdrachtregel:
- java -jar aem-author-p4502.jar
  - Geef het beheerderswachtwoord op als admin . Om het even welk admin wachtwoord is aanvaardbaar, nochtans adviseert het om het gebrek voor lokale ontwikkeling te gebruiken om de behoefte te verminderen om te vormen.
U kunt niet AEM beginnen als Cloud Service QuickStart Jar doortweemaal te klikken.
Heb toegang tot de lokale Dienst van de Auteur van AEM in http://localhost:4502in browser van het Web

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`

Vensters

code language-shell

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`

$ 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`

Lokale publicatieservice voor AEM instellen

De lokale AEM-publicatieservice biedt ontwikkelaars de lokale ervaring die eindgebruikers van de AEM zullen hebben, zoals bladeren door de website die op AEM wordt gehost. Een lokale AEM publiceert Dienst is belangrijk aangezien het met AEM SDK hulpmiddelen van Dispatcherintegreert en ontwikkelaars toestaat om de definitieve eindgebruiker te roken-test en te verfijnen die ervaring onder ogen ziet.

De map maken ~/aem-sdk/publish
Kopieer het QuickStart JAR dossier aan ~/aem-sdk/publish en noem het aan aem-publish-p4503.jar anders
Start de lokale AEM-publicatieservice door het volgende vanaf de opdrachtregel uit te voeren:
- java -jar aem-publish-p4503.jar
  - Geef het beheerderswachtwoord op als admin . Om het even welk admin wachtwoord is aanvaardbaar, nochtans adviseert het om het gebrek voor lokale ontwikkeling te gebruiken om de behoefte te verminderen om te vormen.
U kunt niet AEM beginnen als Cloud Service QuickStart Jar doortweemaal te klikken.
Heb toegang tot lokale AEM publiceer Dienst in http://localhost:4503in browser van het Web

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`

Vensters

code language-shell

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`

$ 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`

Lokale AEM-services instellen in de pre-releasemodus

De lokale runtime van AEM kan op pre-releasemodusworden begonnen toestaand een ontwikkelaar om tegen de volgende eigenschappen van de volgende versie van AEM as a Cloud Service te bouwen. Prerelease wordt ingeschakeld door het argument -r prerelease door te geven bij het eerste starten van de lokale AEM-runtime. Deze kan zowel met de lokale AEM Author als met de publicatieservices van AEM worden gebruikt.

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`

Vensters

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`

Inhoudsdistributie simuleren content-distribution

In ware Cloud Service wordt de milieu-inhoud van de Auteur aan de Publish Dienst verdeeld gebruikend het Verdelen van de Inhouden de Pijpleiding van Adobe. de Pijpleiding van Adobeis een geïsoleerde microdienst beschikbaar slechts in het wolkenmilieu.

Tijdens de ontwikkeling, kan het wenselijk zijn om de distributie van inhoud te simuleren gebruikend de lokale auteur en de Publish dienst. Dit kan worden bereikt door de agenten van de erfenisReplicatie toe te laten.

NOTE

De agenten van de replicatie zijn slechts beschikbaar aan gebruik in lokale QuickStart JAR en verstrekken slechts een simulatie van inhoudsdistributie.

Login aan de dienst van de Auteur en navigeer aan http://localhost:4502/etc/replication/agents.author.html.
Klik StandaardAgent (publiceren) om de agent van de standaardReplicatie te openen.
Klik uitgeven om de configuratie van de agent te openen.
Onder het lusje van Montages, werk de volgende gebieden bij:
- Toegelaten - controle waar
- Gebruiker - identiteitskaart van de Agent - verlaat dit gebied leeg
Onder het Vervoer lusje, werk de volgende gebieden bij:
- URI - http://localhost:4503/bin/receive?sling:authRequestLogin=1
- Gebruiker - admin
- Wachtwoord - admin
Klik O.K. om de configuratie te bewaren en de Standaard Agent van de Replicatie toe te laten.
U kunt nu wijzigingen aanbrengen in de inhoud van de service Auteur en deze publiceren naar de service Publiceren.

publiceer Pagina

Snelstartmodi voor Jar

De naam van de QuickStart-jar aem-<tier>_<environment>-p<port number>.jar geeft aan hoe deze wordt gestart. Als AEM eenmaal is gestart in een specifieke laag, auteur of publicatie, kan deze niet worden gewijzigd in de alternatieve laag. Hiervoor moet de map crx-Quickstart die tijdens de eerste uitvoering wordt gegenereerd, worden verwijderd en moet QuickStart Jar opnieuw worden uitgevoerd. Het milieu en de Havens kunnen worden veranderd, nochtans vereisen zij einde/begin van de lokale instantie van AEM.

Het wijzigen van omgevingen ( dev , stage en prod ) kan handig zijn voor ontwikkelaars om ervoor te zorgen dat omgevingspecifieke configuraties correct worden gedefinieerd en opgelost door AEM. Aanbevolen wordt om lokale ontwikkeling voornamelijk uit te voeren in de standaarduitvoermodus van de dev -omgeving.

De beschikbare permutaties zijn als volgt:

Quickstart Jar-bestandsnaam

Beschrijving van modus

aem-author-p4502.jar

Als Auteur in Dev loopwijze op haven 4502

aem-author_dev-p4502.jar

Als auteur in Dev loopwijze op haven 4502 (het zelfde als aem-author-p4502.jar)

aem-author_stage-p4502.jar

Als Auteur in Staging run mode op poort 4502

aem-author_prod-p4502.jar

Als Auteur in de run mode van de Productie op haven 4502

aem-publish-p4503.jar

Als Publiceren in Dev loopwijze op haven 4503

aem-publish_dev-p4503.jar

Zoals publiceren in de uitvoermodus Dev op poort 4503 (zelfde als aem-publish-p4503.jar)

aem-publish_stage-p4503.jar

Als Publiceren in Staging-uitvoeringsmodus op poort 4503

aem-publish_prod-p4503.jar

Als Publish op de loopwijze van de Productie op haven 4503

Merk op dat het havenaantal om het even welke beschikbare haven op de lokale ontwikkelingsmachine kan zijn, echter door overeenkomst:

De haven 4502 wordt gebruikt voor de lokale dienst van de Auteur van AEM
De haven 4503 wordt gebruikt voor de lokale AEM publiceer dienst

Als u deze instellingen wijzigt, moet u mogelijk aanpassingen aanbrengen in AEM SDK-configuraties

Een lokale AEM-runtime stoppen

Als u een lokale AEM-runtime wilt stoppen (AEM Author of Publish service), opent u het opdrachtregelvenster waarmee de AEM Runtime is gestart en tikt u op Ctrl-C . Wacht tot AEM is afgesloten. Wanneer het sluitingsproces volledig is, is de herinnering van de bevellijn beschikbaar.

Optionele lokale instellingstaken voor AEM-runtime

OSGi de variabelen van het configuratiemilieu en geheim variabelen zijn speciaal plaats voor lokale runtime van AEM, eerder dan het beheren van hen die air CLI gebruiken.

Wanneer werkt u de QuickStart-jar bij

Werk de AEM SDK ten minste maandelijks bij op of kort na de laatste donderdag van elke maand. Dit is de releasekaart voor de "feature releases" van AEM as a Cloud Service.

WARNING

Als u de QuickStart-jar wilt bijwerken naar een nieuwe versie, moet u de volledige lokale ontwikkelomgeving vervangen. Dit leidt tot verlies van alle code, configuratie en inhoud in de lokale AEM-opslagruimten. Zorg ervoor dat code, config of inhoud die niet zou moeten worden vernietigd veilig aan Git wordt begaan, of uit de lokale instantie van AEM als Pakketten van AEM wordt uitgevoerd.

Inhoud verliezen bij upgrades van de AEM SDK voorkomen

Door de AEM SDK te upgraden wordt in feite een geheel nieuwe AEM-runtime gemaakt, waaronder een nieuwe opslagplaats. Dit betekent dat eventuele wijzigingen die zijn aangebracht in een eerdere AEM SDK-opslagplaats verloren gaan. Hieronder vindt u levensvatbare strategieën voor het ondersteunen van blijvende inhoud tussen AEM SDK-upgrades, die u op discrete wijze of in overleg kunt gebruiken:

Maak een inhoudspakket dat gewijd is aan het bevatten van 'sample'-inhoud voor hulp bij ontwikkeling en onderhoud dit in Git. Alle inhoud die door AEM SDK-upgrades moet worden gecontinueerd, blijft in dit pakket aanwezig en wordt opnieuw geïmplementeerd nadat de AEM SDK is bijgewerkt.
Gebruik eiken-verbeteringmet de includepaths richtlijn, om inhoud van de vroegere bewaarplaats van AEM SDK aan de nieuwe bewaarplaats van AEM SDK te kopiëren.
Maak een back-up van alle inhoud met AEM Package Manager en inhoudspakketten op de eerdere AEM SDK en installeer deze opnieuw op de nieuwe AEM SDK.

Houd er rekening mee dat met de bovenstaande methoden code wordt onderhouden tussen AEM SDK-upgrades en dat dit een anti-patroonontwikkelingstitel aangeeft. Niet-wegwerpcode moet afkomstig zijn uit uw ontwikkelings-IDE en via implementaties overstappen op AEM SDK.

Problemen oplossen

Als u dubbelklikt op het QuickStart Jar-bestand, treedt er een fout op troubleshooting-double-click

Wanneer u dubbelklikt op de Quickstart Jar om te starten, wordt een modaal foutbericht weergegeven om te voorkomen dat AEM lokaal wordt gestart.

het Oplossen van problemen - klik het Jar dossier van QuickStart tweemaal

AEM as a Cloud Service Quickstart Jar biedt namelijk geen ondersteuning voor dubbelklikken op de QuickStart Jar om AEM lokaal te starten. In plaats daarvan moet u het Jar-bestand vanaf die opdrachtregel uitvoeren.

Als u de AEM Auteur-service wilt starten, gaat u naar cd in de map met de Quickstart Jar en voert u de opdracht uit:

macOS

code language-shell
`$ java -jar aem-author-p4502.jar`

Vensters

code language-shell
`$ java -jar aem-author-p4502.jar`

Linux®

code language-shell
`$ java -jar aem-author-p4502.jar`

of, om de AEM-publicatieservice te starten, cd in de map met de Quickstart Jar en voer de opdracht uit:

macOS

code language-shell
`$ java -jar aem-publish-p4503.jar`

Vensters

code language-shell
`$ java -jar aem-publish-p4503.jar`

Linux®

code language-shell
`$ java -jar aem-publish-p4503.jar`

Het beginnen van Jar Quickstart van de bevellijn aborteert onmiddellijk troubleshooting-java-8

Bij het starten van de Quickstart Jar vanaf de opdrachtregel wordt het proces onmiddellijk afgebroken en start de AEM-service niet, met de volgende fout:

➜  ~/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

AEM as a Cloud Service heeft Java™ SDK 11 nodig en u gebruikt een andere versie, waarschijnlijk Java™ 8. Om deze kwestie op te lossen, download en installeer [ 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%2fx jcr%3AlastModified&orderby.sort=desc&layout=list&p.offset=0&p.limit=14).

Nadat Oracle Java™ 11 SDK is geïnstalleerd, controleert u of dit de actieve versie is door de opdracht uit te voeren vanaf de opdrachtregel:

macOS

code language-shell
`$ java --version`

Vensters

code language-shell
`$ java -version`

Linux®

code language-shell
`$ java --version`

Aanvullende bronnen

recommendation-more-help

4859a77c-7971-4ac9-8f5c-4260823c6f69