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

Hulpmiddelen van de Ontwikkelaar van de Experience Manager voor het embleem van de Verduistering

Overzicht overview

{de Hulpmiddelen van de Ontwikkelaar van 0} Experience Manager voor Verduistering is een stop Eclipse die op de wordt gebaseerd de stop van de Verduistering voor Apache Slingonder Vergunning 2 wordt vrijgegeven Apache.

Het biedt verschillende functies die AEM ontwikkeling vergemakkelijken:

  • 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 door middel van een specifieke Tovenaar van de Aanmaak van het Project
  • 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.inite vinden.

Hoe te om de Hulpmiddelen van de Ontwikkelaar van de AEM voor Eclipse te installeren how-to-install-the-aem-developer-tools-for-eclipse

Wanneer u aan de vereistenhierboven hebt voldaan, kunt u de stop als volgt installeren:

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

  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 op deze manier.

  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 installeer Details venster, klik daarna opnieuw.

  12. Accepteer de vergunningsovereenkomsten en klik Afwerking.

  13. Klik RestartNow om Eclipse opnieuw te beginnen.

Het AEM perspectief the-aem-perspective

In Eclipse, bepaalt het Perspectief de acties en de meningen beschikbaar binnen een venster en laat taakgerichte interactie met middelen in Verduistering toe. Voor meer details over Perspectief, zie de documentatie van de Verduistering.

Hulpmiddelen van de Ontwikkeling van de Experience Manager voor Verduistering verstrekken een AEM Perspectief dat u volledige controle over uw AEM Projecten en instanties 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 AEM perspectief in Verduistering

Monster nemen van meermoduleproject sample-multi-module-project

De Hulpmiddelen van de Ontwikkelaar van de Experience Manager voor Verduistering komt met een steekproef, multi-moduleproject dat u snel met een projectopstelling in Verduistering helpt omhoog krijgen. Het dient ook als gids voor beste praktijken aan verscheidene AEM eigenschappen. leer meer over het Archetype van het Project.

Ga als volgt te werk om het voorbeeldproject te maken:

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

    AEM Steekproef Multi-Module Project

  2. Klik op Next.

    note note
    NOTE
    Deze stap kan even duren omdat m2eclipse de catalogi van archetype moet aftasten.
  3. Kies com.adobe.granite.archetypes : sample-project-archetype : <highest-number> van het menu, dan klik daarna.

    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. Vervolgens configureert u een AEM server waarmee Eclipse verbinding maakt.

    Om de debugger eigenschap te gebruiken, moet u AEM op zuivert wijze begonnen zijn - die kan worden bereikt, voor door het volgende aan de bevellijn toe te voegen:

    code language-text
        -nofork -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=10123
    

    verbind met AEM server

  7. Klik Afwerking. De projectstructuur wordt gemaakt.

    note note
    NOTE
    Op een nieuwe installatie (meer specifiek, wanneer bepaalde gebiedsdelen nooit zijn gedownload) zou u het project kunnen krijgen dat met fouten wordt gecreeerd. In dit geval, volg de procedure die in wordt beschreven het Oplossen van Ongeldige Definitie van het Project.

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

U kunt de Nieuwe eigenschap van het Project gebruiken om de juiste structuur voor u tot stand te brengen:

  1. Volg de instructies om tot het Project van de Monster van de a Monster Multi-Modulete leiden en u hebt de volgende die projecten voor u worden gecreeerd, die een gezonde scheiding van zorgen toelaten:

    • PROJECT.ui.apps voor /apps en /etc inhoud
    • PROJECT.ui.content for /content dat is gemaakt
    • PROJECT.core voor Java™-bundels (deze worden interessant wanneer u Java™-code wilt toevoegen)
    • 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. Vouw in het deelvenster Projectverkenner 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 die u nu moet zien en plaats hier de mappen apps en etc van het inhoudspakket.
    4. 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. Vouw in het deelvenster Projectverkenner 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 die u nu moet zien en plaats hier de inhoudsmap van het inhoudspakket.
    4. In Verduistering, klik het PROJECT.ui.content project met de rechtermuisknop aan en kies verfrissen.
  4. Nu moet u de filter.xml dossiers van deze twee projecten bijwerken om aan de inhoud van uw inhoudspakket te beantwoorden. Open daartoe het META-INF/vault/filter.xml -bestand van het inhoudspakket 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 die nieuwe inhoud nu synchroniseren met uw AEM.

  7. Controleer of in het deelvenster Servers de verbinding is gestart en start deze als dat niet het geval is.

  8. Klik het Schone en Publish pictogram.

Als u klaar bent, moet het pakket op de instantie worden uitgevoerd en als u het bestand opslaat, wordt elke wijziging 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 informatie:

De volgende officiële 🔗 documentatie van de Verduistering kan helpen aan opstelling uw milieu:

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