Strumenti AEM Developer per Eclipse aem-developer-tools-for-eclipse
Panoramica overview
Experience Manager Developer Tools per Eclipse è un plug-in Eclipse basato sul plug-in Eclipse per Apache Sling rilasciato con la licenza Apache 2.
Offre diverse funzioni che facilitano lo sviluppo dell’AEM:
- Integrazione perfetta con le istanze AEM tramite il connettore server Eclipse
- Sincronizzazione per i bundle OSGi e per i contenuti
- Supporto del debug con funzionalità di hot-swapping del codice
- Bootstrap semplice di progetti AEM tramite una procedura guidata specifica per la creazione di progetti
- Facile modifica delle proprietà JCR
Requisiti requirements
Prima di utilizzare gli strumenti per sviluppatori di AEM, è necessario:
- Scarica e installa Eclipse IDE per sviluppatori Java™ Enterprise.
- Configura l'installazione di eclipse per assicurarti di disporre di almeno 1 GB di memoria heap modificando il file di configurazione
eclipse.ini
come descritto nelle Domande frequenti su Eclipse.
eclipse.ini
.Come installare gli strumenti per sviluppatori AEM per Eclipse how-to-install-the-aem-developer-tools-for-eclipse
Dopo aver soddisfatto i requisiti di cui sopra, puoi installare il plug-in come segue:
-
Copia il collegamento di installazione.
In alternativa, è possibile scaricare un archivio invece di utilizzare il collegamento di installazione. Questo metodo consente l'installazione offline, ma non si ricevono notifiche di aggiornamento automatico in questo modo.
-
In Eclipse aprire il menu Guida.
-
Fare clic su Installa nuovo software.
-
Fare clic su Aggiungi….
-
Nel campo Name, immetti
AEM Developer Tools
. -
Nel campo Posizione, copia l'URL di installazione.
-
Fare clic su Aggiungi.
-
Controlla entrambi i plug-in AEM e Sling.
-
Fai clic su Avanti.
-
Nella finestra Installa dettagli, fai di nuovo clic su Avanti.
-
Accettare i contratti di licenza e fare clic su Fine.
-
Fare clic su RiavviaOra per riavviare Eclipse.
La prospettiva dell'AEM the-aem-perspective
In Eclipse, una prospettiva determina le azioni e le viste disponibili all’interno di una finestra e consente un’interazione orientata alle attività con le risorse in Eclipse. Per ulteriori dettagli su Prospettiva, consulta la documentazione di Eclipse.
Gli strumenti di sviluppo Experience Manager per Eclipse forniscono una prospettiva AEM che offre il controllo completo sui progetti e sulle istanze AEM. Per aprire la prospettiva AEM:
- Dalla barra dei menu Eclipse, seleziona Finestra > Prospettiva > Apri prospettiva > Altro.
- Seleziona AEM nella finestra di dialogo e fai clic su Apri.
Esempio di progetto con più moduli sample-multi-module-project
Il Experience Manager Developer Tools per Eclipse viene fornito con un progetto di esempio, con più moduli, che consente di imparare rapidamente a utilizzare la configurazione di un progetto in Eclipse. Funge anche da guida alle best practice per diverse funzioni dell’AEM. Ulteriori informazioni su Archetipo progetto.
Per creare il progetto di esempio, segui la procedura riportata di seguito.
-
Nel menu File > Nuovo > Progetto, individua la sezione AEM e seleziona Progetto con più moduli AEM di esempio.
-
Fai clic su Avanti.
note note NOTE Questo passaggio potrebbe richiedere alcuni minuti perché m2eclipse deve eseguire la scansione dei cataloghi dell’archetipo. -
Scegli
com.adobe.granite.archetypes : sample-project-archetype : <highest-number>
dal menu, quindi fai clic su Avanti. -
Fornisci i campi seguenti per il progetto di esempio:
- Nome
- ID gruppo
- ID elemento
- appId - Potrebbe essere necessario espandere le opzioni Avanzate per impostare questo valore.
- appTitle - Potrebbe essere necessario espandere le opzioni Advanced per impostare questo valore.
- Pacchetto - Potrebbe essere necessario espandere le opzioni Avanzate per impostare questo valore.
-
Fai clic su Avanti.
-
Quindi configura un server AEM a cui si connette Eclipse.
Per utilizzare la funzione di debugger, è necessario aver avviato AEM in modalità di debug, ottenibile aggiungendo quanto segue alla riga di comando:
code language-text -nofork -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=10123
-
Fare clic su Fine. Viene creata la struttura del progetto.
note note NOTE In una nuova installazione (nello specifico, quando le dipendenze Maven non sono mai state scaricate) puoi creare il progetto con errori. In questo caso, seguire la procedura descritta in Risoluzione della definizione del progetto non valida.
Importare Progetti Esistenti how-to-import-existing-projects
È possibile utilizzare la funzionalità Nuovo progetto per creare la struttura corretta:
-
Segui le istruzioni per creare un progetto con più moduli di esempio e hai creato i seguenti progetti, che consentono una valida separazione dei problemi:
PROJECT.ui.apps
per il contenuto di/apps
e/etc
PROJECT.ui.content
per/content
creatoPROJECT.core
per bundle Java™ (diventano interessanti quando si desidera aggiungere codice Java™)PROJECT.it.launcher
ePROJECT.it.tests
per gli integration test
-
Sostituisci il contenuto del progetto
PROJECT.ui.apps
con le cartelleapps
eetc
del pacchetto:- Nel pannello Esplora progetti, apri
PROJECT.ui.apps
>src
>main
>content
>jcr_root
>apps
. - Fare clic con il pulsante destro del mouse sulla cartella
apps
e scegliere Mostra in > Esplora risorse. - Eliminare le cartelle
apps
eetc
da visualizzare e inserire qui le cartelleapps
eetc
del pacchetto di contenuti. - In Eclipse fare clic con il pulsante destro del mouse sul progetto
PROJECT.ui.apps
e scegliere Aggiorna.
- Nel pannello Esplora progetti, apri
-
Eseguire quindi le stesse operazioni per
PROJECT.ui.content
e sostituire la cartella dei contenuti con quella dei pacchetti:- Nel pannello Esplora progetti, apri
PROJECT.ui.content
>src
>main
>content
>jcr_root
>content
. - Fare clic con il pulsante destro del mouse sulla cartella dei contenuti più profondi e scegliere Mostra in > Esplora sistemi.
- Elimina la cartella dei contenuti da visualizzare e inserisci qui la cartella dei contenuti del pacchetto di contenuti.
- In Eclipse fare clic con il pulsante destro del mouse sul progetto
PROJECT.ui.content
e scegliere Aggiorna.
- Nel pannello Esplora progetti, apri
-
Ora è necessario aggiornare i file
filter.xml
di questi due progetti in modo che corrispondano al contenuto del pacchetto di contenuti. Per questo, apri il fileMETA-INF/vault/filter.xml
del pacchetto di contenuti in un editor di testo/codice separato.- Ecco un esempio di come può apparire il file
filter.xml
:
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>
- Ecco un esempio di come può apparire il file
-
Per quanto riguarda il contenuto del pacchetto diviso in due progetti, è necessario suddividere queste regole di filtro in due e aggiornare di conseguenza i file
filter.xml
dei due progetti.-
In Eclipse aprire
PROJECT.ui.apps/src/main/content/META-INF/filter.xml
. -
Sostituisci il contenuto dell'elemento
<workspaceFilter>
con le regole del pacchetto che iniziano con/apps
e/etc
-
Ad esempio:
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>
-
-
Quindi apri
PROJECT.ui.content/src/main/content/META-INF/filter.xml
. -
Sostituisci le regole con quelle del pacchetto che iniziano con
/content
.-
Ad esempio:
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>
-
-
-
Assicurati di salvare tutte le modifiche. Ora puoi sincronizzare il nuovo contenuto con l’istanza AEM.
-
Nel pannello Server, accertatevi che la connessione sia avviata e, in caso contrario, avviatela.
-
Fare clic sull'icona Pulisci e Publish.
Al termine, il pacchetto dovrebbe essere in esecuzione sull’istanza e, al momento del salvataggio, qualsiasi modifica viene sincronizzata automaticamente con l’istanza.
Se desideri ricreare un pacchetto dal progetto, fai clic con il pulsante destro del mouse su PROJECT.ui.apps
o PROJECT.ui.content
e scegli Esegui come > Installazione Maven.
È ora disponibile una cartella di destinazione creata con il pacchetto all'interno (denominata, ad esempio, PROJECT.ui.apps-0.0.1-SNAPSHOT.zip
).
Risoluzione dei problemi troubleshooting
Risoluzione di una definizione di progetto non valida resolving-invalid-project-definition
Per risolvere le dipendenze non valide e la definizione del progetto procedere come segue:
- Seleziona tutti i progetti creati.
- Fare clic con il pulsante destro del mouse.
- Nel menu di scelta rapida, seleziona Maven > Aggiorna progetti.
- Controlla Forza aggiornamenti di snapshot/release.
- Fai clic su OK.
Eclipse scarica le dipendenze richieste. L'operazione potrebbe richiedere alcuni minuti.
Ulteriori informazioni more-information
Il sito web ufficiale Apache Sling IDE tooling per Eclipse fornisce informazioni utili:
- La Guida utente di Apache Sling IDE tooling per Eclipse, questa documentazione ti guida attraverso i concetti generali, l'integrazione del server e le funzionalità di distribuzione supportate dagli strumenti di sviluppo AEM.
- La sezione Risoluzione dei problemi.
- Elenco dei problemi noti.
La seguente documentazione ufficiale di Eclipse può essere utile per configurare l'ambiente: