扩展的命令行参数#

用于管理 Blender 扩展的命令。

选项:
-h, --help

显示帮助信息然后退出

子命令:

包管理
list:

列出所有包。

sync:

与远程存储库同步。

update:

更新任意过时的包。

install:

安装包。

install-file:

从文件安装包。

remove:

移除包。

存储库管理
repo-list:

列出存储库。

repo-add:

添加存储库。

repo-remove:

移除存储库。

扩展创建
build:

构建一个包。

validate:

验证一个包。

server-generate:

从所有的包创建一个列表。

包管理#

子命令: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 the key 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 the key 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.