Strumenti AEM Developer per Eclipse aem-developer-tools-for-eclipse

Strumenti per sviluppatori Experienci Manager per il logo 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:

NOTE
In macOS, è necessario fare clic con il pulsante destro del mouse su Eclipse.app, quindi selezionare Mostra contenuto pacchetto per trovare 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:

  1. Apri il sito Web degli strumenti per sviluppatori AEM.

  2. 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.

  3. In Eclipse aprire il menu Guida.

  4. Fare clic su Installa nuovo software.

  5. Fare clic su Aggiungi….

  6. Nel campo Name, immetti AEM Developer Tools.

  7. Nel campo Posizione, copia l'URL di installazione.

  8. Fare clic su Aggiungi.

  9. Controlla entrambi i plug-in AEM e Sling.

  10. Fai clic su Avanti.

  11. Nella finestra Installa dettagli, fai di nuovo clic su Avanti.

  12. Accettare i contratti di licenza e fare clic su Fine.

  13. 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:

  1. Dalla barra dei menu Eclipse, seleziona Finestra > Prospettiva > Apri prospettiva > Altro.
  2. Seleziona AEM nella finestra di dialogo e fai clic su Apri.

La prospettiva dellAEM in Eclipse

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.

  1. Nel menu File > Nuovo > Progetto, individua la sezione AEM e seleziona Progetto con più moduli AEM di esempio.

    Esempio di progetto con più moduli AEM

  2. Fai clic su Avanti.

    note note
    NOTE
    Questo passaggio potrebbe richiedere alcuni minuti perché m2eclipse deve eseguire la scansione dei cataloghi dell’archetipo.
  3. Scegli com.adobe.granite.archetypes : sample-project-archetype : <highest-number> dal menu, quindi fai clic su Avanti.

    Seleziona la versione dellarchetipo

  4. 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.

    Definire le proprietà dellarchetipo

  5. Fai clic su Avanti.

  6. 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
    

    Connessione al server AEM

  7. 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:

  1. 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 creato
    • PROJECT.core per bundle Java™ (diventano interessanti quando si desidera aggiungere codice Java™)
    • PROJECT.it.launcher e PROJECT.it.tests per gli integration test
  2. Sostituisci il contenuto del progetto PROJECT.ui.apps con le cartelle apps e etc del pacchetto:

    1. Nel pannello Esplora progetti, apri PROJECT.ui.apps > src > main > content > jcr_root > apps.
    2. Fare clic con il pulsante destro del mouse sulla cartella apps e scegliere Mostra in > Esplora risorse.
    3. Eliminare le cartelle apps e etc da visualizzare e inserire qui le cartelle apps e etc del pacchetto di contenuti.
    4. In Eclipse fare clic con il pulsante destro del mouse sul progetto PROJECT.ui.apps e scegliere Aggiorna.
  3. Eseguire quindi le stesse operazioni per PROJECT.ui.content e sostituire la cartella dei contenuti con quella dei pacchetti:

    1. Nel pannello Esplora progetti, apri PROJECT.ui.content > src > main > content > jcr_root > content.
    2. Fare clic con il pulsante destro del mouse sulla cartella dei contenuti più profondi e scegliere Mostra in > Esplora sistemi.
    3. Elimina la cartella dei contenuti da visualizzare e inserisci qui la cartella dei contenuti del pacchetto di contenuti.
    4. In Eclipse fare clic con il pulsante destro del mouse sul progetto PROJECT.ui.content e scegliere Aggiorna.
  4. 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 file META-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>
    
  5. 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.

    1. In Eclipse aprire PROJECT.ui.apps/src/main/content/META-INF/filter.xml.

    2. 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>
        
    3. Quindi apri PROJECT.ui.content/src/main/content/META-INF/filter.xml.

    4. 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>
        
  6. Assicurati di salvare tutte le modifiche. Ora puoi sincronizzare il nuovo contenuto con l’istanza AEM.

  7. Nel pannello Server, accertatevi che la connessione sia avviata e, in caso contrario, avviatela.

  8. 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:

  1. Seleziona tutti i progetti creati.
  2. Fare clic con il pulsante destro del mouse.
  3. Nel menu di scelta rapida, seleziona Maven > Aggiorna progetti.
  4. Controlla Forza aggiornamenti di snapshot/release.
  5. 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 seguente documentazione ufficiale di Eclipse può essere utile per configurare l'ambiente:

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab