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
In the URL paste the location of the generated JSON. So the example
/path/to/packages
would use the:file:///path/to/packages/index.json
on Linux/macOS.file:///C:/path/to/packages/index.json
on MS-Windows.file://HOST/share/path/to/packages/index.json
network shares on MS-Windows.
You may wish to use a web browser to navigate to the file-system location and copy that URL into 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
Note that ``%2F`` and ``%2C`` are simply the url-encoded equivalent of ``/`` and ``,`` respectively.