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

Experience Manager Developer Tools for Eclipse logo

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:

NOTE
Op macOS, moet u Eclipse.app met de rechtermuisknop aanklikken, en dan selecteren toont de Inhoud van het Pakket om uw 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:

  1. Open de ​ Website van de Hulpmiddelen van de Ontwikkelaar van AEM.

  2. 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.
  3. In Verduistering, open het menu van de Hulp.

  4. Klik installeer Nieuwe Software.

  5. Klik toevoegen….

  6. Op het gebied van de Naam, ga AEM Developer Tools in.

  7. Op het gebied van de Plaats, kopieer de installatie URL.

  8. Klik toevoegen.

  9. Controle zowel AEM als het Verdelen stoppen.

  10. Klik op Next.

  11. In het installeer Details venster, herzie de te installeren punten en klik daarna opnieuw.

  12. Accepteer de vergunningsovereenkomsten en klik Afwerking.

  13. In de dialoog van de Autoriteiten van het Vertrouwen die verschijnt, selecteer het gezag/de plaats https://eclipse.adobe.com en klik Geselecteerd Vertrouwen.

  14. In de dialoog van het Vertrouwen die verschijnt, selecteer de codeondertekenaars en klik Geselecteerd Vertrouwen.

  15. 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:

  1. Van de het menubar van de Verduistering, uitgezocht Venster Perspectief > Open Perspectief > Andere .
  2. Selecteer AEM in de dialoog en klik Open.

het perspectief van AEM in Verduistering

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:

  1. In het Dossier > Nieuw > het menu van het Project, doorblader aan de sectie van AEM en selecteer de Steekproef van AEM Multi-Module Project.

    de Steekproef van AEM Multi-Module Project

  2. Klik op Next.

    note note
    NOTE
    Deze stap zou een ogenblik kunnen nemen omdat ​ m2eclipse ​ de archetype catalogi moet aftasten.
  3. 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.

    Uitgezochte archetype versie

  4. 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.

    bepaalt archetype eigenschappen

  5. Klik op Next.

  6. 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.

    verbind met de server van AEM

    • 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.
  7. Klik Afwerking.

De projectstructuur wordt gemaakt. Het kan even duren om de noodzakelijke artefacten aan het project te downloaden.

NOTE
Op een nieuwe installatie of wanneer de Geweven gebiedsdelen niet eerder zijn gedownload, kan Eclipse melden dat het project met fouten werd gecreeerd. In dit geval, volg de procedure die in de sectie ​ wordt beschreven het Oplossen van Ongeldige Definitie van het Project.

Bestaande projecten importeren how-to-import-existing-projects

Gebruik de Nieuwe eigenschap van het Project om de basisprojectstructuur tot stand te brengen.

  1. 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 inhoud
    • PROJECT.ui.content for /content dat is gemaakt
    • PROJECT.core voor Java-pakketten
    • PROJECT.it.launcher en PROJECT.it.tests voor integratietests
  2. Vervang de inhoud van het PROJECT.ui.apps -project door de mappen apps en etc van het pakket:

    1. In het paneel van de Ontdekkingsreiziger van het Project, breid PROJECT.ui.apps > src > main > content > jcr_root > apps uit.
    2. Klik met de rechtermuisknop op de apps omslag en kies Tonen in > Ontdekkingsreiziger van het Systeem.
    3. Verwijder de mappen apps en etc .
    4. Plaats de mappen apps en etc van het inhoudspakket op dezelfde locatie.
    5. In Verduistering, klik het PROJECT.ui.apps project met de rechtermuisknop aan en kies verfrissen.
  3. Doe dan het zelfde voor PROJECT.ui.content en vervang zijn inhoudsomslag met één van uw pakketten:

    1. In het paneel van de Ontdekkingsreiziger van het Project, breid PROJECT.ui.content > src > main > content > jcr_root > content uit.
    2. Klik de diepere inhoudsomslag met de rechtermuisknop aan en kies Tonen in > Ontdekkingsreiziger van het Systeem.
    3. Verwijder de inhoudsmap daar.
    4. Plaats de inhoudsmap van het inhoudspakket op dezelfde locatie.
    5. In Verduistering, klik het PROJECT.ui.content project met de rechtermuisknop aan en kies verfrissen.
  4. Werk de filter.xml bestanden van deze twee projecten bij zodat ze overeenkomen met de inhoud van het inhoudspakket door het META-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>
    
  5. 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.

    1. Open PROJECT.ui.apps/src/main/content/META-INF/filter.xml in Eclipse.

    2. 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>
        
    3. Open vervolgens PROJECT.ui.content/src/main/content/META-INF/filter.xml .

    4. 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>
        
  6. Zorg ervoor dat u al uw wijzigingen opslaat. U kunt deze nieuwe inhoud nu synchroniseren met uw AEM-exemplaar.

  7. In het paneel van Servers, zorg ervoor dat uw verbinding is begonnen, en als, niet het begint.

  8. 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:

  1. Selecteer alle gemaakte projecten.
  2. Klik met de rechtermuisknop.
  3. In het contextmenu, uitgezochte Gemaakt > Projecten van de Update.
  4. Controle de Updates van de Kracht van Momentopname/Versies.
  5. 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 volgende officiële ​ documentatie van de Verduistering ​ kan helpen aan opstelling uw milieu:

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2