Dokumentation AEM 6.4 Användarhandbok om utveckling

AEM Developer Tools for Eclipse aem-developer-tools-for-eclipse

Last update: Thu May 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Ämnen:
Developing

Skapat för:

Developer

CAUTION

AEM 6.4 har nått slutet på den utökade supporten och denna dokumentation är inte längre uppdaterad. Mer information finns i teknisk supportperiod. Hitta de versioner som stöds här.

Översikt overview

AEM Developer Tools for Eclipse är en Eclipse-plugin baserad på Eclipse-plugin för Apache Sling som släpps under Apache License 2.

Den har flera funktioner som gör AEM enklare:

Smidig integrering med AEM instanser via Eclipse Server Connector.
Synkronisering för både innehåll och OSGI-paket.
Felsökningsstöd med möjlighet att byta kod under drift.
Enkel start av AEM projekt via en specifik projektguide.
Enkel redigering av JCR-egenskaper.

Krav requirements

Innan du använder AEM Developer Tools måste du:

Hämta och installera Eclipse IDE for Java EE Developers. AEM Developer Tools har för närvarande stöd för Eclipse Kepler eller senare
Kan användas med AEM version 5.6.1 eller senare
Konfigurera förmörkelsen så att du har minst 1 gigabyte stackminne genom att redigera eclipse.ini konfigurationsfilen enligt beskrivningen i Vanliga frågor om Eclipse.

NOTE

På macOS högerklickar du på Eclipse.app och sedan markera Visa paketinnehåll för att hitta eclipse.ini.

Installera AEM Developer Tools for Eclipse how-to-install-the-aem-developer-tools-for-eclipse

När du har uppfyllt krav ovan kan du installera plugin-programmet på följande sätt:

Bläddra i AEM Webbplats för utvecklingsverktyg.
Kopiera Installationslänk.

Observera att du kan hämta ett arkiv i stället för att använda installationslänken. Detta tillåter offlineinstallation men du kommer att sakna automatiska uppdateringsmeddelanden på det här sättet.
Öppna Hjälp -menyn.
Klicka Installera ny programvara.
Klicka Lägg till….
I Namn AEM Developer Tools.
I Plats kopiera installations-URL:en.
Klicka OK.
Markera båda AEM och Sling plugin-program.
Klicka på Nästa.
Klicka på Nästa.
Godkänn de linjära avtalen och klicka på Slutför.
Klicka Ja för att starta om Eclipse.

Importera befintliga projekt how-to-import-existing-projects

NOTE

Se Så här arbetar du med ett paket i Eclipse när det hämtades från AEM.

AEM the-aem-perspective

AEM utvecklingsverktyg för Eclipse levereras med ett perspektiv som ger dig full kontroll över dina AEM projekt och instanser.

chlimage_1-2

Exempel på flermodulsprojekt sample-multi-module-project

I AEM Developer Tools for Eclipse finns ett exempel på ett flermodulsprojekt som hjälper dig att snabbt komma igång med projektkonfigurationen i Eclipse, och som en praktisk guide till flera AEM funktioner. Läs mer om Project Archetype.

Så här skapar du exempelprojektet:

I Fil > Nytt > Projekt -menyn, bläddra till AEM avsnitt och markera Exempel på AEM projekt med flera moduler.

Klicka på Nästa.

note note
NOTE
Det här steget kan ta en stund eftersom m2eclipse behöver genomsöka arkivtypskatalogerna.

chlimage_1-70

Välj com.adobe.granite.archietypes : sample-project-architype : (högsta antal) från menyn och sedan klicka på Nästa.
Fyll i en Namn, Grupp-ID och Artefakt-ID för exempelprojektet. Du kan också välja att ange vissa avancerade egenskaper.

Sedan bör du konfigurera en AEM som Eclipse ska ansluta till.

Om du vill använda felsökningsfunktionen måste du ha startat AEM i felsökningsläge, vilket du kan göra genom att lägga till följande på kommandoraden:

code language-none
`-nofork -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=10123`

chlimage_1-73

Klicka Slutför. Projektstrukturen skapas.

note note
NOTE
I en ny anläggning (närmare bestämt: när större beroenden aldrig har laddats ned) kan det uppstå fel i projektet. I så fall, följ det förfarande som beskrivs i Löser ogiltig projektdefinition.

Felsökning troubleshooting

Löser ogiltig projektdefinition resolving-invalid-project-definition

Så här löser du ogiltiga beroenden och projektdefinitioner:

Markera alla skapade projekt.
Högerklicka. På menyn Maven välj Uppdatera projekt.
Kontrollera Tvinga uppdateringar av ögonblicksbild/releaser.
Klicka OK. Eclipse försöker hämta nödvändiga beroenden.

Aktivera automatisk komplettering av taggbibliotek i JSP-filer enabling-tag-library-autocompletion-in-jsp-files

Automatisk komplettering av taggbibliotek går inte att utföra eftersom rätt beroenden läggs till i projektet. Det finns ett känt fel i AEM Uber Jar, som inte innehåller de tld- och TagExtraInfo-filer som behövs.

Se till att artefakten org.apache.sling.scripting.jsp.taglib finns i klassökvägen före AEM Uber Jar för att undvika problemet. För Maven-projekt placerar du följande beroende i pom.xml före Uber Jar.

<dependency>
  <groupId>org.apache.sling</groupId>
  <artifactId>org.apache.sling.scripting.jsp.taglib</artifactId>
  <scope>provided</scope>
</dependency>

Se till att du lägger till rätt version för din distribution av AEM.

Mer information more-information

Den officiella versionen av Apache Sling IDE-verktygen för Eclipse-webbplatsen innehåller användbar information:

The Apache Sling IDE-verktyg för Eclipse Användarhandbokguidar den här dokumentationen dig igenom de övergripande begreppen, serverintegrering och driftsättningsfunktioner som stöds av AEM utvecklingsverktyg.
The Felsökningsavsnitt.
The Lista över kända fel.

Följande tjänsteman Eclipse dokumentation kan hjälpa dig att konfigurera miljön:

recommendation-more-help

2315f3f5-cb4a-4530-9999-30c8319c520e