SuperAPI AI 工具集

bevy-cargo-features

编程与开发

查看项目

更新于 10-15 17:33

技能介绍

用途:在 Bevy 0.19 中挑选受支持的 Cargo 特性组合,避免启用完整默认集;用于组合自定义渲染器或无头服务端,启用本机手柄输入、窗口/输入 API 或浏览器渲染,以及排查关闭默认特性后缺失的类型与插件。

主要能力:Bevy 默认集为 2d + 3d + ui + audio,选择配置档必须关闭默认特性,例如:[features = "3d", "ui"] 且 default-features = false。启用 default-features 时只写 features = ["3d"] 不会裁剪任何内容,因为 Cargo 会并集合并特性集。特性分四层:配置档 2d/3d/ui/audio;内置渲染 2d_bevy_render/3d_bevy_render/ui_bevy_render;仅 API 2d_api/3d_api/ui_api(不含渲染后端,不能绘制,供自定义或外部渲染器消费 Bevy 世界侧类型);基线 default_app/default_platform;以及 scene、picking、dev 等分组集合。

使用方式:无头服务端可用 default-features = false 加 default_app、multi_threaded、serialize,必要时才加 bevy_world_serialization,并用 MinimalPlugins。自定义渲染器可用 default_app + 3d_api,需要内置渲染时改用 3d_bevy_render。柄柄发现/输入需启用 bevy_gilrs(它同时启用 gamepad),仅 gamepad 不是平台后端。浏览器配置档可含 3d、ui、touch,webgpu 会覆盖 webgl2,需单独构建 WebGPU 产物。

限制与陷阱:0.19 中 2d/3d 不再隐含 ui,需显式加 ui;2d/3d/ui 不再隐含 audio;scene 同时启用 bevy_world_serialization 与新的 BSN bevy_scene;dev、dynamic_linking、文件监听、tracing、开发工具应放在开发特性后,避免误发布。本机 Linux 窗口后端为 x11 和 wayland,不要杜撰 windows 或 macos 的 Bevy 特性名。仅当编译时间、二进制体积或自定义渲染器值得维护成本时才用低层集合。其余内容暂未提供。