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

Experience Manager Developer Tools for Eclipse logo

Ökning overview

Experience Manager Developer Tools för Eclipse är ett 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
  • Enkelt Bootstrap i AEM projekt med hjälp av en särskild projektguide
  • Enkel redigering av JCR-egenskaper

Krav requirements

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

NOTE
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 for Eclipse how-to-install-the-aem-developer-tools-for-eclipse

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

  1. Öppna AEM webbplatsen för utvecklingsverktyg.

  2. Kopiera installationslänken.

    Du kan även hämta ett arkiv i stället för att använda installationslänken. Den här metoden tillåter offlineinstallation, men du får inga meddelanden om automatiska uppdateringar 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. Ange AEM Developer Tools i fältet Namn.

  7. Kopiera installations-URL:en i fältet Plats.

  8. Klicka på Lägg till.

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

  10. Klicka på Nästa.

  11. Klicka på Nästa igen i fönstret Installationsinformation.

  12. Acceptera licensavtalen och klicka på Slutför.

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

AEM the-aem-perspective

I Eclipse avgör ett perspektiv vilka åtgärder och vyer som finns tillgängliga i ett fönster och aktiverar uppgiftsorienterad interaktion med resurser i Eclipse. Mer information om perspektiv finns i Eclipse-dokumentationen.

Experience Manager Development Tools for Eclipse har ett AEM perspektiv som ger dig full kontroll över dina AEM projekt och instanser. Så här öppnar du AEM perspektiv:

  1. Välj Fönster > Perspektiv > Öppna perspektiv > Annat på Eclipse-menyraden.
  2. Välj AEM i dialogrutan och klicka på Öppna.

Perspektivet AEM i Eclipse

Exempel på flermodulsprojekt sample-multi-module-project

Utvecklingsverktygen för Experience Manager för Eclipse innehåller ett exempel på ett projekt med flera moduler som hjälper dig att snabbt komma igång med en projektkonfiguration i Eclipse. Det är också en praktisk guide till flera AEM funktioner. Läs mer om projekttypen.

Så här skapar du exempelprojektet:

  1. I menyn Arkiv > Nytt > Projekt bläddrar du till avsnittet AEM och väljer AEM Exempelprojekt med flera moduler .

    AEM Exempel på flermodulsprojekt

  2. Klicka på Nästa.

    note note
    NOTE
    Det här steget kan ta en stund eftersom m2eclipse måste skanna arkivtypskatalogerna.
  3. Välj com.adobe.granite.archetypes : sample-project-archetype : <highest-number> på menyn och klicka sedan på Nästa.

    Välj arketypsversion

  4. Ange följande fält för exempelprojektet:

    • Namn
    • Grupp-ID
    • Artefakt-ID
    • appId - Du kan behöva utöka alternativen för Avancerat för att ange det här värdet.
    • appTitle - Du kan behöva utöka alternativen för Avancerat för att ange det här värdet.
    • Paket - Du kan behöva utöka alternativen för Avancerat för att ange det här värdet.

    Definiera arkitekturtypsegenskaper

  5. Klicka på Nästa.

  6. Sedan konfigurerar du 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-text
        -nofork -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=10123
    

    Anslut till AEM server

  7. Klicka på Slutför. Projektstrukturen skapas.

    note note
    NOTE
    Vid en ny installation (närmare bestämt när större beroenden aldrig har laddats ned) kan du få projektet skapat med fel. I det här fallet följer du proceduren som beskrivs i Lösa ogiltig projektdefinition.

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

