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.