扩展的命令行参数#

用于管理 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

远程存储库的 URL(可选)。省略后,存储库将被视为 “本地” 库,因为它没有连接到外部源,软件包可以通过文件安装或手动管理。

--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.