Strumenti AEM Developer per Eclipse aem-developer-tools-for-eclipse
Panoramica overview
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:
- 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 IDE Eclipse per sviluppatori Java™ Enterprise.
- Configurare l'installazione dell'eclissi per assicurarsi di disporre di almeno 1 GB di memoria heap modificando
eclipse.ini
file di configurazione come descritto in Domande frequenti su Eclipse.
eclipse.ini
.Come installare gli strumenti per sviluppatori AEM per Eclipse how-to-install-the-aem-developer-tools-for-eclipse
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.
-
Clic Aggiungi….
-
In Nome campo, immetti
AEM Developer Tools
. -
In Posizione , copiare l'URL di installazione.
-
Clic 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.
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, 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:
- Dalla barra dei menu di Eclipse, seleziona Finestra > Prospettiva > Prospettiva aperta > Altro.
- Seleziona AEM nella finestra di dialogo e fai clic su Apri.
Esempio di progetto con più moduli sample-multi-module-project
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.
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 Successivo. -
Fornisci i campi seguenti per il progetto di esempio:
- Nome
- ID gruppo
- ID artefatto
- appId - Potrebbe essere necessario espandere Avanzate per impostare questo valore.
- appTitle - Potrebbe essere necessario espandere Avanzate per impostare questo valore.
- Pacchetto - Potrebbe essere necessario espandere 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
-
Clic 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 di una definizione di progetto non valida.
Importare Progetti Esistenti how-to-import-existing-projects
È 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
ePROJECT.it.tests
per i test di integrazione
-
Sostituisci il contenuto della
PROJECT.ui.apps
progetto conapps
eetc
cartelle del pacchetto:- Nel pannello Esplora progetti, apri
PROJECT.ui.apps
>src
>main
>content
>jcr_root
>apps
. - Fare clic con il pulsante destro del mouse
apps
cartella e scegli Mostra in > Esplora sistema. - Elimina
apps
eetc
cartelle che ora dovresti visualizzare e inserire qui leapps
eetc
cartelle del pacchetto di contenuti. - In Eclipse, fai clic con il pulsante destro del mouse su
PROJECT.ui.apps
progetto e scelta Aggiorna.
- Nel pannello Esplora progetti, apri
-
Quindi fai lo stesso per
PROJECT.ui.content
e sostituisci la cartella dei contenuti con uno dei pacchetti:- Nel pannello Esplora progetti, apri
PROJECT.ui.content
>src
>main
>content
>jcr_root
>content
. - Fai clic con il pulsante destro del mouse sulla cartella dei contenuti più profondi e scegli Mostra in > Esplora sistema.
- Elimina la cartella dei contenuti da visualizzare e inserisci qui la cartella dei contenuti del pacchetto di contenuti.
- In Eclipse, fai clic con il pulsante destro del mouse su
PROJECT.ui.content
progetto e scelta Aggiorna.
- Nel pannello Esplora progetti, apri
-
Ora è necessario aggiornare
filter.xml
i file di questi due progetti in modo che corrispondano al contenuto del pacchetto di contenuti. Per questo, apri ilMETA-INF/vault/filter.xml
del pacchetto di contenuti in un editor di testo/codice separato.- Questo è un esempio di come
filter.xml
il file può avere un aspetto simile a:
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>
- Questo è un esempio di come
-
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
-
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.
-
Fai clic su 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 su 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
).
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, selezionare Maven > Aggiorna Progetti.
- Verifica 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:
- Il Strumenti IDE Apache Sling per Eclipse Guida utente, questa documentazione descrive i concetti generali, l’integrazione dei server e le funzionalità di implementazione supportate dagli strumenti di sviluppo AEM.
- Il Sezione Risoluzione dei problemi.
- Il Elenco dei problemi noti.
Il seguente funzionario Eclipse La documentazione di può essere utile per configurare l’ambiente: