Strumenti per sviluppatori AEM 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 di AEM:
- Integrazione perfetta con le istanze di 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
- Creazione guidata progetto: semplice Bootstrap di progetti AEM
- Facile modifica delle proprietà JCR
Requisiti requirements
Prima di utilizzare gli strumenti per sviluppatori di AEM, è necessario:
- Scarica e installa Eclipse IDE per Enterprise Java e Web Developers.
- La versione 1.4.0 di AEM Developer Tools per Eclipse è compatibile con Eclipse 2022-12 (4.26) o versione successiva e richiede Java 17 o versione successiva per l’esecuzione.
- Configurare l'installazione di Eclipse per assicurarsi 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
.Installare AEM Developer Tools per Eclipse how-to-install-the-aem-developer-tools-for-eclipse
Dopo aver soddisfatto i requisiti di cui sopra, puoi installare il plug-in degli strumenti per sviluppatori come segue:
-
Apri il sito Web degli strumenti per sviluppatori di AEM.
-
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 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.
-
Fai clic su Aggiungi.
-
Controlla entrambi i plug-in AEM e Sling.
-
Fai clic su Avanti.
-
Nella finestra Dettagli installazione, controlla gli elementi da installare e fai di nuovo clic su Avanti.
-
Accettare i contratti di licenza e fare clic su Fine.
-
Nella finestra di dialogo Autorità di attendibilità visualizzata, selezionare l'autorità o il sito
https://eclipse.adobe.com
e fare clic su Considera attendibili selezionati. -
Nella finestra di dialogo Artifact attendibili visualizzata, selezionare i firmatari del codice e fare clic su Considera attendibili gli elementi selezionati.
-
Fare clic su RiavviaOra per riavviare Eclipse.
La prospettiva di AEM the-aem-perspective
In Eclipse, una prospettiva determina le azioni e le visualizzazioni disponibili all'interno di una finestra e consente l'interazione orientata alle attività con le risorse in Eclipse. Per ulteriori dettagli sulle prospettive, consulta la documentazione di Eclipse..
Gli strumenti di sviluppo Experience Manager per Eclipse forniscono una prospettiva AEM che ti offre il controllo completo sui tuoi progetti e istanze AEM. Per aprire la prospettiva di 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
Gli strumenti per sviluppatori Experience Manager per Eclipse includono un esempio di progetto con più moduli che ti consente di imparare rapidamente a utilizzare la configurazione di un progetto in Eclipse. Funge anche da guida alle best practice per diverse funzionalità di AEM, sfruttando il Archetipo progetto AEM.
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 di esempio AEM.
-
Fai clic su Avanti.
note note NOTE Questo passaggio potrebbe richiedere alcuni minuti perché m2eclipse deve analizzare i cataloghi dell'archetipo. -
Selezionare automaticamente
com.adobe.aem : aem-project-archetype : <highest-number>
nel menu a discesa Archetipo. Se necessario, seleziona una versione precedente. 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.
-
Configurare un server AEM al quale Eclipse si connette selezionando Imposta nuovo server e fornendo un nome server e i dettagli di connessione necessari.
- Per utilizzare la funzione di debugger, è necessario avviare AEM in modalità di debug fornendo il parametro
-agentlib
, ad esempio:
code language-text $ java -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=*:5005 -jar aem-author-p4502.jar
note tip TIP Per ulteriori dettagli sul debug del progetto in esecuzione su un SDK AEM locale, consulta il documento Debug remoto di AEM SDK. - Per utilizzare la funzione di debugger, è necessario avviare AEM in modalità di debug fornendo il parametro
-
Fai clic su Fine.
Viene creata la struttura del progetto. Il download degli artefatti necessari nel progetto potrebbe richiedere del tempo.
Importare Progetti Esistenti how-to-import-existing-projects
Utilizza la funzionalità Nuovo progetto per creare la struttura di progetto di base.
-
Segui le istruzioni per creare un progetto con più moduli di esempio, che crea una struttura di progetto di base con una valida separazione dei problemi:
PROJECT.ui.apps
per il contenuto di/apps
e/etc
PROJECT.ui.content
per/content
creatoPROJECT.core
per bundle JavaPROJECT.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 Project Explorer, espandere
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
. - Nella stessa posizione, inserire le cartelle
apps
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 Project Explorer, espandere
-
Eseguire quindi le stesse operazioni per
PROJECT.ui.content
e sostituire la cartella dei contenuti con quella dei pacchetti:- Nel pannello Project Explorer, espandere
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.
- Nella stessa posizione, inserisci la cartella del contenuto del pacchetto di contenuti.
- In Eclipse fare clic con il pulsante destro del mouse sul progetto
PROJECT.ui.content
e scegliere Aggiorna.
- Nel pannello Project Explorer, espandere
-
Aggiorna i file
filter.xml
di questi due progetti in modo che corrispondano al contenuto del pacchetto di contenuti aprendo 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 che è stato diviso in due progetti, è inoltre necessario dividere 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 di AEM.
-
Nel pannello Server, assicurati che la connessione sia avviata e, in caso contrario, non avviarla.
-
Fai clic sull'icona Pulisci e pubblica.
Al termine, il pacchetto dovrebbe essere in esecuzione sull’istanza. 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 di 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 utili informazioni aggiuntive:
- La Guida utente di Apache Sling IDE per Eclipse ti guida attraverso i concetti generali, l'integrazione del server e le funzionalità di distribuzione supportate dagli strumenti di sviluppo di AEM.
- Risoluzione dei problemi relativi agli strumenti IDE di Apache Sling
- Elenco dei problemi noti
La seguente documentazione ufficiale di Eclipse può essere utile per configurare l'ambiente: