par Will Pearson (Dernière mise à jour :  mercredi 21 octobre 2020)

Présentation

Tout d’abord, il ne s’agit pas tant d’un guide pour les développeurs que d’une description de la façon dont cet outil fonctionne, afin que vous, en tant que développeur, puissiez mieux comprendre comment votre paquet et votre module doivent être configurés pour en tirer le meilleur parti.

Il peut être frustrant d’ouvrir une définition de Grasshopper et de constater que les modules nécessaires ne sont pas installés. Le Gestionnaire de paquets peut aider en rationalisant le processus de résolution de ces dépendances.

Depuis Rhino 6, la boîte de dialogue « Objets non reconnus » offre à l’utilisateur une option permettant de télécharger et installer les modules manquants. Cette fonction de restauration de paquets s’appelle « Package Restore ».

Elle va utiliser le nom, l’ID et la version des modules manquants pour lancer une recherche sur le serveur de paquets. Si des paquets correspondent à la requête, ils seront installés et, si possible, chargés avant d’ouvrir la définition¹.

Correspondance

Noms

Dans l’idéal, le nom du module de Grasshopper et celui du paquet doivent correspondre. Si cela n’est pas possible (en raison des contraintes du schéma de dénomination des paquets² ou du fait qu’il existe plusieurs modules dans un paquet et que chacun porte un nom différent) un paquet peut également être identifié à partir de l’ID du module.

Pour chaque fichier .gha, l’ID du module est extrait et ajouté au fichier manifest.yml lorsque vous lancez yak build.

Numéros de version

Les numéros de version des paquets peuvent suivre la gestion sémantique de version 2.0.0 (SemVer) ou comporter quatre chiffres³, comme dans System.Version. Reportez-vous au guide sur le serveur de paquets pour en savoir plus sur les formats de numéro de version autorisés.

Le serveur admet à la fois le format SemVer et celui à quatre chiffres étant donné que certains modules de Grasshopper spécifieront leur numéro de version sous forme de chaîne de texte dans une classe dérivée de GH_AssemblyInfo alors que d’autres s’appuieront sur AssemblyVersionAttribute.

Lors de la restauration des paquets, s’il existe un paquet sur le serveur qui correspond au nom ou à l’ID du paquet manquant, mais que la version exacte n’existe pas, la dernière version stable sera installée.

Modifier cette page

Modifier sur GitHub

Historique

Admin