Création d’un dépôt d’extensions statiques#
Pour héberger vos propres extensions et tirer parti du système de mise à jour de Blender, il suffit d’un fichier JSON statique sur un serveur, pointant vers des liens de téléchargement pour les extensions.
JSON#
Pour générer un fichier JSON valide, vous pouvez utiliser l’outil en ligne de commande :
blender --command extension server-generate --repo-dir=/path/to/packages
Cela crée une liste index.json
de tous les packages trouvés à l’emplacement spécifié.
Voir les documents server-generate.
Le JSON généré est aligné sur l'API.
Test#
Pour tester le dépôt généré, créer un nouveau référentiel “distant” à partir des préférences de l’utilisateur :
Extensions -> Repositories -> [+] -> Add Remote Repository
Dans l”URL, coller l’emplacement du JSON généré. Ainsi, l’exemple
/path/to/packages
utiliserait :file:///path/to/packages/index.json
sur Linux/macOS.file:///C:/path/to/packages/index.json
sur MS-Windows.file://HOST/share/path/to/packages/index.json
partage le réseau sur MS-Windows.
Vous souhaiterez peut-être utiliser un navigateur Web pour accéder à l’emplacement du système de fichiers et copier cette URL dans Blender.
HTML#
La commande server-generate
peut éventuellement créer un site Web simple à l’aide de l’argument --html
qui peut être utilisé pour visualiser les extensions en ligne, les liens peuvent être envoyés dans Blender pour l’installation.
Pour un exemple de code HTML que vous pouvez utiliser pour lister toutes les extensions du dépôt, utilisez l’option html
lors de la génération du serveur.
blender --command extension server-generate --repo-dir=/path/to/packages --html
Cela crée un fichier index.html
avec tous les paramètres des URL supplémentaires prêts à être utilisés.
Liens de téléchargement#
Afin de prendre en charge le glisser-déposer pour l’installation à partir d’un dépôt distant, il existe quelques méthodes facultatives pour préparer les URL.
La seule exigence stricte est que l’URL de téléchargement doit se terminer par .zip
.
Vous pouvez transmettre différents arguments à l’URL pour donner plus d’indices à Blender sur ce qu’il faut faire avec l’URL déplacée.
- repository:
Lien vers le fichier JSON à utiliser pour installer le dépôt sur Blender. Prend en charge les URL relatives.
- platforms:
Liste des plateformes prises en charge, séparées par des virgules. En casd’omission, l’extension sera disponible dans tous les systèmes d’exploitation.
- blender_version_min:
Version minimum de Blender prise en charge.
- blender_version_max:
Version de Blender que l’extension ne prend pas en charge, les versions antérieures sont prises en charge.
Astuce
Plus vous fournissez de détails, meilleure est l’expérience utilisateur.
À l’exception de repository
, tous les autres paramètres peuvent être extraits du manifeste des extensions. Ces arguments doivent être codés dans le cadre de l’URL.
- Expected format:
<URL>.zip?repository=<repository>&blender_version_min=<version_min>&blender_max=<version_max_exclusive>&platforms=<platform1,platform2,...>
- Exemples :
https://extensions.blender.org/add-ons/amaranth-toolset/1.0.23/download/add-on-amaranth-toolset-v1.0.23.zip?repository=%2Fapi%2Fv1%2Fextensions%2F&blender_version_min=4.2.0&platforms=linux-x64%2Cmacos-x64
Notez que ``%2F`` et ``%2C`` sont simplement l’équivalent encodé-URL de ``/`` et ``,`` respectivement.