Files
BallanceBlenderHelper/docs/docs/zh-cn/tech-infos.md
2025-09-01 11:00:34 +08:00

2.2 KiB
Raw Blame History

技术信息

标准与协议文档

开发辅助包

本插件配合了fake-bpy-module模块来实现类型提示以加快开发速度。使用如下命令来安装Blender的类型提示库。

  • Blender 3.6: pip install fake-bpy-module-latest==20230627
  • Blender 4.2: pip install fake-bpy-module-latest==20240716
  • Blender 4.5: pip install fake-bpy-module-latest==20250604

这么做主要是因为fake-bpy-module没有很及时地发布适用于指定Blender版本的包因此我只能通过选择最接近Blender对应版本离开main主线时间的每日编译版本来安装它(因为每日编译版本只编译main主线)。

!!! question "为什么不采用Blender官方的bpy模块" Blender在PyPI上提供了官方的名为bpy的包但我们不会采用它作为我们的开发辅助包。因为它基本上就是将Blender打包成了一个模块也就意味着你基本上又把Blender重新下载了一遍使得你可以通过Python来操纵Blender。这与我们使用一个仅提供类型提示的包来辅助插件开发的目的相悖。

版本号规则

BBP的版本号格式遵循语义化版本。但略有区别:

  • 主版本号只在重构整个插件时提升。
  • 次版本号是常规更新使用。
  • 修订号则是在不修改任何功能的情况下递增的版本号。例如4.2.1版本仅增加了对macOS Blender的更新不更改任何功能。

在BBP发布一个正式版前通常有3个阶段性版本分别是Alpha版本Beta版本和RC版本。Alpha版本专注于功能性更新用于检验新添加或修改的功能是否正常工作不包含文档和翻译。Beta版本则专注于插件文档而RC版本则关注于插件翻译。但这三个版本并非总是存在如果更新内容较少则可能会跳过其中一些版本或直接进行发布。