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

Experience Manager Developer Tools for Eclipse-logo

Overzicht overview

Experience Manager Developer Tools for Eclipse is een Eclipse-insteekmodule op basis van de Eclipse-insteekmodule voor Apache Sling vrijgegeven onder de Apache-licentie 2.

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
In macOS moet u met de rechtermuisknop klikken Eclipse.app en selecteer vervolgens Toon de Inhoud van het Pakket om uw eclipse.ini.

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 vereisten hierboven kunt u de plug-in als volgt installeren:

  1. Open de Website AEM Developer Tools.

  2. De Installatiekoppeling.

    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. Open in Eclipse de Help -menu.

  4. Klikken Nieuwe software installeren.

  5. Klikken Toevoegen….

  6. In de Naam veld, Enter AEM Developer Tools.

  7. In de Locatie , kopieert u de installatie-URL.

  8. Klikken Toevoegen.

  9. Beide controleren AEM en Sling plug-ins.

  10. Klik op Next.

  11. In de Details installeren venster, klikt u op Volgende opnieuw.

  12. Accepteer de licentieovereenkomsten en klik op Voltooien.

  13. Klikken Opnieuw startenNu om Eclipse opnieuw te starten.

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. Zie voor meer informatie over Perspectief de Eclipse-documentatie.

Experience Manager Development Tools for Eclipse Geef een AEM perspectief dat u volledige controle over uw AEM Projecten en instanties biedt. Het AEM perspectief openen:

  1. Selecteer in de menubalk Eclipse de optie Venster > Perspectief > Perspectief openen > Overige.
  2. Selecteren AEM in het dialoogvenster en klik op Openen.

Het AEM perspectief in Eclipse

Monster nemen van meermoduleproject sample-multi-module-project

De Experience Manager Developer Tools for Eclipse komt met een steekproef, multi-moduleproject dat u snel met een projectopstelling in Verduistering helpt te versnellen. Het dient ook als gids voor beste praktijken aan verscheidene AEM eigenschappen. Meer informatie over de projectarchetype.

Ga als volgt te werk om het voorbeeldproject te maken:

  1. In de Bestand > Nieuw > Project , bladert u naar de AEM en selecteert u AEM Monster nemen van meermoduleproject.

    AEM Monster nemen van meermoduleproject

  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> in het menu en klik vervolgens op Volgende.

    Versie van archetype selecteren

  4. Geef de volgende velden op voor het voorbeeldproject:

    • Naam
    • Groep-id
    • Artefact-id
    • appId - Het kan nodig zijn om de Geavanceerd opties om deze waarde in te stellen.
    • appTitle - Het kan nodig zijn om de Geavanceerd opties om deze waarde in te stellen.
    • Pakket - Het kan nodig zijn om de Geavanceerd opties om deze waarde in te stellen.

    Eigenschappen archetype definiëren

  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
    

    Verbinding maken met AEM server

  7. Klikken Voltooien. 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 volgt u de in Ongeldige projectdefinitie oplossen.

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

U kunt de Nieuw project functie om de juiste structuur voor u te maken:

  1. Volg de instructies om een Monster nemen van meermoduleproject en u hebt de volgende projecten gecreeerd voor u, die een gezonde scheiding van zorgen toelaten:

    • PROJECT.ui.apps for /apps en /etc content
    • PROJECT.ui.content for /content die is gemaakt
    • PROJECT.core voor Java™-pakketten (deze worden interessant wanneer u Java™-code wilt toevoegen)
    • PROJECT.it.launcher en PROJECT.it.tests voor integratietests
  2. Vervang de inhoud van uw PROJECT.ui.apps met de apps en etc mappen van het pakket:

    1. In het paneel van de Ontdekkingsreiziger van het Project, ontvouw PROJECT.ui.apps > src > main > content > jcr_root > apps.
    2. Klik met de rechtermuisknop op de knop apps map en kies Tonen in > Systeemverkenner.
    3. Verwijder de apps en etc mappen die u nu moet zien en hier plaatsen apps en etc mappen van het inhoudspakket.
    4. Klik in Eclipse met de rechtermuisknop op de knop PROJECT.ui.apps project en kies Vernieuwen.
  3. Doe dan het zelfde voor PROJECT.ui.content en vervang de inhoudsmap door een van de pakketten:

    1. In het paneel van de Ontdekkingsreiziger van het Project, ontvouw PROJECT.ui.content > src > main > content > jcr_root > content.
    2. Klik met de rechtermuisknop op de diepere inhoudsmap en kies Tonen in > Systeemverkenner.
    3. Verwijder de inhoudsmap die u nu moet zien en plaats hier de inhoudsmap van het inhoudspakket.
    4. Klik in Eclipse met de rechtermuisknop op de knop PROJECT.ui.content project en kies Vernieuwen.
  4. Nu moet u de filter.xml De bestanden van deze twee projecten komen overeen met de inhoud van het inhoudspakket. Open daarvoor de 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 kan er uitzien:
    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 dienovereenkomstig bijwerken filter.xml bestanden van de twee projecten.

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

    2. De inhoud van de <workspaceFilter> element met de regels van uw pakket waarmee begint /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. Vervolgens openen PROJECT.ui.content/src/main/content/META-INF/filter.xml.

    4. Vervang de regels door de regels in het pakket waarmee u begint /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 op de knop Reinigen en publiceren 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 opnieuw bouwen, klik met de rechtermuisknop aan PROJECT.ui.apps of PROJECT.ui.content en kiest u Uitvoeren als > Maven Install.

Er is nu een doelmap gemaakt met het pakket in de map (bijvoorbeeld PROJECT.ui.apps-0.0.1-SNAPSHOT.zip).

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. Selecteer in het contextmenu Maven > Projecten bijwerken.
  4. Controleren Updates van momentopname/releases forceren.
  5. Klikken 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 ambtenaar Eclipse documentatie kan u helpen uw omgeving in te stellen:

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