Per iniziare
Prima di dedicarci al tema dello sviluppo, è importante costruire una solida base per un nuovo progetto. Nella comunità di sviluppatori di Dynamo sono disponibili diversi modelli di progetto che rappresentano ottimi punti di partenza, ma è ancora più importante comprendere come iniziare un progetto da zero. Creare un progetto dalle fondamenta consente di comprendere meglio il processo di sviluppo.
Creazione di un progetto di Visual Studio
Visual Studio è un potente IDE in cui è possibile creare un progetto, aggiungere riferimenti, creare file .dll
ed eseguire il debug. Quando si crea un nuovo progetto, in Visual Studio viene creata anche una soluzione, una struttura per l'organizzazione dei progetti. Più progetti possono coesistere all'interno di un'unica soluzione ed essere costruiti insieme. Per creare un nodo ZeroTouch, è necessario avviare un nuovo progetto di Visual Studio in cui scrivere una libreria di classi C# e creare un file .dll
.
La finestra di un nuovo progetto in Visual Studio
Iniziare aprendo Visual Studio e creando un nuovo progetto:
File > New > Project
.Scegliere il modello di progetto
Class Library
.Assegnare un nome al progetto (abbiamo denominato il progetto MyCustomNode).
Impostare il percorso del file per il progetto. In questo esempio, lo lasceremo nella posizione di default.
Selezionare
Ok
.
In Visual Studio si creerà e si aprirà automaticamente un file C#. Dobbiamo assegnargli un nome appropriato, impostare l'area di lavoro e sostituire il codice di default con questo metodo di moltiplicazione.
Aprire le finestre Esplora soluzioni e Output da
Visualizza
.Rinominare il file
Class1.cs
conSampleFunctions.cs
in Esplora soluzioni a destra.Aggiungere il codice riportato sopra per la funzione di moltiplicazione. Descriveremo le specifiche di come Dynamo leggerà le classi C# in un secondo momento.
Esplora soluzioni: consente di accedere a tutto ciò che è presente nel progetto.
La finestra Output: ci servirà in seguito per vedere se la creazione è andata a buon fine.
Il passaggio successivo consiste nella creazione del progetto, ma prima di procedere con questa operazione dobbiamo verificare alcune impostazioni. Assicurarsi innanzitutto che l'opzione Any CPU
o x64
sia selezionata in Platform target e che l'opzione Prefer 32-bit
sia deselezionata in Project Properties.
Aprire le proprietà del progetto selezionando
Progetto > "NomeProgetto" > Properties
.Selezionare la pagina
Compilazione
.Selezionare
Any CPU
ox64
dal menu a discesa.Assicurarsi che l'opzione
Preferisci 32 bit
sia deselezionata.
Ora possiamo realizzare il progetto per creare un file .dll
. A tale scopo, selezionare Compila soluzione
dal menu Compilazione
o utilizzare il tasto di scelta rapida CTRL+SHIFT+B
.
Selezionare
Compilazione > Compila soluzione
.È possibile determinare se il progetto è stato creato correttamente controllando la finestra Output.
Se il progetto è stato creato correttamente, nella cartella bin
del progetto sarà presente un file .dll
denominato MyCustomNode
. Per questo esempio abbiamo lasciato il percorso del file del progetto di default di Visual Studio: c:\users\username\documents\visual studio 2015\Projects
. Diamo un'occhiata alla struttura dei file del progetto.
La cartella
bin
contiene il file.dll
creato da Visual Studio.Il file del progetto di Visual Studio.
Il file della classe.
Poiché la configurazione della nostra soluzione è stata impostata su
Debug
, il file.dll
verrà creato inbin\Debug
.
Ora possiamo aprire Dynamo e importare il file .dll
. Con la funzione Add-ons, accedere alla posizione bin
del progetto e selezionare il file .dll
da aprire.
Selezionare il pulsante Add-ons per importare un file
.dll
.Individuare la posizione del progetto. Il nostro progetto si trova nel percorso dei file di default di Visual Studio:
C:\Users\username\Documents\Visual Studio 2015\Projects\MyCustomNode
.Selezionare il file
MyCustomNode.dll
da importare.Fare clic su
Apri
per caricare il file.dll
.
Se nella libreria viene creata una categoria denominata MyCustomNode
, il file .dll è stato importato correttamente. Tuttavia, Dynamo ha creato due nodi da quello che voleva essere un singolo nodo. Nella sezione successiva spiegheremo perché ciò accade e come Dynamo legge un file .dll.
MyCustomNode nella libreria di Dynamo. La categoria Libreria è determinata dal nome
.dll
.SampleFunctions.MultiplyByTwo nell'area di disegno.
Modalità di lettura di classi e metodi in Dynamo
Quando Dynamo carica un file .dll, espone tutti i metodi statici pubblici come nodi. I costruttori, i metodi e le proprietà verranno convertiti rispettivamente in nodi Create, Action e Query. Nel nostro esempio di moltiplicazione, il metodo MultiplyByTwo()
diventa un nodo Action in Dynamo. Ciò è dovuto al fatto che il nome del nodo è stato assegnato in base al metodo e alla classe corrispondenti.
L'input viene denominato
inputNumber
in base al nome del parametro del metodo.Per default, l'output viene denominato
double
perché è il tipo di dati restituito.Il nodo viene denominato
SampleFunctions.MultiplyByTwo
, perché si tratta dei nomi della classe e del metodo.
Nell'esempio precedente, è stato creato il nodo Create SampleFunctions
aggiuntivo perché non è stato fornito esplicitamente un costruttore e pertanto ne è stato creato uno automaticamente. Per evitare questo problema, è possibile creare un costruttore privato vuoto nella nostra classe SampleFunctions
.
Dynamo ha importato il metodo come nodo Create.
Aggiunta di riferimenti ai pacchetti NuGet di Dynamo
Il nodo di moltiplicazione è molto semplice e non sono necessari riferimenti a Dynamo. Se si desidera accedere ad una qualsiasi delle funzionalità di Dynamo per creare, ad esempio, la geometria, sarà necessario fare riferimento ai pacchetti NuGet di Dynamo.
ZeroTouchLibrary: pacchetto per la creazione di librerie di nodi zero touch per Dynamo che contiene le seguenti librerie: DynamoUnits.dll, ProtoGeometry.dll
WpfUILibrary: pacchetto per la creazione di librerie di nodi per Dynamo con interfaccia utente personalizzata in WPF che contiene le seguenti librerie: DynamoCoreWpf.dll, CoreNodeModels.dll, CoreNodeModelWpf.dll
DynamoServices: libreria di DynamoServices per Dynamo
Core: infrastruttura di unit test e test di sistema per Dynamo che contiene le seguenti librerie: DSIronPython.dll, DynamoApplications.dll, DynamoCore.dll, DynamoInstallDetective.dll, DynamoShapeManager.dll, DynamoUtilities.dll, ProtoCore.dll, VMDataBridge.dll
Test: infrastruttura di unit test e test di sistema per Dynamo che contiene le seguenti librerie: DynamoCoreTests.dll, SystemTestServices.dll, TestServices.dll
DynamoCoreNodes: pacchetto per la creazione di nodi di base per Dynamo che contiene le seguenti librerie: Analysis.dll, GeometryColor.dll, DSCoreNodes.dll
Per fare riferimento a questi pacchetti in un progetto di Visual Studio, scaricare il pacchetto da NuGet nei collegamenti precedenti e fare riferimento manualmente ai file .dll oppure utilizzare Gestione pacchetti NuGet in Visual Studio. Per prima cosa possiamo illustrare come installarli con NuGet in Visual Studio.
Aprire Gestione pacchetti NuGet selezionando
Strumenti > Gestione pacchetti NuGet > Gestione pacchetti NuGet per la soluzione
.
Questo è Gestione pacchetti NuGet. Questa finestra mostra i pacchetti installati per il progetto e consente all'utente di cercarne altri. Se viene rilasciata una nuova versione del pacchetto DynamoServices, è possibile aggiornare i pacchetti da questa posizione o ripristinare una versione precedente.
Selezionare Sfoglia e cercare DynamoVisualProgramming per visualizzare i pacchetti di Dynamo.
I pacchetti di Dynamo. Selezionandone uno, verranno mostrate la versione corrente e la descrizione del loro contenuto.
Selezionare la versione del pacchetto desiderata e fare clic su Installa. In questo modo viene installato un pacchetto per il progetto specifico in cui si sta lavorando. Poiché si sta utilizzando la release stabile più recente di Dynamo, versione 1.3, scegliere la versione del pacchetto corrispondente.
Per aggiungere manualmente un pacchetto scaricato dal browser, aprire Gestione riferimenti da Esplora soluzioni e cercare il pacchetto.
Fare clic con il pulsante destro del mouse su
Riferimenti
e selezionareAggiungi riferimento
.Selezionare
Sfoglia
per accedere alla posizione del pacchetto.
Ora che Visual Studio è configurato correttamente e abbiamo aggiunto un file .dll
a Dynamo, abbiamo una solida base per i concetti futuri. Questo è solo l'inizio, quindi è bene continuare a seguirci per ulteriori informazioni su come creare un nodo personalizzato.
Last updated