AEM för Eclipse

Översikt

AEM Developer Tools for Eclipse är en Eclipse-plugin som baseras på Eclipse-pluginen för Apache Sling som släppts 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 för Java EE-utvecklare. 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 gigabyte stackminne genom att redigera konfigurationsfilen för eclipse.ini enligt beskrivningen i Vanliga frågor om Eclipse.

OBSERVERA

I macOS måste du högerklicka på Eclipse.app och sedan välja Visa paketinnehåll för att hitta din eclipse.ini.

Installera AEM Developer Tools för Eclipse

När du har uppfyllt kraven kan du installera plugin-programmet enligt följande:

  1. Bläddra på webbplatsen AEM för utvecklingsverktyg.

  2. Kopiera installationslänken.

    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 menyn Hjälp i Eclipse.

  4. Klicka på Installera ny programvara.

  5. Klicka på Lägg till….

  6. I Namn skriver du AEM Utvecklarverktyg.

  7. I Plats kopierar du installations-URL:en.

  8. Klicka på OK.

  9. Kontrollera både AEM och Sling plugin-program.

  10. Klicka på Nästa.

  11. Klicka på Nästa.

  12. Acceptera de länkade avtalen och klicka på Slutför.

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

Importera befintliga projekt

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 projekt med flera moduler som hjälper dig att snabbt komma igång med en projektkonfiguration 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 Arkiv > Nytt > Projekt går du till AEM och väljer AEM Sample Multi-Module Project.

    chlimage_1-69

  2. Klicka på Nästa.

    OBSERVERA

    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) på menyn och klicka sedan på Nästa.

    chlimage_1-71

  4. Fyll i ett namn, Grupp-ID och ett 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 på 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 proceduren som beskrivs i Lösa ogiltig projektdefinition.

Felsökning

Matchar ogiltig projektdefinition

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

  1. Markera alla skapade projekt.
  2. Högerklicka. På menyn Maven väljer du Uppdatera projekt.
  3. Markera Tvinga uppdateringar av ögonblicksbild/släppningar.
  4. Klicka på 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 officiella Eclipse-dokumentation kan hjälpa dig att konfigurera miljön:

På denna sida