AEM Developer Tools for Eclipse

Översikt

"AEM Developer Tools" är en Eclipse-plugin som bygger 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.
  • Enkelt Bootstrap i AEM projekt med hjälp av en särskild projektguide.
  • Enkel redigering av JCR-egenskaper.

Krav

Innan du använder AEM Developer Tools ska du göra följande:

  • 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örkelseinstallationen för att säkerställa att du har minst 1 GB stackminne genom att redigera eclipse.ini konfigurationsfilen enligt beskrivningen i Vanliga frågor om Eclipse.

OBSERVERA

I macOS högerklickar du 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 Developer Tools webbplats på https://eclipse.adobe.com/aem/dev-tools/.

  2. Kopiera Installationslänk.

    Du kan även hämta ett arkiv i stället för att använda installationslänken. Om du gör det kan du installera offline, men du saknar meddelanden om automatiska uppdateringar.

  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

OBSERVERA

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

"AEM utvecklingsverktyg" innehåller ett exempel på ett flermodulsprojekt som hjälper dig att snabbt komma igång med projektkonfigurationen i Eclipse. Det är också 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.

    OBSERVERA

    Det här steget kan ta en stund eftersom m2eclipse måste skanna 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. Konfigurera nu en AEM som Eclipse kan 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.

    OBSERVERA

    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öljer du 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, markera 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 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:

På denna sida