Strumenti AEM Developer per Eclipse

Ultimo aggiornamento: 2023-12-05

Logo Experience Manager Developer Tools per Eclipse

Panoramica

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

Prima di utilizzare gli strumenti per sviluppatori di AEM, è necessario:

NOTA

In macOS, è necessario fare clic con il pulsante destro del mouse Eclipse.app e quindi selezionare Mostra contenuto pacchetto per trovare eclipse.ini.

Come installare gli strumenti per sviluppatori AEM per Eclipse

Quando hai soddisfatto il requisiti sopra, è possibile installare il plug-in come segue:

  1. Apri 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, apri il file Aiuto menu.

  4. Clic Installare un nuovo software.

  5. Clic Aggiungi….

  6. In Nome campo, immetti AEM Developer Tools.

  7. In Posizione , copiare l'URL di installazione.

  8. Clic Aggiungi.

  9. Controlla entrambi AEM e Sling plug-in.

  10. Fai clic su Avanti.

  11. In Dettagli di installazione finestra, fai clic su Successivo di nuovo.

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

  13. Clic RestartNow per riavviare Eclipse.

La prospettiva dell'AEM

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:

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

La prospettiva AEM in Eclipse

Esempio di progetto con più moduli

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.

  1. In File > Nuovo > Progetto , passare al menu AEM sezione e seleziona Esempio di progetto con più moduli AEM.

    Esempio di progetto con più moduli AEM

  2. Fai clic su Avanti.

    NOTA

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

    Seleziona la versione dell’archetipo

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

    Definire le proprietà dell’archetipo

  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:

        -nofork -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=10123
    

    Connettersi al server AEM

  7. Clic Fine. Viene creata la struttura del progetto.

    NOTA

    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

È possibile utilizzare Nuovo progetto funzione per creare la struttura adatta alle tue esigenze:

  1. 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 contenuto
    • PROJECT.ui.content per /content che è stato creato
    • PROJECT.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 integrazione
  2. Sostituisci il contenuto della PROJECT.ui.apps progetto con apps e etc cartelle 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 apps cartella e scegli Mostra in > Esplora sistema.
    3. Elimina apps e etc cartelle che ora dovresti visualizzare e inserire qui le apps e etc cartelle del pacchetto di contenuti.
    4. In Eclipse, fai clic con il pulsante destro del mouse su PROJECT.ui.apps progetto e scelta Aggiorna.
  3. Quindi fai lo stesso per PROJECT.ui.content e sostituisci la cartella dei contenuti con uno dei pacchetti:

    1. Nel pannello Esplora progetti, apri PROJECT.ui.content > src > main > content > jcr_root > content.
    2. Fai clic con il pulsante destro del mouse sulla cartella dei contenuti più profondi e scegli Mostra in > Esplora sistema.
    3. Elimina la cartella dei contenuti da visualizzare e inserisci qui la cartella dei contenuti del pacchetto di contenuti.
    4. In Eclipse, fai clic con il pulsante destro del mouse su PROJECT.ui.content progetto e scelta Aggiorna.
  4. 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.

    • Questo è un esempio di come 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>
    
  5. 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.

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

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

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

Risoluzione di una definizione di progetto non valida

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, selezionare Maven > Aggiorna Progetti.
  4. Verifica Forza aggiornamenti di snapshot/release.
  5. Fai clic su OK.

Eclipse scarica le dipendenze richieste. L'operazione potrebbe richiedere alcuni minuti.

Ulteriori informazioni

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:

In questa pagina