DocumentazioneAEMTutorial su AEMTutorial su AEM as a Cloud Service

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

Last update: Sun Jul 14 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Creato per:

  • Principiante
  • Sviluppatore

Per sviluppare per Adobe Experience Manager (AEM) è necessario installare e configurare un set minimo di strumenti specifici nel computer dello sviluppatore, Questi strumenti sostengono 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 SDK Java per supportare lo sviluppo e l’SDK AEM as a Cloud Service.

  1. [Scarica e installa la versione più recente Java 11 SDK](https://experience.adobe.com/#/downloads/content/software-distribution/en/general.html?1_group.propertyvalues.property=.%2Fjcr%3Acontent%2Fmetadata%2Fdc%3AsoftwareType&1_group.propertyvalues.operation=equals&1_group.propertyvalues.0_values=tipo di software%3Atooling&fulltext=Oracle%7E+JDK%7E+11%7E&orderby=%40jcr%3Acontent%2Fjcr%3AlastModified&orderby.sort=desc&layout=list&p.offset=0&p.limit=14)
  2. Verifica che l’SDK di Java 11 Oracle 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
Installa Homebrew in Windows 10
Linux
Installa 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. Scarica e installa 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. Scarica e installa 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 progetto Reactor pom.xml del progetto 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. Installa 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. L’interfaccia CLI di Adobe I/O 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é l'interfaccia CLI di Adobe I/O è 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 Adobe I/O consente all'interfaccia CLI dell'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 Adobe I/O

Affinché Adobe I/O CLI possa comunicare con Cloud Manager, è necessario creare un'integrazione di Cloud Manager in Adobe I/O Console 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 di Adobe I/O esistente o aprilo

    • I progetti Adobe I/O Console sono semplicemente raggruppamenti organizzativi di integrazioni, creazione o utilizzo di 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 Adobe I/O Console sono concetti diversi rispetto ai programmi Cloud Manager

  4. Creare una nuova integrazione API Cloud Manager

    • Seleziona il tipo di autenticazione "Service Account (JWT)" obsoleto (OAuth non è al momento supportato per CLI).
    • Crea o carica le chiavi.
    • Seleziona il profilo di prodotto "Sviluppatore - Cloud Service"

  5. Per ottenere le credenziali dell'account di servizio (JWT) è necessario compilare config.json di Adobe I/O CLI

    code language-json 
    //config.json
{
   "client_id": "Client ID from Service Account (JWT) credential",
   "client_secret": "Client Secret from Service Account (JWT) credential",
   "technical_account_id": "Technical Account ID from Service Account (JWT) credential",
   "ims_org_id": "Organization ID from Service Account (JWT) credential",
   "meta_scopes": [
     "ent_cloudmgr_sdk"
   ]
}

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

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

  7. Carica il file private.key in Adobe I/O CLI

    • $ aio config:set ims.contexts.aio-cli-plugin-cloudmanager.private_key ./path/to/private.key --file

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 della riga di comando 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 di Asset compute CLI Adobe I/O aio-asset-compute

Il plug-in Cloud Manager Adobe I/O consente all'interfaccia CLI dell'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 di 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ù popolari per lo sviluppo dell’AEM.

IDEA IntelliJ

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

https://video.tv.adobe.com/v/327239?quality=12&learn=on&captions=ita

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.

https://video.tv.adobe.com/v/25907?quality=12&learn=on

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 la creazione e la sincronizzazione dei contenuti JCR con un'istanza AEM locale.

https://video.tv.adobe.com/v/25906?quality=12&learn=on

recommendation-more-help
4859a77c-7971-4ac9-8f5c-4260823c6f69