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 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.
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=/api/v1/extensions/&blender_version_min=4.2.0&platforms=linux-x64,macos-x64
Exemple HTML#
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 download.html avec tous les paramètres des URL supplémentaires prêts à être utilisés.