AEM Developer Tools for Eclipse aem-developer-tools-for-eclipse
Ökning overview
Experience Manager 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 underlättar utvecklingen av AEM:
- 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 Bootstrap av AEM-projekt genom en särskild 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 Enterprise Java™ Developers.
- Konfigurera din förmörkande installation för att säkerställa att du har minst 1 GB stackminne genom att redigera konfigurationsfilen för
eclipse.ini
enligt beskrivningen i Vanliga frågor om Eclipse.
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:
-
Öppna AEM Developer Tools Web Site.
-
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.
-
Öppna menyn Hjälp i Eclipse.
-
Klicka på Installera ny programvara.
-
Klicka på Lägg till….
-
Ange
AEM Developer Tools
i fältet Namn. -
Kopiera installations-URL:en i fältet Plats.
-
Klicka på Lägg till.
-
Kontrollera både AEM- och Sling-plugin-program.
-
Klicka på Nästa.
-
Klicka på Nästa igen i fönstret Installationsinformation.
-
Acceptera licensavtalen och klicka på Slutför.
-
Klicka på RestartNow för att starta om Eclipse.
AEM Perspective 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 utvecklingsverktyg för Eclipse har ett AEM-perspektiv som ger dig full kontroll över dina AEM-projekt och instanser. Så här öppnar du AEM Perspective:
- Välj Fönster > Perspektiv > Öppna perspektiv > Annat på Eclipse-menyraden.
- Välj AEM i dialogrutan och klicka på Öppna.
Exempel på flermodulsprojekt sample-multi-module-project
Experience Manager Developer Tools for Eclipse innehåller ett exempel på ett projekt med flera moduler som hjälper dig att snabbt komma igång med projektkonfigurationen i Eclipse. Det är också en metodguide till flera AEM-funktioner. Läs mer om projekttypen.
Så här skapar du exempelprojektet:
-
Gå till avsnittet AEM på menyn Arkiv > Nytt > Projekt och välj AEM Sample Multi-Module Project.
-
Klicka på Nästa.
note note NOTE Det här steget kan ta en stund eftersom m2eclipse måste skanna arkivtypskatalogerna. -
Välj
com.adobe.granite.archetypes : sample-project-archetype : <highest-number>
på menyn och klicka sedan på Nästa. -
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.
-
Klicka på Nästa.
-
Sedan konfigurerar du en AEM-server som Eclipse ansluter 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
-
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:
-
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ållPROJECT.ui.content
för/content
som har skapatsPROJECT.core
för Java™-paket (dessa blir intressanta när du vill lägga till Java™-kod)PROJECT.it.launcher
ochPROJECT.it.tests
för integreringstester
-
Ersätt innehållet i ditt
PROJECT.ui.apps
-projekt med mapparnaapps
ochetc
i ditt paket:- I projektutforskarpanelen, visa
PROJECT.ui.apps
>src
>main
>content
>jcr_root
>apps
. - Högerklicka på mappen
apps
och välj Visa i > Systemutforskaren. - Ta bort mapparna
apps
ochetc
som du nu ska visa och placeraapps
ochetc
mappar i innehållspaketet här. - Högerklicka på projektet
PROJECT.ui.apps
i Eclipse och välj Uppdatera.
- I projektutforskarpanelen, visa
-
Gör sedan samma sak för
PROJECT.ui.content
och ersätt dess innehållsmapp med ett av dina paket:- I projektutforskarpanelen, visa
PROJECT.ui.content
>src
>main
>content
>jcr_root
>content
. - Högerklicka på den djupare innehållsmappen och välj Visa i > Systemutforskaren.
- Ta bort innehållsmappen som du nu ska se och placera innehållsmappen i innehållspaketet här.
- Högerklicka på projektet
PROJECT.ui.content
i Eclipse och välj Uppdatera.
- I projektutforskarpanelen, visa
-
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 duMETA-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>
- Detta är ett exempel på hur din
-
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.-
Öppna
PROJECT.ui.apps/src/main/content/META-INF/filter.xml
i Eclipse. -
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>
-
-
Öppna sedan
PROJECT.ui.content/src/main/content/META-INF/filter.xml
. -
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>
-
-
-
Spara alla ändringar. Nu kan du synkronisera det nya innehållet med din AEM-instans.
-
Kontrollera att anslutningen har startats på serverpanelen och starta den om den inte redan har startats.
-
Klicka på ikonen Rensa och publicera .
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:
- Markera alla skapade projekt.
- Högerklicka.
- Välj Maven > Uppdatera projekt på snabbmenyn.
- Kontrollera Tvinga uppdateringar av ögonblicksbild/släppningar.
- 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:
- Apache Sling IDE-verktygen för Eclipse Användarhandbok hjälper dig igenom de övergripande begreppen, serverintegrationen och distributionsfunktionerna som stöds av AEM utvecklingsverktyg.
- Avsnittet Felsökning.
- Listan Kända fel.
Följande officiella Eclipse-dokumentation kan hjälpa dig att konfigurera miljön: