AEM Developer Tools for Eclipse aem-developer-tools-for-eclipse
Overzicht overview
Experience Manager de Hulpmiddelen van de Ontwikkelaar voor Verduistering is een stop van de Verduistering die op de wordt gebaseerd de stop van de Verduistering voor Apache die onder Vergunning 2 wordt vrijgegeven Apache.
Het biedt verschillende functies die de ontwikkeling van AEM vereenvoudigen:
- Naadloze integratie met AEM-instanties via Eclipse Server Connector
- Synchronisatie voor zowel inhoud als OSGi-bundels
- Ondersteuning voor foutopsporing met functie voor hot-swapping van code
- Eenvoudige Bootstrap van AEM-projecten via een specifieke wizard voor het maken van projecten
- Eenvoudig bewerken van JCR-eigenschappen
Vereisten requirements
Voordat u de AEM Developer Tools kunt gebruiken, moet u:
- De download en installeert winde van de Verduistering voor Onderneming Java en de Ontwikkelaars van het Web.
- Versie 1.4.0 van de AEM Developer Tools for Eclipse is compatibel met Eclipse 2022-12 (4.26) of hoger en vereist dat Java 17 of hoger wordt uitgevoerd.
- Vorm uw installatie van de Verduistering om ervoor te zorgen dat u minstens 1 GB van heapgeheugen door uw
eclipse.ini
configuratiedossier zoals die in wordt beschreven Veelgestelde vragen van de Verduistering hebt.
eclipse.ini
te vinden.AEM Developer Tools for Eclipse installeren how-to-install-the-aem-developer-tools-for-eclipse
Wanneer u aan de vereisten hierboven hebt voldaan, kunt u de stop van ontwikkelaarshulpmiddelen als volgt installeren:
-
Open de Website van de Hulpmiddelen van de Ontwikkelaar van AEM.
-
Kopieer de Verbinding van de Installatie.
- U kunt ook een archief downloaden in plaats van de installatiekoppeling te gebruiken.
- Deze methode staat offlineinstallatie toe maar u ontvangt geen automatische updatedeclaraties.
-
In Verduistering, open het menu van de Hulp.
-
Klik installeer Nieuwe Software.
-
Klik toevoegen….
-
Op het gebied van de Naam, ga
AEM Developer Tools
in. -
Op het gebied van de Plaats, kopieer de installatie URL.
-
Klik toevoegen.
-
Controle zowel AEM als het Verdelen stoppen.
-
Klik op Next.
-
In het installeer Details venster, herzie de te installeren punten en klik daarna opnieuw.
-
Accepteer de vergunningsovereenkomsten en klik Afwerking.
-
In de dialoog van de Autoriteiten van het Vertrouwen die verschijnt, selecteer het gezag/de plaats
https://eclipse.adobe.com
en klik Geselecteerd Vertrouwen. -
In de dialoog van het Vertrouwen die verschijnt, selecteer de codeondertekenaars en klik Geselecteerd Vertrouwen.
-
Klik RestartNow om Eclipse opnieuw te beginnen.
Het AEM-perspectief the-aem-perspective
In Verduistering, bepaalt het a Perspectief de acties en de meningen beschikbaar binnen een venster en laat taakgerichte interactie met middelen in Verduistering toe. Voor meer details over vooruitzichten, zie de documentatie van de Verduistering..
De Hulpmiddelen van de Ontwikkeling van Experience Manager voor Verduistering verstrekken een perspectief van AEM dat u volledige controle over uw projecten en instanties van AEM aanbiedt. Het AEM-perspectief openen:
- Van de het menubar van de Verduistering, uitgezocht Venster Perspectief > Open Perspectief > Andere .
- Selecteer AEM in de dialoog en klik Open.
Monster nemen van meermoduleproject sample-multi-module-project
De Hulpmiddelen van de Ontwikkelaar van Experience Manager voor Verduistering komen met een steekproef multi-moduleproject dat u snel met een projectopstelling in Verduistering helpt omhoog krijgen. Het dient ook als best-practice gids aan verscheidene eigenschappen van AEM, leveraging het Archetype van het Project van AEM.
Ga als volgt te werk om het voorbeeldproject te maken:
-
In het Dossier > Nieuw > het menu van het Project, doorblader aan de sectie van AEM en selecteer de Steekproef van AEM Multi-Module Project.
-
Klik op Next.
note note NOTE Deze stap zou een ogenblik kunnen nemen omdat m2eclipse de archetype catalogi moet aftasten. -
com.adobe.aem : aem-project-archetype : <highest-number>
zou automatisch in Archetype drop-down moeten worden geselecteerd. Selecteer desgewenst een vorige versie. Klik op Next. -
Geef de volgende velden op voor het voorbeeldproject:
- Naam
- Identiteitskaart van de Groep
- Artefact identiteitskaart
- appId - u kunt de Geavanceerde opties moeten uitbreiden om deze waarde te plaatsen.
- appTitle - u kunt de Geavanceerde opties moeten uitbreiden om deze waarde te plaatsen.
- Pakket - u kunt de Geavanceerde opties moeten uitbreiden om deze waarde te plaatsen.
-
Klik op Next.
-
Vorm een server van AEM waaraan de Verduistering door de nieuwe server van de Opstelling te selecteren verbindt en een servernaam en de noodzakelijke verbindingsdetails te verstrekken.
- Als u de functie voor foutopsporing wilt gebruiken, moet u AEM starten in de foutopsporingsmodus door de parameter
-agentlib
op te geven, bijvoorbeeld:
code language-text $ java -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=*:5005 -jar aem-author-p4502.jar
note tip TIP Voor meer details bij het zuiveren van uw project dat op lokale AEM SDK loopt, gelieve het document Verre het zuiveren van AEM SDK te zien. - Als u de functie voor foutopsporing wilt gebruiken, moet u AEM starten in de foutopsporingsmodus door de parameter
-
Klik Afwerking.
De projectstructuur wordt gemaakt. Het kan even duren om de noodzakelijke artefacten aan het project te downloaden.
Bestaande projecten importeren how-to-import-existing-projects
Gebruik de Nieuwe eigenschap van het Project om de basisprojectstructuur tot stand te brengen.
-
Volg de instructies om a Monster te creëren Multi-Module Project, dat tot een basisprojectstructuur met een gezonde scheiding van zorgen leidt:
PROJECT.ui.apps
voor/apps
en/etc
inhoudPROJECT.ui.content
for/content
dat is gemaaktPROJECT.core
voor Java-pakkettenPROJECT.it.launcher
enPROJECT.it.tests
voor integratietests
-
Vervang de inhoud van het
PROJECT.ui.apps
-project door de mappenapps
enetc
van het pakket:- In het paneel van de Ontdekkingsreiziger van het Project, breid
PROJECT.ui.apps
>src
>main
>content
>jcr_root
>apps
uit. - Klik met de rechtermuisknop op de
apps
omslag en kies Tonen in > Ontdekkingsreiziger van het Systeem. - Verwijder de mappen
apps
enetc
. - Plaats de mappen
apps
enetc
van het inhoudspakket op dezelfde locatie. - In Verduistering, klik het
PROJECT.ui.apps
project met de rechtermuisknop aan en kies verfrissen.
- In het paneel van de Ontdekkingsreiziger van het Project, breid
-
Doe dan het zelfde voor
PROJECT.ui.content
en vervang zijn inhoudsomslag met één van uw pakketten:- In het paneel van de Ontdekkingsreiziger van het Project, breid
PROJECT.ui.content
>src
>main
>content
>jcr_root
>content
uit. - Klik de diepere inhoudsomslag met de rechtermuisknop aan en kies Tonen in > Ontdekkingsreiziger van het Systeem.
- Verwijder de inhoudsmap daar.
- Plaats de inhoudsmap van het inhoudspakket op dezelfde locatie.
- In Verduistering, klik het
PROJECT.ui.content
project met de rechtermuisknop aan en kies verfrissen.
- In het paneel van de Ontdekkingsreiziger van het Project, breid
-
Werk de
filter.xml
bestanden van deze twee projecten bij zodat ze overeenkomen met de inhoud van het inhoudspakket door hetMETA-INF/vault/filter.xml
-bestand van het inhoudspakket te openen in een aparte tekst-/code-editor.- Dit is een voorbeeld van hoe uw
filter.xml
-bestand eruit kan zien:
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>
- Dit is een voorbeeld van hoe uw
-
Wat de inhoud van het pakket betreft dat in twee projecten is gesplitst, moet u deze filterregels ook in twee splitsen en de
filter.xml
-bestanden van de twee projecten dienovereenkomstig bijwerken.-
Open
PROJECT.ui.apps/src/main/content/META-INF/filter.xml
in Eclipse. -
Vervang de inhoud van het element
<workspaceFilter>
door de regels van het pakket die beginnen met/apps
en/etc
-
Bijvoorbeeld:
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>
-
-
Open vervolgens
PROJECT.ui.content/src/main/content/META-INF/filter.xml
. -
Vervang de regels door de regels in het pakket die beginnen met
/content
.-
Bijvoorbeeld:
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>
-
-
-
Zorg ervoor dat u al uw wijzigingen opslaat. U kunt deze nieuwe inhoud nu synchroniseren met uw AEM-exemplaar.
-
In het paneel van Servers, zorg ervoor dat uw verbinding is begonnen, en als, niet het begint.
-
Klik Schoon en publiceer pictogram.
Als u klaar bent, moet het pakket op uw exemplaar worden uitgevoerd. Bij het opslaan worden wijzigingen automatisch gesynchroniseerd met de instantie.
Als u een pakket uit uw project wilt re-bouwen, klik PROJECT.ui.apps
of PROJECT.ui.content
met de rechtermuisknop aan en kies Looppas zoals > Gemaakt installeert.
Er is nu een doelmap gemaakt met de pakketmap in die map (bijvoorbeeld PROJECT.ui.apps-0.0.1-SNAPSHOT.zip
genoemd).
Problemen oplossen troubleshooting
Ongeldige projectdefinitie oplossen resolving-invalid-project-definition
Om ongeldige gebiedsdelen en projectdefinitie op te lossen ga als volgt te werk:
- Selecteer alle gemaakte projecten.
- Klik met de rechtermuisknop.
- In het contextmenu, uitgezochte Gemaakt > Projecten van de Update.
- Controle de Updates van de Kracht van Momentopname/Versies.
- Klik OK.
Eclipse downloadt de vereiste afhankelijkheden. Dit kan even duren.
Meer informatie more-information
Op de officiële Apache Sling IDE-website voor Eclipse vindt u nuttige aanvullende informatie:
- De Apache het Verdelen hulpmiddelen van winde voor de Gids van de Gebruiker van de Verduistering begeleidt u door de algemene concepten, serverintegratie, en plaatsingsmogelijkheden die door de Hulpmiddelen van de Ontwikkeling van AEM worden gesteund.
- het Oplossen van problemen Apache het Verdelen van het hulpmiddel van winde
- Bekende kwesties lijst
De volgende officiële documentatie van de Verduistering kan helpen aan opstelling uw milieu: