AEM Developer Tools per Eclipse è un plug-in Eclipse basato su Plug-in Eclipse per Apache Sling rilasciato sotto la Licenza Apache 2.
Offre diverse funzioni che semplificano AEM sviluppo:
Prima di utilizzare gli strumenti per sviluppatori AEM, è necessario:
eclipse.ini
file di configurazione come descritto in Domande frequenti su Eclipse.Su macOS, è necessario fare clic con il pulsante destro del mouse su Eclipse.app quindi seleziona Mostra contenuto del pacchetto per trovare il eclipse.ini
.
Una volta realizzato il requisiti sopra, è possibile installare il plug-in come segue:
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.
In Eclipse, apri la Aiuto menu.
Fai clic su Installazione di un nuovo software.
Fate clic su Aggiungi….
In Nome enter AEM Developer Tools
.
In Posizione copia l’URL di installazione.
Fate clic su Aggiungi.
Controlla entrambi AEM e Sling plugin.
Fai clic su Avanti.
In Dettagli di installazione finestra, fai clic su Successivo di nuovo.
Accettare i contratti di licenza e fare clic su Fine.
Fai clic su RestartNow per riavviare Eclipse.
In Eclipse una prospettiva determina le azioni e le visualizzazioni disponibili all’interno di una finestra e abilita l’interazione orientata alle attività con le risorse in Eclipse. Per ulteriori dettagli sulla prospettiva, consulta la sezione Documentazione Eclipse.
Gli strumenti di sviluppo AEM per Eclipse forniscono una prospettiva AEM che offre il pieno controllo sui progetti e le istanze AEM. Per aprire la prospettiva AEM:
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:
In File > Nuovo > Progetto menu, passare alla AEM e seleziona Progetto AEM modulo multiplo di esempio.
Fai clic su Avanti.
Questo passaggio potrebbe richiedere un momento perché m2eclipse deve scansionare i cataloghi archetipo.
Scegli com.adobe.granite.archetypes : sample-project-archetype : <highest-number>
dal menu , quindi fai clic su Successivo.
Fornisci i campi seguenti per il progetto di esempio:
Fai clic su Avanti.
Quindi configura 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
Fai clic su Fine. Viene creata la struttura del progetto.
In una nuova installazione (in particolare, quando le dipendenze maven non sono mai state scaricate) il progetto potrebbe essere creato con errori. In questo caso si prega di seguire la procedura descritta in Risoluzione della definizione del progetto non valida.
È possibile utilizzare Nuovo progetto per creare la struttura corretta:
Segui le istruzioni per creare un Esempio di progetto con più moduli e avrete i seguenti progetti creati per voi, che permetterà una sana separazione dei problemi:
PROJECT.ui.apps
per /apps
e /etc
contentPROJECT.ui.content
per /content
creatoPROJECT.core
per i bundle Java (questi diventeranno interessanti non appena si desidera aggiungere il codice Java)PROJECT.it.launcher
e PROJECT.it.tests
per test di integrazioneSostituire il contenuto del PROJECT.ui.apps
con apps
e etc
cartelle del pacchetto:
PROJECT.ui.apps
> src
> main
> content
> jcr_root
> apps
.apps
e scegli Mostra in > Esplora sistema.apps
e etc
cartelle da visualizzare e posizionare qui le apps
e etc
cartelle del pacchetto di contenuti.PROJECT.ui.apps
progetto e scegli Aggiorna.Quindi fai lo stesso per il PROJECT.ui.content
e sostituisci la relativa cartella di contenuto con quella del pacchetto:
PROJECT.ui.content
> src
> main
> content
> jcr_root
> content
.PROJECT.ui.content
progetto e scegli Aggiorna.Ora è necessario aggiornare il filter.xml
i file di questi due progetti devono corrispondere al contenuto del pacchetto di contenuti. Per questo, apri la META-INF/vault/filter.xml
file del pacchetto di contenuti in un editor di testo/codice separato.
filter.xml
file può cercare:<?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>
Per quanto riguarda il contenuto del pacchetto diviso in due progetti, dovrai anche dividere queste regole di filtro in due e aggiornare di conseguenza il filter.xml
i file dei due progetti.
In Eclipse, apri PROJECT.ui.apps/src/main/content/META-INF/filter.xml
.
Sostituire il contenuto della <workspaceFilter>
con le regole del pacchetto che iniziano con /apps
e /etc
Ad esempio:
<?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:
<?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 , assicurati che la connessione sia avviata e, in caso contrario, avviala.
Fai clic sul pulsante Pulisci e pubblica icona.
Al termine, il pacchetto dovrebbe essere in esecuzione sull'istanza e al momento del salvataggio, qualsiasi modifica viene automaticamente sincronizzata con l'istanza.
Per ricreare un pacchetto dal progetto, fai clic con il pulsante destro del mouse sul PROJECT.ui.apps
o PROJECT.ui.content
e scegli Esegui come -> Installazione Maven.
Ora disponi di una cartella di destinazione creata con il pacchetto all’interno di (ad es. PROJECT.ui.apps-0.0.1-SNAPSHOT.zip
).
Per risolvere le dipendenze non valide e la definizione del progetto procedere come segue:
Eclipse scarica le dipendenze richieste. Questo può richiedere un momento.
Il sito web ufficiale Apache Sling IDE tooling for Eclipse fornisce informazioni utili:
funzionario Eclipse può essere utile per configurare l’ambiente: