godot-cpp

godot-cpp

[!NOTE]

对于 GDNative（Godot 3.x），请切换到 3.x 或 3.6 分支。

此仓库包含 Godot Engine 的 GDExtensions API 的 C++ 绑定。

• 版本管理
• 兼容性
• 贡献
• 快速入门
• 示例与模板

版本管理

从 10.x 版本开始，godot-cpp 独立于 Godot 进行版本管理。 通过 api_version 参数（见下文），godot-cpp v10 可以针对 Godot 4.3 或更高版本。

兼容性

针对较早版本 Godot 的 GDExtensions 应能在较新的次要版本中正常工作，但反之则不然。例如，针对 Godot 4.3 的 GDExtension 在 Godot 4.4 中应能正常运行，但针对 Godot 4.4 的则无法在 Godot 4.3 中工作。

你可以通过 api_version 选项指定目标版本：

scons api_version=4.3

...或通过提供由你目标 Godot 版本生成的定制 extension_api.json：

godot --dump-extension-api
scons custom_api_file=extension_api.json

扩展作者可以通过将默认目标 API 版本传递给 godot-cpp 的 SConstruct 来提供，例如：

env = SConscript("godot-cpp/SConstruct", {"api_version": "4.7"})

这非常推荐!它允许扩展作者确保他们的扩展使用提供了所有必要功能的版本。