AEM Developer Tools for Eclipse

Panoramica

AEM Developer Tools for Eclipse è un plugin Eclipse basato sul plugin Eclipse per Apache Sling rilasciato sotto la licenza Apache 2.

Offre diverse funzioni che semplificano AEM sviluppo:

• Integrazione perfetta con AEM istanze tramite Eclipse Server Connector.
• Sincronizzazione sia per il contenuto che per i bundle OSGI.
• Supporto per il debug con funzionalità di swaping del codice.
• Avvio semplice di AEM progetti tramite una procedura guidata specifica per la creazione di progetti.
• Facile modifica delle proprietà JCR.

Requisiti

Prima di utilizzare gli AEM Developer Tools, è necessario:

• Scaricate e installate Eclipse IDE per sviluppatori Java EE. AEM Developer Tools supporta attualmente Eclipse Kepler o versioni successive

• Può essere utilizzato con AEM versione 5.6.1 o successiva

• Configurate l'installazione dell'eclisse per garantire che vi siano almeno 1 gigabyte di memoria heap modificando il file di configurazione eclipse.ini come descritto nelle Domande frequenti su Eclipse.

Come installare AEM Developer Tools per Eclipse

Una volta soddisfatti i requisiti sopra, potete installare il plug-in come segue:

1. Sfogliate il AEM sito Web Developer Tools.

2. Copiare il collegamento di installazione.

   In alternativa potete scaricare un archivio invece di utilizzare il collegamento di installazione. Questo consente l'installazione offline, ma in questo modo non riceverete notifiche di aggiornamento automatiche.

3. In Eclipse, aprire 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 copiare l'URL di installazione.

8. Fare clic su Ok.

9. Controllare i plug-in AEM e Sling.

10. Fai clic su Avanti.

11. Fai clic su Avanti.

12. Accettate gli accordi di collegamento e fate clic su Fine.

13. Fare clic su Sì per riavviare Eclipse.

Come importare progetti esistenti

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.

Esempio di progetto multi-modulo

AEM Developer Tools for Eclipse è dotato di un progetto multivodulo di esempio che consente di acquisire rapidamente la massima velocità grazie alla configurazione di un progetto in Eclipse, oltre a fungere da guida best practice per diverse funzioni AEM. Ulteriori informazioni su Project Archetype.

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

1. Nel menu File > New > Project, passare alla sezione AEM e selezionare AEM Sample Multi-Module Project.

   

2. Fai clic su Avanti.

   NOTA

   Questo passaggio potrebbe richiedere un po' perché m2eclipse deve eseguire la scansione dei cataloghi archetype.

   

3. Scegliere com.adobe.granite.archetypes : sample-project-archetype : (numero più alto) dal menu, quindi fare clic su Next.

   

4. Compilate un Nome, ID gruppo e un ID artifact per il progetto di esempio. Potete anche scegliere di impostare alcune proprietà avanzate.

   

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

   Per utilizzare la funzione Debugger, è necessario aver avviato AEM in modalità 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
   

   

6. Fare clic su Fine. La struttura del progetto viene creata.

   NOTA

   Per una nuova installazione (più precisamente: quando non sono mai state scaricate le dipendenze morali) è possibile che il progetto venga creato con degli errori. In questo caso, seguire la procedura descritta in Risoluzione della definizione di progetto non valida.

Risoluzione dei problemi

Risoluzione della definizione di progetto non valida

Per risolvere dipendenze non valide e definire il progetto, procedere come segue:

1. Seleziona tutti i progetti creati.
2. Fare clic con il pulsante destro del mouse. Nel menu Maven selezionare Aggiorna progetti.
3. Selezionare Forza aggiornamenti di snapshot/release.
4. Fai clic su OK. Eclipse tenta di scaricare le dipendenze richieste.

Abilitazione del completamento automatico della libreria di tag nei file JSP

Il completamento automatico della libreria di tag non è disponibile, in quanto al progetto vengono aggiunte le dipendenze corrette. Esiste un problema noto quando si utilizza la AEM Jar Uber, che non include i file tld e TagExtraInfo necessari.

Per aggirare il problema, accertati che l'artifact org.apache.sling.scripting.jsp.taglib sia posizionato nel percorso di classe prima della AEM Uber Jar. Per i progetti Maven, posizionate la seguente dipendenza nel file pom.xml prima del file Uber Jar.

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

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

Ulteriori informazioni

Il sito ufficiale Apache Sling IDE tooltool per Eclipse fornisce informazioni utili:

• La Apache Sling IDE tooling for Eclipse User Guide, questa documentazione vi guiderà attraverso i concetti generali, l'integrazione dei server e le funzionalità di implementazione supportate dagli strumenti di sviluppo AEM.
• La sezione Risoluzione dei problemi.
• Elenco Problemi noti.

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

• Guida introduttiva ad Eclipse
• Eclipse Luna Help System
• Integrazione di Maven (m2eclipse)