Dynamo
Primer for v2.0
Français
Français
  • À propos
  • Introduction
    • Qu’est-ce que Dynamo et comment fonctionne-t-il ?
    • Manuel d’utilisation du guide, communauté et plate-forme Dynamo
  • Configuration de Dynamo
  • Interface utilisateur
    • Espace de travail
    • Bibliothèque
  • Nœuds et fils
  • Nœuds et concepts essentiels
    • Index des nœuds
    • Géométrie pour la conception informatique
      • Présentation de la géométrie
      • Vecteur, plan et système de coordonnées
      • Points
      • Courbes
      • Surfaces
      • Solides
      • Maillages
    • Blocs de construction des programmes
      • Données
      • Math
      • Logique
      • Chaînes
      • Couleur
    • Conception avec des listes
      • Qu’est-ce qu’une liste
      • Utilisation des listes
      • Listes de listes
      • Listes à n dimensions
    • Dictionnaires dans Dynamo
      • Qu’est-ce qu’un dictionnaire ?
      • Nœuds de dictionnaire
      • Dictionnaires dans les blocs de code
      • Cas d’utilisation de Revit
  • Packages et nœuds personnalisés
    • Nœuds personnalisés
      • Présentation des nœuds personnalisés
      • Création d’un nœud personnalisé
      • Publication dans votre bibliothèque
    • Packages
      • Présentation des packages
      • Étude de cas de package – Mesh Toolkit
      • Développement d'un package
      • Publication d’un package
      • Importation Zero-Touch
  • Dynamo pour Revit
    • La connexion Revit
    • Sélection
    • Édition
    • Création
    • Personnalisation
    • Documentation
  • Dynamo for Civil 3D
    • La connexion de Civil 3D
    • Mise en route
    • Bibliothèque de nœuds
    • Exemples de workflows
      • Routes
        • Positionnement des lampadaires
      • Terrain
        • Positionnement des services
      • Réseaux techniques
        • Renommer des structures
      • Rail
        • Zone de dégagement
      • Topographie
        • Gestion des groupes de points
    • Concepts avancés
      • Liaison d’objet
      • Python et Civil 3D
    • Lecteur Dynamo
    • Packages utiles
    • Ressources
  • Version bêta de Dynamo dans Forma
    • Configurer Dynamo Player dans Forma
    • Ajouter et partager des graphes dans Dynamo Player
    • Exécuter des graphes dans Dynamo Player
    • Différences entre les services de calcul Dynamo et Dynamo Desktop
  • Codage dans Dynamo
    • Nœuds Code Block et DesignScript
      • Qu’est-ce qu’un bloc de code ?
      • Syntaxe DesignScript
      • Raccourci
      • Fonctions
    • Géométrie avec DesignScript
      • Concepts de base de la géométrie DesignScript
      • Primitives géométriques
      • Calcul vectoriel
      • Courbes : points de contrôle et interpolés
      • Conversion, rotation et autres transformations
      • Surfaces : interpolation, points de contrôle, lissage, révolution
      • Définition des paramètres géométriques
      • Intersection et ajustement
      • Opérations booléennes géométriques
      • Générateurs de points Python
    • Python
      • Nœuds Python
      • Python et Revit
      • Configuration de votre propre gabarit Python
    • Changements relatifs au langage
  • Conseils d’utilisation
    • Stratégies de graphiques
    • Stratégies de script
    • Références concernant la création et la gestion des scripts
    • Gestion de votre programme
    • Utilisation efficace de jeux de données volumineux dans Dynamo
  • Exemples de workflows
    • Workflows de mise en route
      • Vase paramétrique
      • Points d’attraction
    • Index de concept
  • Guide du développeur
    • Générer Dynamo à partir de la source
      • Générer DynamoRevit à partir de la source
      • Gestion et mise à jour des dépendances dans Dynamo
    • Développer pour Dynamo
      • Mise en route
      • Étude de cas Zero-Touch : nœud grille
      • Exécuter des scripts Python dans des nœuds Zero-Touch (C#)
      • Aller plus loin avec le Zero-Touch
      • Personnalisation avancée des nœuds Dynamo
      • Utilisation de types COM (interopérabilité) dans les packages Dynamo
      • Étude de cas de modèle de nœud : interface utilisateur personnalisée
      • Mise à jour des packages et des bibliothèques Dynamo pour Dynamo 2.x
      • Mise à jour des packages et des bibliothèques Dynamo pour Dynamo 3.x
      • Extensions
      • Définition de l’organisation des packages personnalisés pour Dynamo 2.0+
      • Interface en ligne de commande Dynamo
      • Intégration Dynamo
      • Développement pour Dynamo for Revit
      • Publier un package
      • Générer un package à partir de Visual Studio
      • Extensions en tant que packages
    • Demandes de tirage
    • Test des attentes
    • Exemples
  • Annexe
    • Questions fréquemment posées
    • Programmation visuelle et Dynamo
    • Ressources
    • Informations sur la nouvelle version
    • Packages utiles
    • Fichiers d’exemple
    • Carte d’intégration de l’hôte
    • Télécharger le PDF.
    • Raccourcis clavier de Dynamo
Powered by GitBook
On this page
  • Localiser les dépôts Dynamo sur Github
  • Tirer le dépôt Dynamo à l’aide de git
  • Générer le dépôt à l’aide de Visual Studio
  • Exécution d’une génération locale
  • Déboguer une version locale à l’aide de Visual Studio
  • Tirer la dernière version
Edit on GitHub
Export as PDF
  1. Guide du développeur

Générer Dynamo à partir de la source

PreviousGuide du développeurNextGénérer DynamoRevit à partir de la source

Last updated 2 months ago

La source de Dynamo est hébergée sur Github pour que tout le monde puisse la cloner et y apporter sa contribution. Dans ce chapitre, nous verrons comment cloner le dépôt à l’aide de git, compiler les fichiers sources avec Visual Studio, exécuter et déboguer une génération locale, et extraire toutes les nouvelles modifications de Github.

Localiser les dépôts Dynamo sur Github

Github est un service d’hébergement basé sur , un système de contrôle de version permettant de suivre les modifications et de coordonner le travail entre les personnes. Git est un outil que nous pouvons utiliser pour télécharger les fichiers sources de Dynamo, et les maintenir à jour avec quelques commandes. L’utilisation de cette méthode permet d’éviter le travail fastidieux et inutile consistant à télécharger et à remplacer manuellement les fichiers sources à chaque mise à jour. Le système de contrôle de version git suit toutes les différences entre un dépôt de code local et un dépôt de code distant.

La source de Dynamo est hébergée sur Github DynamoDS dans ce dépôt :

Les fichiers source de Dynamo.

  1. Cloner ou télécharger l’intégralité du dépôt

  2. Afficher d’autres dépôts DynamoDS

  3. Fichiers source de Dynamo

  4. Fichiers spécifiques à Git

Tirer le dépôt Dynamo à l’aide de git

Nous avons besoin d’une URL pour le dépôt Dynamo à cloner. Celle-ci se trouve en cliquant sur le bouton « Cloner ou télécharger » sur la page du dépôt. Copiez l’URL pour la coller dans l’invite de commande.

  1. Sélectionnez « Cloner ou télécharger »

  2. Copiez l’URL

Une fois git installé, nous pouvons cloner le dépôt Dynamo. Commencez par ouvrir l’invite de commande. Utilisez ensuite la commande de changement de répertoire cd pour naviguer jusqu’au dossier dans lequel les fichiers sources doivent être clonés. Dans ce cas, nous avons créé un dossier appelé Github dans Documents.

cd C:\Users\username\Documents\GitHub

Remplacez « username » par votre nom d’utilisateur

Dans l’étape suivante, nous allons lancer une commande git pour cloner le dépôt Dynamo à l’emplacement que nous avons spécifié. L’URL de la commande est obtenue en cliquant sur le bouton « Cloner ou télécharger » sur Github. Exécutez cette commande dans le terminal de commande. Notez que cela clonera la branche master du dépôt Dynamo qui est le code le plus à jour de Dynamo, et contiendra la dernière version du code de Dynamo. Cette branche change quotidiennement.

git clone https://github.com/DynamoDS/Dynamo.git

Nous savons que git fonctionne si l’opération de clonage s’est terminée avec succès. Dans l’explorateur de fichiers, naviguez jusqu’au répertoire où vous avez cloné pour voir les fichiers sources. La structure du répertoire doit être identique à la branche master du dépôt Dynamo sur Github.

  1. Fichiers source de Dynamo

  2. Fichiers Git

Générer le dépôt à l’aide de Visual Studio

Les fichiers sources étant maintenant clonés sur notre machine locale, nous pouvons générer un fichier exécutable pour Dynamo. Pour ce faire, nous devons configurer l’IDE Visual Studio et nous assurer que le .NET Framework et DirectX sont installés.

  • Installez Microsoft DirectX à partir du dépôt local Dynamo (Dynamo\tools\install\Extra\DirectX\DXSETUP.exe).

.NET et DirectX peuvent être déjà installés.

Une fois l’installation terminée, nous pouvons lancer Visual Studio et ouvrir la solution Dynamo.All.sln située dans Dynamo\src.

  1. Sélectionnez File > Open > Project/Solution

  2. Naviguez jusqu’au dépôt Dynamo et ouvrez le dossier src

  3. Sélectionnez le fichier solution Dynamo.All.sln

  4. Sélectionnez Open

Avant de pouvoir générer la solution, vous devez spécifier quelques paramètres. Nous devrions d’abord générer une version de débogage de Dynamo afin que Visual Studio puisse recueillir plus d’informations pendant le débogage pour nous aider à développer, et nous voulons cibler AnyCPU.

Ils deviendront des dossiers dans le dossier bin

  1. Dans cet exemple, nous avons choisi Debug comme configuration de la solution

  2. Définissez la plateforme de solution sur Any CPU

Une fois le projet ouvert, nous pouvons générer la solution. Ce processus créera un fichier DynamoSandbox.exe que vous pouvez exécuter.

La génération du projet restaurera les dépendances NuGet.

  1. Sélectionnez Build > Build Solution

  2. Vérifiez que la génération a réussi dans la fenêtre de sortie, elle devrait ressembler à ==== Build: 69 succeeded, 0 failed, 0 up-to-date, 0 skipped ====

Exécution d’une génération locale

Si Dynamo est généré correctement, un dossier bin est créé dans le dépôt Dynamo avec le fichier DynamoSandbox.exe. Dans notre cas, nous générons avec l’option Debug, donc le fichier exécutable est situé dans bin\AnyCPU\Debug. L’exécution de cette commande ouvrira une version locale de Dynamo.

  1. L’exécutable DynamoSandbox que nous venons de générer. Exécutez cette commande pour démarrer Dynamo.

Nous sommes maintenant presque prêts à commencer à développer pour Dynamo.

Déboguer une version locale à l’aide de Visual Studio

Pour l’application Dynamo autonome, DynamoSandbox, nous allons couvrir deux options de débogage :

  • générer et démarrer Dynamo directement à partir de Visual Studio ;

  • associer Visual Studio à un processus en cours d’exécution de Dynamo.

Démarrer Dynamo à partir de Visual Studio génère à nouveau la solution pour chaque session de débogage si nécessaire, donc si nous avons fait des changements à la source, ils seront incorporés lors du débogage. La solution Dynamo.All.sln étant toujours ouverte, sélectionnez Debug, AnyCPU et DynamoSandbox dans les menus déroulants, puis cliquez sur Start. Cela va générer Dynamo et démarrer un nouveau processus (DynamoSandbox.exe), et y attacher le débogueur de Visual Studio.

Générer et démarrer une application à partir de Visual Studio

  1. Définissez la configuration sur Debug

  2. Définissez la plate-forme sur Any CPU

  3. Définissez le projet de démarrage sur DynamoSandbox

  4. Cliquez sur Start pour commencer le processus de débogage

Il est également possible de déboguer un processus Dynamo déjà en cours d’exécution pour résoudre un problème lié à un graphique ouvert ou à un package spécifique. Pour ce faire, nous devons ouvrir les fichiers sources du projet dans Visual Studio et nous attacher à un processus Dynamo en cours d’exécution en utilisant l’élément de menu de débogage Attach to Process.

Attacher un processus en cours d’exécution à Visual Studio

  1. Sélectionnez Debug > Attach to Process...

  2. Choisissez DynamoSandbox.exe

  3. Sélectionnez Attach

Dans les deux cas, nous attachons le débogueur à un processus que nous souhaitons déboguer. Nous pouvons définir des points d’arrêt dans le code avant ou après le démarrage du débogueur, ce qui entraînera une pause du processus immédiatement avant l’exécution de cette ligne de code. Si une exception non interceptée est levée lors du débogage, Visual Studio accède à l’emplacement où elle s’est produite dans le code source. Cette méthode est efficace pour rechercher des blocages simples, des exceptions non gérées et pour comprendre le flux d’exécution d’une application.

Lors du débogage de DynamoSandbox, nous avons placé un point d’arrêt dans le constructeur du nœud Color.ByARGB qui provoque une pause dans le processus Dynamo lorsque le nœud est instancié. Si ce nœud lance une exception ou provoque le blocage de Dynamo, nous pouvons parcourir chaque ligne du constructeur pour déterminer où le problème se produit.

  1. Le point d’arrêt

  2. La pile d’appels montre la fonction en cours d’exécution et les appels de fonction précédents

Dans la section suivante, Générer DynamoRevit à partir de la source, nous aborderons un exemple spécifique de débogage et expliquerons comment définir des points d’arrêt, parcourir le code et lire la pile d’appels.

Tirer la dernière version

Puisque la source de Dynamo est hébergée sur Github, la façon la plus simple de garder les fichiers source locaux à jour est de tirer les changements en utilisant les commandes git.

En utilisant la ligne de commande, définissez le répertoire courant du dépôt Dynamo :

cd C:\Users\username\Documents\GitHub\Dynamo

Remplacez "username" par votre nom d’utilisateur

Utilisez la commande suivante pour tirer les dernières modifications :

git pull origin master

  1. Nous pouvons voir ici que le dépôt local a été mis à jour avec les modifications apportées par le dépôt distant.

En plus de tirer des mises à jour, il y a quatre autres flux de travail git avec lesquels il faut se familiariser.

  • Dupliquer le dépôt Dynamo permet de créer une copie séparée de l’original. Tout changement effectué ici n’affectera pas le dépôt original et les mises à jour peuvent être récupérées ou soumises avec des demandes de tirage. Dupliquer n’est pas une commande git, mais un flux de travail que github ajoute. Le modèle de duplication et de tirage est l’un des flux de travail les plus courants pour contribuer à des projets open source en ligne. Cela vaut la peine de l’apprendre si vous voulez contribuer à Dynamo.

  • Une branche permet de travailler sur des expériences ou de nouvelles fonctionnalités isolées des autres travaux dans les branches. Cela facilite l’envoi de demandes de tirage.

  • Effectuez des commits fréquemment, après avoir terminé une unité de travail et après une modification qui pourrait être annulée. Un commit enregistre les changements dans le dépôt et sera visible lors d’une demande de tirage dans le dépôt principal de Dynamo.

  • Créez des demandes de tirage lorsque les changements sont prêts à être officiellement proposés au dépôt principal de Dynamo.

L’équipe Dynamo a des instructions spécifiques sur la création de demandes de tirage. Reportez-vous à la section Demandes de tirage de cette documentation pour obtenir des informations plus détaillées sur les éléments à traiter.

Avant de pouvoir cloner le dépôt, nous devons installer git. Suivez ce pour connaître les étapes à suivre pour l’installation et savoir comment configurer un nom d’utilisateur et une adresse email GitHub. Pour cet exemple, nous utiliserons git en ligne de commande. Ce guide part du principe que vous utilisez Windows, mais vous pouvez également utiliser git sur Mac ou Linux pour cloner la source de dynamo.

Téléchargez et installez , un IDE (environnement de développement intégré) gratuit et complet (les versions ultérieures peuvent également fonctionner).

Téléchargez et installez ou une version ultérieure.

Pour des instructions sur la génération de Dynamo pour d’autres plate-formes (par exemple Linux ou OS X), visitez cette .

Le débogage est un processus qui permet d’identifier, d’isoler et de corriger un bogue ou un problème. Une fois que Dynamo a été généré à partir de la source, nous pouvons utiliser plusieurs outils dans Visual Studio pour déboguer une application en cours d’exécution, le complément DynamoRevit par exemple. Nous pouvons analyser son code source pour trouver l’origine d’un problème, ou observer le code en cours d’exécution. Pour une explication plus détaillée sur la manière de déboguer et de parcourir le code dans Visual Studio, reportez-vous à la .

Reportez-vous à cette pour obtenir une liste de référence des commandes git.

guide
Microsoft Visual Studio Community 2015
Microsoft .NET Framework 4.5
page wiki
documentation de Visual Studio
page de documentation
git
https://github.com/DynamoDS/Dynamo
Les fichiers sources de Dynamo
Clonage d’un dépôt
Invite de commande
Résultats de l’opération de clonage de Git
Fichiers source de Dynamo
Ouverture du fichier solution
Paramètres de la solution
Générer la solution
Exécutable DynamoSandbox
Génération et démarrage d’une application à partir de Visual Studio
Boîte de dialogue Attacher au processus
Définition d’un point d’arrêt
Mise à jour du dépôt local