Strumenti per sviluppatori Experience Manager per Eclipse è un plug-in Eclipse basato su Plug-in Eclipse per Apache Sling rilasciata con la Licenza Apache 2.
Offre diverse funzioni che facilitano lo sviluppo dell’AEM:
Prima di utilizzare gli strumenti per sviluppatori di AEM, è necessario:
eclipse.ini
file di configurazione come descritto in Domande frequenti su Eclipse.In macOS, è necessario fare clic con il pulsante destro del mouse su Eclipse.app e quindi seleziona Mostra contenuto pacchetto per trovare il tuo eclipse.ini
.
Quando hai soddisfatto il requisiti sopra, è possibile 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, apri il file Aiuto menu.
Clic Installare un nuovo software.
Fate clic su Aggiungi….
In Nome campo, immetti AEM Developer Tools
.
In Posizione , copiare l'URL di installazione.
Fate clic su Aggiungi.
Controlla entrambi AEM e Sling plug-in.
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.
Clic RestartNow per riavviare Eclipse.
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, vedi Documentazione di Eclipse.
Strumenti di sviluppo Experience Manager per Eclipse fornisci una Prospettiva AEM che ti offra il pieno controllo sui tuoi progetti e istanze AEM. Per aprire la prospettiva AEM:
Il Strumenti per sviluppatori Experience Manager per Eclipse viene fornito con 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 funzioni dell’AEM. Ulteriori informazioni su Archetipo progetto.
Per creare il progetto di esempio, segui la procedura riportata di seguito.
In File > Nuovo > Progetto , passare al menu AEM sezione e seleziona Esempio di progetto con più moduli AEM.
Fai clic su Avanti.
Questo passaggio potrebbe richiedere un attimo perché m2eclipse deve scansionare i cataloghi dell’archetipo.
Scegli com.adobe.granite.archetypes : sample-project-archetype : <highest-number>
dal menu, quindi fai clic su Successivo.
Fornisci i seguenti campi per il progetto di esempio:
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:
-nofork -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=10123
Clic Fine. Viene creata la struttura del progetto.
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 di una definizione di progetto non valida.
È possibile utilizzare Nuovo progetto funzione per creare la struttura adatta alle tue esigenze:
Segui le istruzioni per creare una Esempio di progetto con più moduli e hai creato i seguenti progetti, che permettono una sana separazione delle preoccupazioni:
PROJECT.ui.apps
per /apps
e /etc
contenutoPROJECT.ui.content
per /content
che è stato creatoPROJECT.core
per i bundle Java™ (che diventano interessanti quando si desidera aggiungere codice Java™)PROJECT.it.launcher
e PROJECT.it.tests
per i test di integrazioneSostituisci il contenuto della PROJECT.ui.apps
progetto con apps
e etc
cartelle del pacchetto:
PROJECT.ui.apps
> src
> main
> content
> jcr_root
> apps
.apps
cartella e scegli Mostra in > Esplora sistema.apps
e etc
cartelle che ora dovresti visualizzare e inserire qui le apps
e etc
cartelle del pacchetto di contenuti.PROJECT.ui.apps
progetto e scelta Aggiorna.Quindi fai lo stesso per PROJECT.ui.content
e sostituisci la cartella dei contenuti con uno dei pacchetti:
PROJECT.ui.content
> src
> main
> content
> jcr_root
> content
.PROJECT.ui.content
progetto e scelta Aggiorna.Ora è necessario aggiornare filter.xml
i file di questi due progetti in modo che corrispondano al contenuto del pacchetto di contenuti. Per questo, apri il META-INF/vault/filter.xml
del pacchetto di contenuti in un editor di testo/codice separato.
filter.xml
il file può avere un aspetto simile a:<?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, devi anche dividere queste regole di filtro in due e aggiornare di conseguenza filter.xml
file dei due progetti.
In Eclipse, apri PROJECT.ui.apps/src/main/content/META-INF/filter.xml
.
Sostituisci il contenuto della <workspaceFilter>
con le regole del pacchetto che iniziano con /apps
e /etc
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
.
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, accertatevi che la connessione sia avviata e, in caso contrario, avviatela.
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 sincronizzata automaticamente con l’istanza.
Se desideri ricreare un pacchetto dal progetto, fai clic con il pulsante destro del mouse sulla 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 (denominata, ad esempio 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. L'operazione potrebbe richiedere alcuni minuti.
Il sito web ufficiale Apache Sling IDE tooling per Eclipse fornisce informazioni utili:
Il seguente funzionario Eclipse La documentazione di può essere utile per configurare l’ambiente: