Creació d’un repositori d’extensions estàtic¶
Per allotjar les pròpies extensions i exprimir el sistema d’actualització de Blender, només cal hostatjar un document JSON estàtic que Blender mateix genera.
JSON¶
Consulteu els documents de server generate:
blender --command extension server-generate --repo-dir=/path/to/packages
Això crea un llistat index.json des de totes les extensions .zip que es troben a la ubicació –repo-dir .
Per més detalls, llegiu l'API JSON generada.
Comprovació¶
Per comprovar el repositori generat, afegiu un nou Repositori remot a partir de les Preferències:
Accediu a Extensions → Repositoris → [+] → Afegir repositori remot
Enganxeu la ubicació del JSON generat com a URL. Per tant, l’exemple
/path/to/packagesutilitzarà el:file:///path/to/packages/index.jsonamb Linux i macOS.file:///C:/path/to/packages/index.jsonamb Windows.file://HOST/share/path/to/packages/index.jsonper compartició de xarxa amb Windows.
Truc
Obriu file:/// en un navegador web i navegueu fins a la ubicació del repositori i copieu-ho com a URL del repositori remot.
Llistat d’extensions HTML¶
L’ordre server-generate pot crear opcionalment un lloc web senzill utilitzant l’argument --html.
blender --command extension server-generate --repo-dir=/path/to/packages --html
Així es crea un document index.html llest per ser utilitzat i que llista les extensions que es poden deposar dins de Blender per instal·lar-les.
Enllaços de descàrrega¶
Per donar suport a arrossegar i deposar en la instal·lació des d’un repositori remot, hi ha algunes maneres opcionals de preparar les URL.
L’únic requisit estricte és que la URL de descàrrega ha d’acabar en .zip.
Podeu passar diferents arguments a la URL per donar més pistes a Blender sobre què fer amb la URL deposada.
- repository:
Enllaça al document JSON que s’emprarà per instal·lar el repositori a Blender. Admet URLs relatives.
- platforms:
Llista separada per comes de plataformes compatibles. Si s’omet, l’extensió estarà disponible en tots els sistemes operatius.
- blender_version_min:
Versió mínima amb suport de Blender, p. ex.
4.2.0.- blender_version_max:
Versió de Blender que l’extensió no admet, admet versions anteriors.
Truc
Com més detalls aporteu, millor serà l’experiència de la usuària.
Amb l’excepció del repository, tots els altres paràmetres es poden extreure del manifest de les extensions. Aquests arguments s’han de codificar com a part de la URL.
- Format esperat:
{URL}.zip?repository={repository}&blender_version_min={version_min}&blender_max={version_max_exclusive}&platforms={platform1,platform2}- Exemple de repositori autohostatjat:
http://my-site.com/my-addon.zip?repository=.%2Findex.json&blender_version_min=4.2.0&platforms=windows-x64- Exemple de la Plataforma 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-x64Nota
%2Fi%2Cno són altra cosa que l’equivalent en codi-URL de/i,respectivament.