AEM Developer Tools for Eclipse

Senast uppdaterad: 4 maj 2023

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

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

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

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

  1. Bläddra i AEM Webbplats för utvecklingsverktyg.

  2. 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.

  3. Öppna Hjälp -menyn.

  4. Klicka Installera ny programvara.

  5. Klicka Lägg till….

  6. I Namn AEM Developer Tools.

  7. I Plats kopiera installations-URL:en.

  8. Klicka OK.

  9. Markera båda AEM och Sling plugin-program.

  10. Klicka på Nästa.

  11. Klicka på Nästa.

  12. Godkänn de linjära avtalen och klicka på Slutför.

  13. Klicka Ja för att starta om Eclipse.

Importera befintliga projekt

NOTE

AEM

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

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:

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

    chlimage_1-69

  2. Klicka på Nästa.

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

    chlimage_1-70

  3. Välj com.adobe.granite.archietypes : sample-project-architype : (högsta antal) från menyn och sedan klicka på Nästa.

    chlimage_1-71

  4. Fyll i en Namn, Grupp-ID och Artefakt-ID för exempelprojektet. Du kan också välja att ange vissa avancerade egenskaper.

    chlimage_1-72

  5. 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:

        -nofork -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=10123

    chlimage_1-73

  6. Klicka Slutför. Projektstrukturen skapas.

    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

Löser ogiltig projektdefinition

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

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

Aktivera automatisk komplettering av taggbibliotek i JSP-filer

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

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

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

Föregående sida
Nästa sida

Experience Manager