Створення Сховища Статичних Розширень¶
Щоб розмістити ваше власне розширення та запустити важіль оновлення системи Blender, все, що потрібно це розмістити статичний JSON файл, який згенерований Blender.
JSON¶
Щоб згенерувати правильний JSON файл використовуйте server generate Blender інструмент командного рядка:
blender --command extension server-generate --repo-dir=/path/to/packages
Це створить index.json перераховуючи всі .zip розширення знайдені в розташуванні –repo-dir.
Для більших подробиць, прочитайте згенерований JSON API.
Тестування¶
Щоб протестувати згенероване сховище, додайте нове Віддалене Сховище з Налаштувань:
Отримати Розширення → Сховища → [+] → Додати Віддалене Сховище
Вставте розташування згенерованого JSON як URL-адресу. Приклад
/path/to/packagesбуде використовувати:file:///path/to/packages/index.jsonна Linux та macOS.file:///C:/path/to/packages/index.jsonна Windows.file://HOST/share/path/to/packages/index.jsonдля мережевих обмінів Windows.
Порада
Відкрийте file:/// у веб браузері та пройдіть до місця сховища та скопіюйте це як URL-адресу віддаленого сховища.
HTML Перерахування Розширень¶
Команда server-generate може опціонально створити звичайний вебсайт використовуючи --html аргумент.
blender --command extension server-generate --repo-dir=/path/to/packages --html
Це створить index.html файл готовий для використання, перераховуючи розширення які можуть бути скинуті в Blender для встановлення.
Завантажити Посилання¶
Щоб мати можливість тягнути та скинути для встановлення з віддаленого сховища, є декілька опціональних шляхів, щоб підготувати URL-адреси.
Є тільки одна важлива вимога, те що URL-адреса для завантаження повинна закінчуватись на .zip.
Ви можете надати різні аргументи до URL-адреси, щоб дати більше підказок для Blender, про те що робити зі скинутою URL-адресою.
- сховище:
Посилання на JSON файл який буде використовуватись для встановлення сховища в Blender. Підтримує відносні URL-адреси.
- платформи:
Список розділений комою підтримуваних платформ. Якщо пропущено, розширення буде доступне у всіх операційних системах.
- blender_version_min:
Мінімальна підтримувана версія Blender, приклад
4.2.0.- blender_version_max:
Версія Blender, що не підтримує розширення, нижчі версії підтримуються.
Порада
Чим більше подробиць ви додаєте, тим краще буде досвід користувача.
З винятком repository, всі інші параметри можуть бути добуті з маніфесту розширень. Ці аргументи будуть закодовані як частина URL-адреси.
- Очікуваний формат:
{URL}.zip?repository={repository}&blender_version_min={version_min}&blender_max={version_max_exclusive}&platforms={platform1,platform2}- Приклад з само-розміщеного сховища:
http://my-site.com/my-addon.zip?repository=.%2Findex.json&blender_version_min=4.2.0&platforms=windows-x64- Приклад з Платформи Розширень:
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Примітка
%2Fта%2Cє просто url-закодованим еквівалентом/та,відповідно.