Le Gestionnaire de paquets a été introduit dans Rhino 7. Il permet à l’utilisateur de rechercher, d’installer et de gérer plus facilement des modules de Grasshopper à partir de Rhino. Ce guide explique comment créer un paquet publiable sur le serveur de paquets à partir d’un module de Grasshopper.
"/Applications/Rhino 8.app/Contents/Resources/bin/yak"
.Tout d’abord, supposons que vous avez sur votre ordinateur un dossier qui contient tous les fichiers que vous souhaitez distribuer dans votre paquet. Quelque chose comme cela…
C:\Users\Bozo\dist
├── Marmoset.gha
├── icon.png
└── misc\
├── README.md
└── LICENSE.txt
Nous allons utiliser l’outil Yak CLI pour créer le paquet ; pour cela, ouvrez une invite de commande et naviguez jusqu’au répertoire ci-dessous.
> cd C:\Users\Bozo\dist
Maintenant, il nous faut un fichier manifest.yml
! Vous pouvez facilement créer le vôtre en vous aidant du guide de référence du manifeste.
Vous pouvez aussi utiliser la commande spec
pour générer un fichier squelette.
C’est ce que nous allons faire ici.
> "C:\Program Files\Rhino 8\System\Yak.exe" spec
Inspecting content: Marmoset.gha
---
name: marmoset
version: 1.0.0
authors:
- Park Ranger
description: >
This plug-in does something. I'm not really sure exactly what it's supposed to
do, but it does it better than any other plug-in.
url: https://example.com
Saved to C:\Users\Bozo\dist\manifest.yml
La commande spec
examine le répertoire actuel et, le cas échéant, glane des informations utiles dans l’ensemble.gha
et les utilise pour générer un fichier manifest.yml
pré-rempli avec le nom, la version, les auteurs, etc.
Si vous n’avez pas fourni ces informations, des caractères de remplissage seront utilisés.
spec
est utile pour générer le fichier manifest.yml la première fois.
Une fois que vous en avez un, enregistrez-le avec votre projet et mettez-le à jour lors de chaque version.Ouvrez le fichier manifeste avec votre éditeur préféré et renseignez les champs vides.
Vous devriez ensuite obtenir quelque chose qui ressemble à ceci…
---
name: marmoset
version: 1.0.0
authors:
- Park Ranger
description: >
This plug-in does something. I'm not really sure exactly what it's supposed to
do, but it does it better than any other plug-in.
url: https://example.com
icon: icon.png
keywords:
- mammal
Maintenant que nous avons un fichier manifeste, nous pouvons construire le paquet !
> "C:\Program Files\Rhino 8\System\Yak.exe" build
Building package from contents of C:\Users\Bozo\dist
Found manifest.yml for package: marmoset (1.0.0)
Inspecting content: Marmoset.gha
Creating marmoset-1.0.0-rh6_18-any.yak
---
name: marmoset
version: 1.0.0
authors:
- Will Pearson
description: >
This plug-in does something. I'm not really sure exactly what it's supposed to
do, but it does it better than any other plug-in.
url: example.com
keywords:
- mammal
- guid:c9beedb9-07ec-4974-a0a2-44670ddb17e4
C:\Users\Bozo\dist\marmoset-1.0.0-rh6_18-any.yak
├── Marmoset.dll
├── Marmoset.gha
├── manifest.yml
├── misc\LICENSE.txt
└── misc\README.md
rh6_18-any
). La première partie, rh6_18
, est déduite de la version de Grasshopper.dll ou Rhinocommon.dll référencée dans le projet de module. La deuxième partie, any
, fait référence à la plateforme à laquelle le module est destiné. Pour construire un paquet spécifique à une plateforme, lancez à nouveau la commande build
avec l’argument --platform <platform>
où <platform>
peut être win
ou mac
.rh6*
, il ne sera pas installable pour Rhino 7. Si votre module fonctionne également sous Rhino 7, indiquez qu’il est compatible en copiant le fichier .yak, en mettant à jour la partie de l’étiquette de distribution du nom de fichier (c’est-à-dire rh6_18
➡ rh7_0
) et en téléchargeant les deux sur le serveur de paquets.Félicitations ! 🙌 Vous venez de créer un paquet pour votre module de Grasshopper.
Étapes suivantes
Maintenant que vous avez créé un paquet, téléchargez-le sur le serveur de paquets afin qu’il soit disponible dans le gestionnaire de paquets !