Utilizzo dei Plugin
Abilitare i Plugin
Per questo motivo, l’esecuzione dei plugin è disabilitata di default per ogni progetto finché non confermi l’esecuzione dei plugin in Impostazioni del Progetto > Abilita plugin
.
Abilita i plugin solo per progetti di cui ti fidi. Se sposti o rinomini il tuo progetto, dovrai riattivare i plugin.
Installazione dei Plugin
Ci sono due modi per installare i plugin: tramite le dipendenze del tuo progetto o come file nella cartella plugins
.
Tramite NPM
Puoi installare i plugin tramite il node package manager (NPM). Installa un plugin con il seguente comando:
1npm i --save-dev @wonderlandengine/not-a-real-plugin
Sostituisci @wonderlandengine/not-a-real-plugin
con qualsiasi plugin che desideri installare.
L’esecuzione di questo comando creerà una nuova voce nella sezione devDependencies
del tuo file package.json
.
Il plugin apparirà poi in Impostazioni del Progetto > Plugin
.
Gestione dei Plugin
A volte potresti voler disabilitare i plugin per ridurre il disordine nell’interfaccia o per ripristinare le prestazioni dell’editor.
La lista in Impostazioni del Progetto > Plugin
mostra quali plugin sono installati e disponibili
per essere abilitati.
Sviluppo
Creare plugin è semplice. Hai a disposizione tre metodi:
Script del Plugin
Un singolo script che può condividere dipendenze con il package.json
del tuo progetto principale.
Ti consigliamo di installare tutte le dipendenze legate al plugin come devDependencies
(usando --save-dev
).
Puoi creare un nuovo plugin creando la cartella plugins
nella radice del tuo progetto, poi
clicca con il tasto destro > Nuovo Plugin
.
Assicurati di installare il pacchetto @wonderlandengine/editor-api
nella radice del tuo progetto:
1npm i --save-dev @wonderlandengine/editor-api
Directory del Plugin
Similmente agli Script del Plugin, crea prima una sottocartella plugins
,
poi crea un’altra sottocartella che nominerai secondo il tuo plugin.
In questa cartella puoi creare un nuovo file package.json
(ad esempio usando npm init
).
Assicurati di installare il pacchetto @wonderlandengine/editor-api
in quella directory:
1npm i --save @wonderlandengine/editor-api
Nota, --save
invece di --save-dev
, poiché non stai installando nel tuo progetto Wonderland Engine,
ma in un progetto plugin separato.
Pacchetto Plugin
Se desideri condividere e distribuire il tuo plugin, puoi fare npm init
in una cartella separata e aggiungere
la chiave "wonderlandengine"
al tuo package.json
.
Assicurati di installare il pacchetto @wonderlandengine/editor-api
in quella directory:
1npm i --save @wonderlandengine/editor-api
Per usare questo plugin locale nel tuo progetto, npm i --save-dev <path-to-the-directory>
,
oppure pubblicalo quando è pronto e installalo tramite il pacchetto, vedi Installare.