Configurare gli strumenti e l’account dell’estensione dell’interfaccia utente

Ultimo aggiornamento: 19 agosto 2026

Argomenti:
{"id":"f48b5020-b9cd-4d99-bc6e-42c35e90c1f8"}

Prima di poter creare un’estensione dell’interfaccia utente per Workfront Fusion, è necessario configurare gli strumenti e l’account. Questo deve essere fatto solo una volta.

NOTE

Questo articolo presuppone una certa familiarità con gli strumenti di sviluppo software.

Prerequisiti

Per configurare gli strumenti e l’account di estensibilità dell’interfaccia utente, è necessario disporre dei seguenti elementi:

Adobe ID con accesso a un’organizzazione Adobe. Questo è l’account che utilizzi per accedere a Fusion.
Accesso sviluppatore ad App Builder. L’amministratore dell’organizzazione potrebbe dover concedere il ruolo Sviluppatore e aggiungerti a un profilo di prodotto che include App Builder. Se in seguito i comandi non riescono e viene visualizzato il messaggio “non sei uno sviluppatore” o se non riesci a visualizzare la tua organizzazione, chiedi all’amministratore dell’organizzazione Adobe di aggiungerti.
Amministratore di sistema (probabilmente un altro membro del team) per il passaggio finale della versione. La creazione e la distribuzione richiedono solo il ruolo Sviluppatore, ma l’invio di un’estensione per l’approvazione/pubblicazione richiede il ruolo Amministratore di sistema.

Per ulteriori informazioni sui livelli di accesso ad Adobe, consulta
Come ottenere l’accesso nella documentazione Adobe.
Computer in cui è possibile installare software ed eseguire comandi terminali (macOS, Windows o Linux).

Installare Node.js

Gli strumenti di Adobe vengono eseguiti su Node.js. È necessario installare la versione LTS (18 o 20).

Vai a https://nodejs.org e scarica il programma di installazione di LTS.
Eseguire il programma di installazione e accettare le impostazioni predefinite.

Confermare il funzionamento aprendo un terminale ed eseguendo:

code language-sh
`node --version npm --version`

Dovresti visualizzare i numeri di versione (ad esempio v20.17.0 e 10.x).

(Condizionale) Se node non viene trovato, chiudere e riaprire il terminale o riavviare il computer.
Continuare con Installare Adobe I/O CLI (aio).

TIP

Se si utilizzano più versioni di Nodo, un gestore delle versioni come nvm è comodo, ma è facoltativo.
Adobe CLI richiede Node 18 o versione successiva. Versioni molto nuove, non-LTS possono occasionalmente causare problemi, quindi si consiglia di utilizzare LTS.

Installa Adobe I/O CLI (`aio`)

Lo strumento da riga di comando utilizzato per creare, generare e pubblicare l’estensione è denominato aio.

Per installarlo a livello globale:

Utilizza il seguente comando npm nella riga di comando.

code language-sh
`npm install -g @adobe/aio-cli`

Conferma l’installazione utilizzando il seguente comando:

code language-sh
`aio --version`

Dovresti trovare qualcosa come @adobe/aio-cli/11.x.x.

Continua con Accedi ad Adobe.

NOTE

Se viene visualizzato un errore di autorizzazione in macOS/Linux, non utilizzare sudo. Correggi invece le autorizzazioni della cartella globale di npm oppure utilizza un gestore della versione del nodo che viene installato nella home directory.

Accedere ad Adobe

Connetti CLI al tuo account Adobe con il seguente comando:

code language-sh
`aio login`

Nella finestra del browser visualizzata, accedi con il tuo Adobe ID e approva l’accesso.
Dopo aver effettuato l’accesso, chiudi la scheda del browser e torna al terminale.
(Facoltativo) Per disconnettersi in un secondo momento, ad esempio per cambiare account, utilizzare il comando: aio logout.
Continua con Conferma l’organizzazione attiva.

Conferma l’organizzazione attiva

Verificare a quale organizzazione si rivolge l’interfaccia CLI:

aio console org list      # see organizations you can use
aio console where         # see your currently selected org/project/workspace

Se appartieni a più organizzazioni, seleziona quella corretta:

aio console org select

Ora puoi creare il progetto.

recommendation-more-help

workfront-fusion-help-workfront-fusion