Vytváranie statického úložiska rozšírení

Ak chcete hostiť vlastné rozšírenia a využívať systém aktualizácií Blenderu, stačí hosťovať statický súbor JSON, ktorý vygeneruje Blender.

JSON

Na vygenerovanie platného súboru JSON použite generačný server príkazového riadku Blenderu:

blender --command extension server-generate --repo-dir=/path/to/packages

Tým sa vytvorí zoznam index.json zo všetkých rozšírení .zip nájdených v umiestnení –repo-dir.

Pre viac informácií si prečítajte vygenerovaný JSON API.

Testovanie

Ak chcete vygenerované úložisko otestovať, pridajte nové vzdialené úložisko v časti Predvoľby:

• Získať rozšírenia → Úložiská → [+] → Pridať vzdialené úložisko

• Vložte umiestnenie vygenerovaného JSON ako URL. Takže príklad použitia /path/to/packages:

  • file:///path/to/packages/index.json na Linux a macOS.

  • file:///C:/path/to/packages/index.json na Windows.

  • file://HOST/share/path/to/packages/index.json sieťové zdieľanie na Windows.

Tip

Otvorte file:///` vo webovom prehliadači, prejdite na umiestnenie úložiska a skopírujte ho ako URL vzdialeného úložiska.

Výpis rozšírení HTML

Príkaz server-generate môže voliteľne vytvoriť jednoduchú webovú stránku použitím argumentu --html.

blender --command extension server-generate --repo-dir=/path/to/packages --html

Tým sa vytvorí súbor index.html, ktorý je pripravený na použitie a obsahuje výpis rozšírení, ktoré možno vložiť do Blenderu na inštaláciu.

Odkazy na stiahnutie

Aby bolo možné podporovať inštaláciu zo vzdialeného úložiska metódou ťahaj a pusť, existuje niekoľko voliteľných spôsobov prípravy adries URL.

Jedinou prísnou požiadavkou je, že adresa URL na stiahnutie musí končiť na .zip.

Adrese URL môžete odovzdať rôzne argumenty, aby ste Blenderu poskytli viac informácií o tom, čo má s upustenou adresou URL urobiť.

úložisko:

Odkaz na súbor JSON, ktorý sa použije na inštaláciu úložiska v Blenderi. Podporuje relatívne adresy URL.

platforms:

Zoznam podporovaných platforiem oddelený čiarkami. Ak sa vynechá, rozšírenie bude k dispozícii vo všetkých operačných systémoch.

blender_version_min:

Minimálna podporovaná verzia Blenderu, napr. 4.2.0.

blender_version_max:

Verzia Blenderu, ktorú rozšírenie nepodporuje, staršie verzie sú podporované.

Tip

Čím viac informácií poskytnete, tým lepší bude užívateľský zážitok.

S výnimkou úložiska možno všetky ostatné parametre získať z manifestu rozšírení. Tieto argumenty sa majú zakódovať ako súčasť adresy URL.

Očakávaný formát:

{URL}.zip?repository={repository}&blender_version_min={version_min}&blender_max={version_max_exclusive}&platforms={platform1,platform2}

Príklad zo svojho hosťovaného úložiska:

http://my-site.com/my-addon.zip?repository=.%2Findex.json&blender_version_min=4.2.0&platforms=windows-x64

Príklad z platformy Rozšírenia:

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

Poznámka

%2F a %2C sú jednoducho url kódované ekvivalenty / a ,.