Skapa ett arkiv för statiska tillägg¶
För att vara värd för dina egna tillägg och utnyttja Blenders uppdateringssystem krävs det bara att du är värd för en statisk JSON-fil som genereras av Blender.
JSON¶
För att generera en giltig JSON-fil använd kommandoradsverktyget server generate i Blender:
blender --command extension server-generate --repo-dir=/path/to/packages
Detta skapar en index.json-lista från alla .zip-tillägg som finns på platsen –repo-dir.
För mer information, läs den genererade JSON API.
Testar¶
För att testa det genererade arkivet lägger du till ett nytt Remote Repository i inställningarna:
Hämta tillägg → Förråd → [+] → Lägg till fjärrförråd
Klistra in platsen för den genererade JSON-filen som URL. Så exemplet /path/to/packages skulle använda:
file:///path/to/packages/index.json på Linux och macOS.
file:///C:/path/to/packages/index.json på Windows.
file://HOST/share/path/to/packages/index.json för nätverksandelar på Windows.
Tips
Öppna file:/// i en webbläsare och navigera till förrådets plats och kopiera den som URL för fjärrförrådet.
Tillägg Lista HTML¶
Med kommandot server-generate kan du skapa en enkel webbplats med hjälp av argumentet –html.
blender --command extension server-generate --repo-dir=/path/to/packages --html
Detta skapar en index.html-fil som är klar att använda, med en lista över tillägg som kan släppas in i Blender för installation.
Länkar för nedladdning¶
För att stödja dra och släpp för installation från ett fjärrarkiv finns det några valfria sätt att förbereda webbadresserna.
Det enda strikta kravet är att URL:en för nedladdning måste sluta på .zip.
Du kan skicka olika argument till URL:en för att ge fler ledtrådar till Blender om vad som ska göras med den tappade URL:en.
- förråd:
Länk till JSON-filen som ska användas för att installera förrådet i Blender. Stödjer relativa webbadresser.
- plattformar:
Kommaseparerad lista över plattformar som stöds. Om den utelämnas kommer tillägget att vara tillgängligt i alla operativsystem.
- blender_version_min:
Lägsta version av Blender som stöds, t.ex. 4.2.0.
- blender_version_max:
Blender-version som tillägget inte stöder, tidigare versioner stöds.
Tips
Ju mer information du lämnar, desto bättre blir användarupplevelsen.
Med undantag för repository kan alla andra parametrar hämtas från tilläggsmanifestet. Dessa argument ska kodas som en del av URL:en.
- Förväntat format:
{URL}.zip?repository={repository}&blender_version_min={version_min}&blender_max={version_max_exclusive}&platforms={platform1,platform2}
- Exempel från ett självhanterat arkiv:
http://my-site.com/my-addon.zip?repository=.%2Findex.json&blender_version_min=4.2.0&plattformar=windows-x64
- Exempel från Extensions-plattformen:
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
Observera
%2F och %2C är helt enkelt den url-kodade motsvarigheten till / respektive ,.