Questa guida spiega come configurare l’ambiante di sviluppo e creare i progetti per lo sviluppo di un plugin, logicblock, etc.

Creare il progetto #

L’IDE usato per lo sviluppo è Visual Studio.

Va creato un progetto Applicazione WPF

1. Aprire Visual Studio -> Crea un nuovo progetto
2. Selezionare Libreria di classi(.NET Framework)
3. Framework .NET8.0

Abilitare il valori null aggiungendo al file XML del progetto il tag

<Nullable>enable</Nullable

Se deve essere sviluppato un plugin o altro che utilizza la UI aggiungere nel file XML del progetto il tag

<UseWPF>true</UseWPF>

#

Importare le dipendenze #

E’ necessario importare l’SDK e altre librerie nelle dipendenze:

1. Se è installato OpenLab Studio l’SDK è già nella cartella lib altrimenti scaricare OpenLab SDK dalla pagina download
2. Per comodità creare una cartella lib nel progetto e posizionare lì tutte le librerie
3. Nella finestra Esplora Soluzioni cliccare con il tasto destro sulla voce Dipendenze del progetto,
4. Seleziona Aggiungi riferimento a progetto per aprire la finestra Gestione riferimenti, cliccare Sfoglia in basso
5. Aprire la cartella lib e selezionare tutti i file, se è installato OpenLab Studio è possibile utilizzare le librerie nella cartella lib di OpenLab Studio
   
   Info

   Non basta selezionare OpenLabSDK.dll come librerie. L’SDK dipende da altre dll. Di seguito è riportata la lista minima delle librerie da integrare:
   OpenLabSDK.dll
   System.IO.Ports.dll
   GeJSON.dll
   

Esportazione e installazione librerie #

Una volta completato lo sviluppo di un plugin o di altri componenti, il progetto va esportato in un file DLL.

1. Aprire il progetto in VisualStudio
2. Cliccare con il tasto destro del mouse sulla voce principale del progetto(nome del progetto) e cliccre su Pubblica
3. Selezionare come destinazione Cartella
4. Cliccare sul tasto Pubblica e una volta compilato il progetto cliccare su Esplora per aprire la directory di destinazione

Verrà creato un file DLL con il nome del progetto, questo file va è una libreria e può contenere Plugin, LogicBlock o altro in un unico file DLL.

Per installare una libreria che è stata sviluppata o una libreria di terze parti, copiare il file DLL nella directory library di OpenLab e se necessario applicare la configurazione come descritto nel prossimo paragragfo.

Applicare la configurazione #

Un plugin o LogicBlock o altro possono necessitare di una configurazione, questa va inserita nel file di configurazione di OpenLab config\config.js