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’héberger un fichier JSON statique généré par Blender.
JSON¶
Pour générer un fichier JSON valide, utilisez l’outil de ligne de commande de « « génération du serveur Blender:
blender --command extension server-generate --repo-dir=/path/to/packages
Cela crée une liste index.json
à partir de toutes les extensions .zip trouvées dans l’emplacement –repo-dir.
Pour plus de détails, lisez l'API JSON générée.
Test¶
Pour tester le dépôt généré, créer un nouveau dépôt distant à partir des préférences de l’utilisateur :
Get Extensions → Repositories → [+] → Add Remote Repository
Collez l’emplacement du JSON généré comme URL. 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.
Astuce
Ouvrez file:///
dans un navigateur Web, accédez à l’emplacement du dépôt et copiez-le en tant qu’URL du dépôt distant.
Liste des extensions HTML¶
La commande server-generate
peut éventuellement créer un site Web simple à l’aide de l’argument --html
blender --command extension server-generate --repo-dir=/path/to/packages --html
Cela crée un fichier index.html
prêt à l’emploi, répertoriant les extensions qui peuvent être déposées dans Blender pour l’installation.
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 minimale de Blender prise en charge - par exemple 4.2.0.
- 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.
- Format attendu :
{URL}.zip?repository={repository}&blender_version_min={version_min}&blender_max={version_max_exclusive}&platforms={platform1,platform2}
- Exemple de dépôt auto-hébergé:
http://my-site.com/my-addon.zip?repository=.%2Findex.json&blender_version_min=4.2.0&platforms=windows-x64
- Exemple à partir de la plateforme d’extensions:
https://extensions.blender.org/download/sha256:57a6a5f39fa2cc834dc086a27b7b2e572c12fd14f8377fb8bd1c7022df3d7ccb/add-on-amaranth-v1.0.23.zip?repository=%2Fapi%2Fv1%2Fextensions%2F&blender_version_min=4.2.0&platforms=linux-x64%2Cmacos-x64
Note
%2F
and%2C
are simply the url-encoded equivalent of/
et,
respectivement.