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 för Java- och webbutvecklare för företag.
- Version 1.4.0 av AEM Developer Tools för Eclipse är kompatibel med Eclipse 2022-12 (4.26) eller senare och kräver Java 17 eller senare för att kunna köras.
- Konfigurera Eclipse-installationen så att du har minst 1 GB stackminne genom att redigera
eclipse.ini
-konfigurationsfilen 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 utvecklarverktygets plugin-program på följande sätt:
-
Öppna webbplatsen AEM Developer Tools.
-
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.
-
Öppna menyn Hjälp i Eclipse.
-
Klicka på Installera ny programvara.
-
Klicka på Lägg till….
-
Ange i fältet Namn
AEM Developer Tools
. -
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.
-
Granska de objekt som ska installeras i fönstret Installera information och klicka på Nästa igen.
-
Acceptera licensavtalen och klicka på Slutför.
-
I dialogrutan Lita på utfärdare som visas väljer du behörighet/plats
https://eclipse.adobe.com
och klickar på Lita på markerade. -
I dialogrutan Lita på artefakter som visas markerar du kodsignerarna och klickar på Lita på markerade.
-
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 är 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-perspektivet:
- 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 praktisk guide till flera AEM-funktioner som utnyttjar AEM Project Archetype.
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 söka igenom arkivtypskatalogerna. -
com.adobe.aem : aem-project-archetype : <highest-number>
ska väljas automatiskt i listrutan Arketyp. Välj en tidigare version om du vill. Klicka 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.
-
Konfigurera en AEM-server som Eclipse ansluter till genom att välja Konfigurera ny server och ange ett servernamn och nödvändig anslutningsinformation.
- Om du vill använda felsökningsfunktionen måste du starta AEM i felsökningsläge genom att ange parametern
-agentlib
, till exempel:
code language-text $ java -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=*:5005 -jar aem-author-p4502.jar
note tip TIP Mer information om hur du felsöker projekt som körs på en lokal AEM SDK finns i dokumentet Fjärrfelsökning i AEM SDK. - Om du vill använda felsökningsfunktionen måste du starta AEM i felsökningsläge genom att ange parametern
-
Klicka på Slutför.
Projektstrukturen skapas. Det kan ta en stund att hämta nödvändiga artefakter till projektet.
Importera befintliga projekt how-to-import-existing-projects
Använd funktionen Nytt projekt för att skapa den grundläggande projektstrukturen.
-
Följ instruktionerna för att skapa ett exempel på ett flermodulsprojekt som skapar en grundläggande projektstruktur med en felfri problemlösning:
PROJECT.ui.apps
för/apps
- och/etc
-innehållPROJECT.ui.content
för/content
som har skapatsPROJECT.core
för Java-paketPROJECT.it.launcher
ochPROJECT.it.tests
för integreringstester
-
Ersätt innehållet i ditt
PROJECT.ui.apps
-projekt med mapparnaapps
ochetc
i ditt paket:- Expandera > >
PROJECT.ui.apps
>src
>main
>content
på panelenjcr_root
Projektutforskarenapps
. - Högerklicka på mappen
apps
och välj Visa i > Systemutforskaren. - Ta bort mapparna
apps
ochetc
där. - Placera
apps
- ochetc
-mapparna för ditt innehållspaket på samma plats. - Högerklicka på projektet
PROJECT.ui.apps
i Eclipse och välj Uppdatera.
- Expandera > >
-
Gör sedan samma sak för
PROJECT.ui.content
och ersätt dess innehållsmapp med ett av dina paket:- Expandera > >
PROJECT.ui.content
>src
>main
>content
på panelenjcr_root
Projektutforskarencontent
. - Högerklicka på den djupare innehållsmappen och välj Visa i > Systemutforskaren.
- Ta bort innehållsmappen där.
- Placera innehållsmappen för ditt innehållspaket på samma plats.
- Högerklicka på projektet
PROJECT.ui.content
i Eclipse och välj Uppdatera.
- Expandera > >
-
Uppdatera
filter.xml
-filerna för dessa två projekt så att de motsvarar innehållet i ditt innehållspaket genom att öppnaMETA-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 i enlighet med detta.-
Ö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 och, om så är fallet, starta den på panelen Servrar.
-
Klicka på ikonen Rensa och publicera .
När du är klar bör paketet köras på din instans. 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 ytterligare användbar information:
- Apache Sling IDE-verktygen för Eclipse Användarhandbok vägleder dig genom de övergripande begreppen, serverintegrationen och distributionsfunktionerna som stöds av AEM utvecklingsverktyg.
- Felsökning av verktyg för Apache Sling IDE
- Lista över kända fel
Följande officiella Eclipse-dokumentation kan hjälpa dig att konfigurera miljön: