扩展的命令行参数#
用于管理 Blender 扩展的命令。
- 选项:
- -h, --help
显示帮助信息然后退出
子命令:
包管理#
子命令:list
#
用法:
blender --command extension list [-h] [-s]
从所有启用的存储库列出包。
- 选项:
- -h, --help
显示帮助信息然后退出
- -s, --sync
在执行动作之前同步远程目录。
子命令:sync
#
用法:
blender --command extension sync [-h]
下载远程存储库的包信息。
- 选项:
- -h, --help
显示帮助信息然后退出
子命令:update
#
用法:
blender --command extension update [-h] [-s]
下载并更新任意过时的包。
- 选项:
- -h, --help
显示帮助信息然后退出
- -s, --sync
在执行动作之前同步远程目录。
子命令:install
#
用法:
blender --command extension install [-h] [-s] [-e] [--no-prefs]
PACKAGES
- 位置参数:
- PACKAGES:
要操作的软件包(用
,
分隔,不要有空格)。
- 选项:
- -h, --help
显示帮助信息然后退出
- -s, --sync
在执行动作之前同步远程目录。
- -e, --enable
在安装后启用扩展。
- --no-prefs
将用户偏好设置视为只读,防止对其进行修改操作。这意味着删除扩展或存储库等操作不会更新用户设置。
子命令:install-file
#
用法:
blender --command extension install-file [-h] -r REPO [-e] [--no-prefs]
FILE
安装一个包文件到用户存储库。
- 位置参数:
- FILE:
包文件。
- 选项:
- -h, --help
显示帮助信息然后退出
- -r REPO, --repo REPO
存储库标识符。
- -e, --enable
在安装后启用扩展。
- --no-prefs
将用户偏好设置视为只读,防止对其进行修改操作。这意味着删除扩展或存储库等操作不会更新用户设置。
子命令:remove
#
用法:
blender --command extension remove [-h] [--no-prefs] PACKAGES
禁用 & 移除包。
- 位置参数:
- PACKAGES:
要操作的软件包(用
,
分隔,不要有空格)。
- 选项:
- -h, --help
显示帮助信息然后退出
- --no-prefs
将用户偏好设置视为只读,防止对其进行修改操作。这意味着删除扩展或存储库等操作不会更新用户设置。
存储库管理#
子命令:repo-list
#
用法:
blender --command extension repo-list [-h]
列出所有保存在 Blender 偏好设置里的存储库。
- 选项:
- -h, --help
显示帮助信息然后退出
子命令:repo-add
#
用法:
blender --command extension repo-add [-h] [--name NAME]
[--directory DIRECTORY]
[--url URL]
[--access-token ACCESS_TOKEN]
[--source SOURCE]
[--cache BOOLEAN] [--clear-all]
[--no-prefs]
ID
添加新的本地或远程存储库。
- 位置参数:
- ID:
存储库标识符。
- 选项:
- -h, --help
显示帮助信息然后退出
- --name NAME
要显示在界面内的名称(可选)。
- --directory DIRECTORY
存储库的本地文件目录(可选)。如果省略,将自动选择用户目录中的一个。
- --url URL
The URL, for remote repositories (optional). When omitted the repository is considered "local" as it is not connected to an external repository, where packages may be installed by file or managed manually.
- --access-token ACCESS_TOKEN
The access token to use for remote repositories which require a token.
- --source SOURCE
The type of source in ('USER', 'SYSTEM'). System repositories are managed outside of Blender and are considered read-only.
- --cache BOOLEAN
使用包缓存(默认为 1 )。
- --clear-all
Clear all repositories before adding, simplifies test setup.
- --no-prefs
将用户偏好设置视为只读,防止对其进行修改操作。这意味着删除扩展或存储库等操作不会更新用户设置。
子命令:repo-remove
#
用法:
blender --command extension repo-remove [-h] [--no-prefs] ID
移除一个存储库。
- 位置参数:
- ID:
存储库标识符。
- 选项:
- -h, --help
显示帮助信息然后退出
- --no-prefs
将用户偏好设置视为只读,防止对其进行修改操作。这意味着删除扩展或存储库等操作不会更新用户设置。
扩展创建#
子命令:build
#
用法:
blender --command extension build [-h] [--source-dir SOURCE_DIR]
[--output-dir OUTPUT_DIR]
[--output-filepath OUTPUT_FILEPATH]
[--valid-tags VALID_TAGS_JSON]
[--split-platforms] [--verbose]
在当前目录下构建一个包。
- 选项:
- -h, --help
显示帮助信息然后退出
- --source-dir SOURCE_DIR
The package source directory containing a
blender_manifest.toml
manifest.默认设为当前目录。
- --output-dir OUTPUT_DIR
包输出目录。
默认设为当前目录。
- --output-filepath OUTPUT_FILEPATH
包输出文件路径(需包含一个
.zip
扩展名)。Defaults to
{id}-{version}.zip
using values from the manifest.- --valid-tags VALID_TAGS_JSON
Reference a file path containing valid tags lists.
If you wish to reference custom tags a
.json
file can be used. The contents must be a dictionary of lists where thekey
matches the extension type.- 例如:
{"add-ons": ["Example", "Another"], "theme": ["Other", "Tags"]}
To disable validating tags, pass in an empty path
--valid-tags=""
.- --split-platforms
Build a separate package for each platform. Adding the platform as a file name suffix (before the extension).
This can be useful to reduce the upload size of packages that bundle large platform-specific modules (
*.whl
files).- --verbose
Include verbose output.
子命令:validate
#
用法:
blender --command extension validate [-h]
[--valid-tags VALID_TAGS_JSON]
[SOURCE_PATH]
Validate the package meta-data in the current directory.
- 位置参数:
- SOURCE_PATH:
The package source path (either directory containing package files or the package archive). This path must containing a
blender_manifest.toml
manifest.Defaults to the current directory.
- 选项:
- -h, --help
显示帮助信息然后退出
- --valid-tags VALID_TAGS_JSON
Reference a file path containing valid tags lists.
If you wish to reference custom tags a
.json
file can be used. The contents must be a dictionary of lists where thekey
matches the extension type.- 例如:
{"add-ons": ["Example", "Another"], "theme": ["Other", "Tags"]}
To disable validating tags, pass in an empty path
--valid-tags=""
.
子命令:server-generate
#
用法:
blender --command extension server-generate [-h] --repo-dir REPO_DIR
[--html]
[--html-template HTML_TEMPLATE_FILE]
Generate a listing of all packages stored in a directory. This can be used to host packages which only requires static-file hosting.
- 选项:
- -h, --help
显示帮助信息然后退出
- --repo-dir REPO_DIR
远程存储库目录。
- --html
Create a HTML file (
index.html
) as well as the repository JSON to support browsing extensions online with static-hosting.- --html-template HTML_TEMPLATE_FILE
An optional HTML file path to override the default HTML template with your own.
The following keys will be replaced with generated contents:
${body}
is replaced the extensions contents.${date}
is replaced the creation date.