Du kan använda funktionen Nytt projekt för att skapa rätt struktur för dig:

  1. Följ instruktionerna för att skapa ett exempel på ett flermodulsprojekt och du har följande projekt skapade för dig, vilket gör att du kan separera dina problem på ett bra sätt:

    • PROJECT.ui.apps för /apps- och /etc-innehåll
    • PROJECT.ui.content för /content som har skapats
    • PROJECT.core för Java™-paket (dessa blir intressanta när du vill lägga till Java™-kod)
    • PROJECT.it.launcher och PROJECT.it.tests för integreringstester
  2. Ersätt innehållet i ditt PROJECT.ui.apps-projekt med mapparna apps och etc i ditt paket:

    1. I projektutforskarpanelen, visa PROJECT.ui.apps > src > main > content > jcr_root > apps.
    2. Högerklicka på mappen apps och välj Visa i > Systemutforskaren.
    3. Ta bort mapparna apps och etc som du nu ska visa och placera apps och etc mappar i innehållspaketet här.
    4. Högerklicka på projektet PROJECT.ui.apps i Eclipse och välj Uppdatera.
  3. Gör sedan samma sak för PROJECT.ui.content och ersätt dess innehållsmapp med ett av dina paket:

    1. I projektutforskarpanelen, visa PROJECT.ui.content > src > main > content > jcr_root > content.
    2. Högerklicka på den djupare innehållsmappen och välj Visa i > Systemutforskaren.
    3. Ta bort innehållsmappen som du nu ska se och placera innehållsmappen i innehållspaketet här.
    4. Högerklicka på projektet PROJECT.ui.content i Eclipse och välj Uppdatera.
  4. Nu måste du uppdatera filter.xml-filerna för dessa två projekt så att de motsvarar innehållet i ditt innehållspaket. Om du vill göra det öppnar du META-INF/vault/filter.xml-filen för ditt innehållspaket i en separat text-/kodredigerare.

    • Detta är ett exempel på hur din filter.xml-fil kan se ut:
    code language-xml
    <?xml version="1.0" encoding="UTF-8"?>
    <workspaceFilter version="1.0">
        <filter root="/apps/foo"/>
        <filter root="/apps/foundation/components/bar"/>
        <filter root="/etc/designs/foo"/>
        <filter root="/content/foo"/>
        <filter root="/content/dam/foo"/>
        <filter root="/content/usergenerated/content/foo"/>
    </workspaceFilter>
    
  5. När det gäller innehållet i ditt paket som delats upp i två projekt måste du också dela upp dessa filterregler i två och uppdatera filter.xml-filerna för de två projekten.

    1. Öppna PROJECT.ui.apps/src/main/content/META-INF/filter.xml i Eclipse.

    2. Ersätt innehållet i elementet <workspaceFilter> med reglerna i paketet som börjar med /apps och /etc

      • Till exempel:

        code language-xml
        <?xml version="1.0" encoding="UTF-8"?>
        <workspaceFilter version="1.0">
           <filter root="/apps/foo"/>
           <filter root="/apps/foundation/components/bar"/>
           <filter root="/etc/designs/foo"/>
        </workspaceFilter>
        
    3. Öppna sedan PROJECT.ui.content/src/main/content/META-INF/filter.xml.

    4. Ersätt reglerna med reglerna i ditt paket som börjar med /content.

      • Till exempel:

        code language-xml
        <?xml version="1.0" encoding="UTF-8"?>
        <workspaceFilter version="1.0">
           <filter root="/content/foo"/>
           <filter root="/content/dam/foo"/>
           <filter root="/content/usergenerated/content/foo"/>
        </workspaceFilter>
        
  6. Spara alla ändringar. Nu kan du synkronisera det nya innehållet med din AEM.

  7. Kontrollera att anslutningen har startats på serverpanelen och starta den om den inte redan har startats.

  8. Klicka på ikonen Rengör och Publish .

När du är klar bör du låta paketet köras på din instans, och när du sparar synkroniseras alla ändringar automatiskt till instansen.

Om du vill återskapa ett paket från ditt projekt högerklickar du på PROJECT.ui.apps eller PROJECT.ui.content och väljer Kör som > Maven Install.

Nu har du skapat en målmapp med ditt paket (som till exempel kallas PROJECT.ui.apps-0.0.1-SNAPSHOT.zip).

Felsökning troubleshooting

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

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

  1. Markera alla skapade projekt.
  2. Högerklicka.
  3. Välj Maven > Uppdatera projekt på snabbmenyn.
  4. Kontrollera Tvinga uppdateringar av ögonblicksbild/släppningar.
  5. Klicka på OK.

Eclipse hämtar nödvändiga beroenden. Det här kan ta en stund.

Mer information more-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:

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab