Configurare gli strumenti di sviluppo set-up-development-tools

Per sviluppare per Adobe Experience Manager (AEM) è necessario installare e configurare un set minimo di strumenti specifici nel computer dello sviluppatore, Questi strumenti supportano lo sviluppo e la creazione di progetti AEM.

~ viene utilizzato come abbreviazione per la directory dell’utente. In Windows equivale a %HOMEPATH%.

Installare Java

Experience Manager è un’applicazione Java e pertanto richiede Java SDK per supportare lo sviluppo e AEM as a Cloud Service SDK.

  1. Scarica e installa la versione più recente di Java 11 SDK
  2. Verifica che Oracle Java 11 SDK sia installato eseguendo il comando:
macOS
code language-shell
$ java --version
Windows
code language-shell
$ java -version
Linux
code language-shell
$ java --version

Java

Installa Homebrew

L’utilizzo di Homebrew è facoltativo, ma consigliato.

Homebrew è un gestore di pacchetti open-source per macOS, Windows e Linux. Tutti gli strumenti di supporto possono essere installati separatamente, Homebrew fornisce un modo conveniente per installare e aggiornare una varietà di strumenti di sviluppo necessari per lo sviluppo Experience Manager.

  1. Apri il terminale
  2. Verificare se Homebrew è già installato eseguendo il comando: brew --version.
  3. Se Homebrew non è installato, installarlo
macOS

Homebrew in macOS richiede Xcode o Strumenti riga di comando, installabile tramite il comando:

code language-shell
$ xcode-select --install
Windows
Installare Homebrew su Windows 10
Linux
Installare Homebrew su Linux
  1. Verificare che Homebrew sia installato eseguendo il comando: brew --version

Ebraico

Se utilizzi Homebrew, segui le istruzioni Installa utilizzando Homebrew nelle sezioni seguenti. Se non utilizzi Homebrew, installa gli strumenti utilizzando i collegamenti specifici del sistema operativo.

Installare Git

Git è il sistema di gestione del controllo del codice sorgente utilizzato da Adobe Cloud Manager ed è pertanto necessario per lo sviluppo.

Installa Git utilizzando Homebrew
  1. Apri il terminale/prompt dei comandi
  2. Eseguire il comando: $ brew install git
  3. Verificare che Git sia installato utilizzando il comando: $ git --version
Scarica e installa Git
  1. Scaricare e installare Git
  2. Apri il terminale/prompt dei comandi
  3. Verificare che Git sia installato utilizzando il comando: $ git --version

Git

Installare Node.js (e npm) node-js

Node.js è un ambiente runtime di JavaScript utilizzato per le risorse front-end del sottoprogetto ui.frontend di un progetto AEM. Node.js è distribuito con npm, è il gestore di pacchetti Node.js, utilizzato per gestire le dipendenze di JavaScript.

Installa Node.js utilizzando Homebrew
  1. Apri il terminale/prompt dei comandi
  2. Eseguire il comando: $ brew install node
  3. Verificare che Node.js sia installato utilizzando il comando: $ node -v
  4. Verificare che npm sia installato utilizzando il comando: $ npm -v
Scarica e installa Node.js
  1. Scaricare e installare Node.js
  2. Apri il terminale/prompt dei comandi
  3. Verificare che Node.js sia installato utilizzando il comando: $ node -v
  4. Verificare che npm sia installato utilizzando il comando: $ npm -v

Node.js e npm

TIP
I progetti AEM basati su Archetipo progetto AEM installano una versione isolata di Node.js al momento della compilazione. È consigliabile mantenere sincronizzata (o vicina) la versione del sistema di sviluppo locale con le versioni di Node.js e npm specificate nel file pom.xml del progetto Reactor di AEM Maven.
Consulta questo esempio AEM Project Reactor pom.xml per sapere dove individuare le versioni di Node.js e npm.

Installare Maven

Apache Maven è lo strumento da riga di comando Java open-source utilizzato per creare progetti AEM generati dall’archetipo Maven del progetto AEM. Tutti gli IDE principali (IntelliJ IDEA, Visual Studio Code, Eclipse, ecc.) dispongono del supporto Maven integrato.

Installa Maven utilizzando Homebrew
  1. Apri il terminale/prompt dei comandi
  2. Eseguire il comando: $ brew install maven
  3. Verificare che Maven sia installato utilizzando il comando: $ mvn -v
Scarica e installa Maven
  1. Scarica Maven
  2. Installare Maven
  3. Apri il terminale/prompt dei comandi
  4. Verificare che Maven sia installato utilizzando il comando: $ mvn -v

Maven

Configurare Adobe I/O CLI aio-cli

Adobe I/O CLI o aio fornisce l’accesso alla riga di comando a diversi servizi Adobe, tra cui Cloud Manager e Asset Compute. Adobe I/O CLI svolge un ruolo fondamentale nello sviluppo su AEM as a Cloud Service in quanto consente agli sviluppatori di:

Installare Adobe I/O CLI

  1. Verificare che Node.js sia installato poiché Adobe I/O CLI è un modulo npm
    • Esegui node --version per confermare
  2. Eseguire npm install -g @adobe/aio-cli per installare il modulo npm aio a livello globale

Configurare il plug-in Adobe I/O CLI Cloud Manager aio-cloud-manager

Il plug-in Cloud Manager di Adobe I/O consente all’interfaccia della riga di comando aio di interagire con Adobe Cloud Manager tramite il comando aio cloudmanager.

  1. Eseguire aio plugins:install @adobe/aio-cli-plugin-cloudmanager per installare il plug-in di Cloud Manager aio.

Configurare l’autenticazione CLI di Adobe I/O

Affinché Adobe I/O CLI possa comunicare con Cloud Manager, è necessario creare un’integrazione di Cloud Manager nella console di Adobe I/O e ottenere le credenziali per l’autenticazione.

  1. Accedi a console.adobe.io

  2. Assicurati che l’organizzazione che include il prodotto Cloud Manager a cui connettersi sia attiva nello switcher dell’organizzazione Adobe

  3. Crea un nuovo programma Adobe I/O o apri un programma esistente

    • I progetti della console Adobe I/O sono semplicemente raggruppamenti organizzativi di integrazioni, creano o utilizzano e progetti esistenti in base a come desideri gestire le integrazioni.
    • Se crei un nuovo progetto, seleziona “Progetto vuoto” se richiesto (anziché “Crea da modello”).
    • I programmi della console Adobe I/O sono concetti diversi rispetto ai programmi Cloud Manager
  4. Creare una nuova integrazione API Cloud Manager

    • Selezionare il tipo di credenziali “Oauth Server-to-server”.
    • Seleziona il profilo di prodotto “Deployment Manager - Cloud Service”.
    • Salva API configurata
  5. Per ottenere le credenziali necessarie per popolare il file config.json di Adobe I/O CLI, apri le credenziali “OAuth Server-to-server” appena create e seleziona “Scarica JSON” dalla barra delle azioni in alto a destra.

  6. Apri il file JSON scaricato e rinominato tutte le chiavi in minuscolo. CLIENT_ID, ad esempio, diventa client_id.

  7. Carica il file config.json in Adobe I/O CLI

    • $ aio config:set ims.contexts.aio-cli-plugin-cloudmanager /path/to/downloaded/json --file --json

Inizia l’esecuzione dei comandi per Cloud Manager tramite Adobe I/O CLI.

Configurare il plug-in AEM Rapid Development Environment rde

Il plug-in AEM Rapid Development Environment consente all’interfaccia CLI dell’aio di interagire con AEM as a Cloud Service Rapid Development Environments tramite il comando aio aem:rde.

  1. Eseguire aio plugins:install @adobe/aio-cli-plugin-aem-rde per installare il plug-in AEM Rapid Development Environments.

Configurare il plug-in Adobe I/O CLI Asset Compute aio-asset-compute

Il plug-in Adobe I/O Cloud Manager consente all’interfaccia della riga di comando aio di generare ed eseguire processi di lavoro Asset Compute tramite il comando aio asset-compute.

  1. Eseguire aio plugins:install @adobe/aio-cli-plugin-asset-compute per installare il plug-in Asset Compute aio.

Configurare l’IDE di sviluppo

Lo sviluppo AEM consiste principalmente nello sviluppo Java e front-end (JavaScript, CSS, ecc.) e nella gestione XML. Di seguito sono riportati gli IDE più comuni per lo sviluppo AEM.

IDEA IntelliJ

IntelliJ IDEA è un potente IDE per lo sviluppo Java. IntelliJ IDEA è disponibile in due versioni, una versione Community Edition gratuita e una versione Ultimate commerciale (a pagamento). La versione gratuita della community è sufficiente per lo sviluppo di AEM, tuttavia Ultimate espande il set di funzionalità.

Codice Microsoft Visual Studio

Visual Studio Code (VS Code) è uno strumento gratuito open-source per sviluppatori front-end. È possibile configurare Visual Studio Code per integrare la sincronizzazione dei contenuti con AEM con l’aiuto di uno strumento di Adobe, repo.

Visual Studio Code è la scelta ideale per gli sviluppatori front-end che creano principalmente codice front-end, ovvero JavaScript, CSS e HTML. Anche se il codice VS dispone del supporto Java tramite estensioni, potrebbero mancare alcune delle funzioni avanzate fornite da più specifiche di Java.

Eclipse

Eclipse IDE è uno dei più diffusi IDE per lo sviluppo Java e supporta il plug-in Strumenti per sviluppatori AEM fornito da Adobe, che fornisce un’interfaccia grafica interna all’IDE per l’authoring e la sincronizzazione dei contenuti JCR con un’istanza AEM locale.

recommendation-more-help
experience-manager-learn-help-cloud-service