扩展打包与安装

扩展打包与安装

功能

bt ext 是 BT 扩展工具链，用于创建扩展项目、构建 .bts 包、安装到项目、查看包信息和执行加载检查。

命令

参数

返回值

bt ext 是命令行工具，不向 BT 脚本返回值。命令成功时输出中文结果；命令失败时输出中文错误并返回失败状态。

打包规则

bt ext build 会收集开发目录中的普通文件，并跳过：

打包时会限制 .bts 包条目数量、单文件大小、总解压大小和包内路径。写出 zip 后，工具会回读 .bts 并初始化对应 Runner，确保包能被运行时加载。

安装规则

安装命令：

会把扩展复制到：

目标文件名来自 manifest.name，不是命令行传入的文件名。

代码示例

完整纯 BT 扩展流程：

安装后项目脚本调用：

注意事项

• bt ext new 不会覆盖非空目录。
• bt ext build 的输出路径如果位于开发目录内，工具会避免把输出包再次打进包里。
• bt ext install 会覆盖目标项目中同名 .bts 包。
• 扩展 CLI 命令成功时会向终端输出构建、安装或检查结果；失败时输出中文错误，不会生成可部分加载的 .bts 包。
• bt ext 需要运行用的 BT 构建启用 extensions feature。