par Pedro Cortes (Dernière mise à jour :  lundi 13 mai 2024)

Rhino.Compute vous permet d’utiliser les capacités de calcul géométrique de Rhino dans le cloud. Avant de déployer votre application dans un environnement de production, vous devez vous assurer que tout fonctionne parfaitement dans un environnement contrôlé.

Ce guide est destiné aux développeurs qui ont l’habitude d’utiliser Windows et qui ont des connaissances de base de Visual Studio et de Git. Que vous soyez un utilisateur chevronné de Rhino ou que vous découvriez Rhino.Compute, vous trouverez dans ce document toutes les étapes nécessaires pour mettre en place votre environnement de développement et commencer à déboguer efficacement.

Conditions préalables

Avant de vous lancer dans l’installation de Rhino.Compute sur votre machine locale, vous devez vous assurer que vous disposez des outils adaptés. Vous aurez besoin :

• Du système d’exploitation Windows. Rhino.Compute ne fonctionne que sous Windows.
• D’un environnement de développement. Visual Studio 2022 sera nécessaire pour compiler le code.
• D’un système de contrôle des versions. Git est indispensable pour cloner le répertoire compute.rhino3d et gérer les branches en fonction de votre version de Rhino.
• De Rhino. Visitez notre page de téléchargements pour obtenir les dernières versions de Rhino 8 ou Rhino 7. Après l’avoir téléchargé et installé, démarrez Rhino et suivez les instructions au démarrage pour valider votre licence sur votre machine ou via le Cloud Zoo.

Cloner le répertoire

Pour obtenir la dernière version de Rhino.Compute, vous devrez cloner son répertoire depuis notre compte officiel sur Github.

1. Allez sur https://github.com/mcneel/compute.rhino3d

2. Dans le menu déroulant « branch », sélectionnez la branche à cloner (8.x ou 7.x).

3. Ensuite, cliquez sur le bouton vert « <> Code » et copiez l’URL du répertoire.

4. Sur votre ordinateur local, créez un dossier dans lequel vous clonerez le répertoire.

5. Naviguez vers ce répertoire via l’invite de commande de votre choix, puis tapez git clone et collez l’URL que vous avez copiée plus tôt.

   git clone https://github.com/mcneel/compute.rhino3d.git
   

6. Une fois l’opération de clonage terminée, vous devriez voir un certain nombre de fichiers et de répertoires qui ont été téléchargés depuis le répertoire compute.rhino3d dans le dossier que vous avez créé.

Anatomie de la solution

Dans le répertoire Rhino.Compute, vous trouverez deux projets principaux, chacun servant des objectifs distincts. Bien les comprendre vous aidera à appréhender clairement le fonctionnement de Rhino.Compute, en particulier si vous souhaitez travailler ou à contribuer à son développement. Voici une explication détaillée des deux projets :

• compute.geometry. Ce projet se concentre principalement sur les aspects de calcul géométrique. Essentiellement, compute.geometry fournit une API REST qui expose le moteur de géométrie de Rhino à utiliser sur Internet. Cela signifie que des opérations géométriques peuvent être effectuées sur un serveur et que les résultats peuvent être récupérés à distance, ce qui est très utile pour les applications ou les services Web qui nécessitent un traitement géométrique complexe.

• rhino.compute. Ce projet peut être considéré comme une couche de service de haut niveau qui gère et orchestre les appels à l’API compute.geometry, en gérant des tâches telles que l’authentification, la création de processus enfants et la configuration de délais pour le processus d’arrêt.

Compiler la solution

Maintenant que vous avez le code, il est temps d’ouvrir le projet dans Visual Studio 2022 et de le préparer pour le débogage.

1. Naviguez jusqu’au répertoire où vous avez cloné les dossiers et fichiers, et trouvez le fichier compute.sln. Double-cliquez dessus pour ouvrir le projet dans Visual Studio 2022.

2. Passez la configuration de la solution en mode débogage (Debug). Cela vous permet d’exécuter le code avec toutes les fonctionnalités de débogage, ce qui facilite le suivi du code et la détection des erreurs.

3. Dans le menu File, cliquez sur Build -> Build Solution (Ctrl + Shift + B). Cette opération compile tous les fichiers du projet.

4. Dans le panneau de l’explorateur de solutions, faites un clic droit sur le projet rhino.compute et sélectionnez Set as Startup Project. Ainsi vous êtes sûr que lorsque vous lancez le débogueur, Visual Studio démarre ce projet particulier.

5. Cliquez sur rhino.compute pour démarrer l’application dans le débogueur. Une application console devrait apparaître dans votre barre des tâches, indiquant l’état du processus de chargement de Rhino.Compute.

6. Il ne vous reste plus qu’à attendre quelques secondes durant le chargement de Rhino.Compute. N’oubliez pas que les informations enregistrées dépendent de la version de Rhino que vous avez choisie précédemment.

Tester un point de terminaison

Avec l’application console Rhino.Compute en cours d’exécution, naviguez vers l’un de ces points de terminaison pour vérifier que tout fonctionne !

• http://localhost:6500/version
• http://localhost:6500/healthcheck
• http://localhost:6500/activechildren
• http://localhost:6500/sdk

Modifier cette page

Modifier sur GitHub

Historique

Admin