AEM Developer Tools per Eclipse

Panoramica

AEM Developer Tools per Eclipse è un plug-in Eclipse basato sul plug-in Eclipse per Apache Sling rilasciato sotto la Licenza Apache 2.

Offre diverse funzioni che semplificano AEM sviluppo:

  • Integrazione perfetta con le istanze AEM tramite Eclipse Server Connector.
  • Sincronizzazione per i bundle OSGI e di contenuto.
  • Supporto del debug con funzionalità di hot-swap del codice.
  • Bootstrap semplice dei progetti AEM tramite una Creazione guidata progetto specifica.
  • Facile editing delle proprietà JCR.

Requisiti

Prima di utilizzare gli strumenti per sviluppatori AEM, è necessario:

  • Scarica e installa Eclipse IDE for Java EE Developers. AEM Developer Tools supporta attualmente Eclipse Kepler o versioni successive

  • Può essere utilizzato con AEM versione 5.6.1 o successiva

  • Configura l'installazione dell'eclissi per assicurarti di disporre di almeno 1 gigabyte di memoria heap modificando il file di configurazione eclipse.ini come descritto in Eclipse FAQ.

NOTA

Su macOS, è necessario fare clic con il pulsante destro del mouse su Eclipse.app e quindi selezionare Mostra contenuto pacchetto per trovare il eclipse.ini.

Come installare AEM Developer Tools per Eclipse

Una volta soddisfatti i requisiti di cui sopra, è possibile installare il plug-in come segue:

  1. Sfoglia il AEM sito Web Developer Tools.

  2. Copia il collegamento di installazione.

    In alternativa, puoi scaricare un archivio invece di utilizzare il collegamento di installazione. Questo consente l’installazione offline ma in questo modo le notifiche di aggiornamento automatico verranno perse.

  3. In Eclipse, apri il menu Help .

  4. Fare clic su Installa nuovo software.

  5. Fate clic su Aggiungi….

  6. In Name digitare AEM strumenti per sviluppatori.

  7. In Posizione copia l'URL di installazione.

  8. Fare clic su Ok.

  9. Controlla i plug-in AEM e Sling.

  10. Fai clic su Avanti.

  11. Fai clic su Avanti.

  12. Accettate i contratti di collegamento e fate clic su Fine.

  13. Fare clic su Sì per riavviare Eclipse.

Come importare progetti esistenti

NOTA

La prospettiva AEM

Gli strumenti di sviluppo AEM per Eclipse vengono forniti con una prospettiva che offre il pieno controllo sui progetti e le istanze AEM.

chlimage_1-2

Progetto Multi-Modulo di esempio

AEM Developer Tools per Eclipse viene fornito con un progetto campione con più moduli che consente di imparare rapidamente a usare una configurazione di progetto in Eclipse, oltre a fungere da guida pratica per diverse funzioni AEM. Ulteriori informazioni su Project Archetype.

Per creare il progetto di esempio, effettua le seguenti operazioni:

  1. Nel menu File > Nuovo > Progetto, passa alla sezione AEM e seleziona AEM Progetto modulo multiplo di esempio.

    chlimage_1-69

  2. Fai clic su Avanti.

    NOTA

    Questo passaggio potrebbe richiedere un po’ di tempo, dato che m2eclipse deve eseguire la scansione dei cataloghi archetype.

    chlimage_1-70

  3. Scegli com.adobe.granite.archetipi : sample-project-archetype : (numero più alto) dal menu, quindi fare clic su Avanti.

    chlimage_1-71

  4. Compila un Nome, ID gruppo e un ID elemento per il progetto di esempio. Puoi anche scegliere di impostare alcune proprietà avanzate.

    chlimage_1-72

  5. È quindi necessario configurare un server AEM a cui Eclipse si connetterà.

    Per utilizzare la funzione di debug, è necessario aver avviato AEM in modalità di debug, che può essere ottenuta, ad esempio, aggiungendo quanto segue alla riga di comando:

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

    chlimage_1-73

  6. Fare clic su Fine. Viene creata la struttura del progetto.

    NOTA

    Su un nuovo impianto (più precisamente: quando le dipendenze maven non sono mai state scaricate) puoi ottenere la creazione del progetto con errori. In questo caso, segui la procedura descritta in Risoluzione della definizione di progetto non valida.

Risoluzione dei problemi

Risoluzione della definizione del progetto non valida

Per risolvere le dipendenze non valide e la definizione del progetto procedere come segue:

  1. Seleziona tutti i progetti creati.
  2. Fai clic con il pulsante destro del mouse. Nel menu Maven seleziona Aggiorna progetti.
  3. Controllare Force Updates of Snapshot/Release.
  4. Fai clic su OK. Eclipse cerca di scaricare le dipendenze richieste.

Abilitazione del completamento automatico della libreria tag nei file JSP

Il completamento automatico della libreria di tag funziona automaticamente, dato che le dipendenze corrette vengono aggiunte al progetto. C'è un problema noto quando si utilizza il Jar Uber AEM, che non include i file tld e TagExtraInfo necessari.

Per aggirare questo problema, accertati che l’artefatto org.apache.sling.scripting.jsp.taglib sia situato nel percorso classico prima del Jar Uber AEM. Per i progetti Maven, inserisci la seguente dipendenza nel file pom.xml prima del file JAR Uber.

<dependency>
  <groupId>org.apache.sling</groupId>
  <artifactId>org.apache.sling.scripting.jsp.taglib</artifactId>
  <scope>provided</scope>
</dependency>

Assicurati di aggiungere la versione corretta per la distribuzione di AEM.

Ulteriori informazioni

Il sito web ufficiale Apache Sling IDE tooling for Eclipse fornisce informazioni utili:

La seguente documentazione ufficiale Eclipse può aiutare a configurare l'ambiente:

In questa pagina