扩展的命令行参数¶

用于管理 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
                                            [--repo-config REPO_CONFIG]
                                            [--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

远程存储库目录。

--repo-config REPO_CONFIG

An optional server configuration to include information which can't be detected. Defaults to blender_repo.toml (in the repository directory).

这可用于定义被阻止的扩展，例如

schema_version = "1.0.0"

[[blocklist]]
id = "my_example_package"
reason = "Explanation for why this extension was blocked"
[[blocklist]]
id = "other_extenison"
reason = "Another reason for why this is blocked"

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

扩展的命令行参数¶

包管理¶

子命令：list¶

子命令：sync¶

子命令：update¶

子命令：install¶

子命令：install-file¶

子命令：remove¶

存储库管理¶

子命令：repo-list¶

子命令：repo-add¶

子命令：repo-remove¶

扩展创建¶

子命令：build¶

子命令：validate¶

子命令：server-generate¶

子命令：`list`¶

子命令：`sync`¶

子命令：`update`¶

子命令：`install`¶

子命令：`install-file`¶

子命令：`remove`¶

子命令：`repo-list`¶

子命令：`repo-add`¶

子命令：`repo-remove`¶

子命令：`build`¶

子命令：`validate`¶

子命令：`server-generate`¶