Dexterous Developer

Rust 的模块化热重载系统。

最新版本的文档可在以下地址找到：https://lee-orr.github.io/dexterous_developer/

您还可以找到 最新预发布版本的文档 和 主分支的文档

功能

• 一个用于构建和运行可重载的 Rust 项目的 CLI 工具，包括通过网络（跨设备）
• 直接与二进制crate工作！
• 序列化/反序列化元素的能力，允许随着时间的推移演进模式
• 仅在您明确启用时才将热重载功能包含在您的构建中 - 例如，通过使用 CLI 启动器
• 创建适配器以支持其他框架的能力，使您可以使用 Dexterous Developer 工具与其他工具一起使用。
• 包括第一个 Bevy 适配器
• 在 Windows、Linux 和 MacOS 上运行
• 在 Linux 上，可以在主操作系统上运行时在开发容器内进行开发，从而可以使用开发容器进行游戏和其他 GUI 应用程序的开发。

Bevy 特定功能

• 明确定义您游戏中可重载的区域 - 可以包括系统、组件、事件和资源（有一些限制）
• 在重载时将资源重置为默认值或预定的值
• 序列化/反序列化您可重载的资源组件，允许您在它们与反序列化器兼容的情况下演进其模式（使用 rmp_serde）
• 标记实体以便在热重载时删除
• 在热重载后运行系统
• 创建函数以在进入/退出状态或热重载时设置和拆除

未来工作

• 跨平台热重载 - 在开发环境中运行“热重载服务器”，并在不同的操作系统上执行应用程序
• 移动支持
• 基于浏览器的WASM支持
• WASI支持
• 使用中间编译结果修补正在运行的库
• 除了当前的动态库方法之外，支持使用进程间通信
• 应添加基于GUI的启动器，特别是针对移动设备
• 支持在bevy中使用ECS钩子和观察者

安装

通过运行以下命令安装CLI： cargo install [email protected]。这安装了2个命令行工具

• dexterous_developer_cli - 用于构建项目，可能同时运行
• dexterous_developer_runner - 用于在另一台设备上运行项目

设置

您还需要将适当的dexterous开发者适配器添加到库的依赖项中，并设置“热”功能。例如，如果您正在使用bevy

[features]
hot = ["bevy_dexterous_developer/hot"]

[dependencies]
bevy = "0.14"
bevy_dexterous_developer = { version = "0.4.0-alpha.3"}
serde = "1" # If you want the serialization capacities

最后，您需要设置一个Dexterous.toml文件，它有助于定义一些必要的元素 - 例如哪些文件夹应该被监视以更改，以及应启用哪些功能。有关更多信息，请参阅此存储库中的示例文件或该书籍。

Bevy设置

在您的main.rs中，您的main函数应变为

reloadable_main!((initial_plugins) {
    App::new()
        .add_plugins(initial_plugins.initialize::<DefaultPlugins>()) // You can use either DefaultPlugins or MinimnalPlugins here, and use "set" on this as you would with them
    // Here you can do what you'd normally do with app
    // ... and so on
});

如果您有一个插件，您想在其中添加可重载的元素，请在该插件定义的文件中添加以下内容

impl Plugin for MyPlugin {
    fn build(&self, app: &mut App) {
        app
            .setup_reloadable_elements::<reloadable>();
    }
}

reloadable_scope!(reloadable(app) {
    app
        .add_systems(Update, this_system_will_reload);
})

Simple Visual示例显示了库的基本用法，而该书籍也有更多信息。

使用热重载运行

要本地运行热重载应用程序，请运行cargo install并运行dexterous_developer_cli（可选地传递特定包或示例）。

要在另一台机器（具有相同平台）上运行应用程序，请在两台机器上都运行cargo install dexterous_developer_cli，然后在开发机器上

• 在开发机器上运行dexterous_developer_cli --serve-only命令
• 在目标机器上运行dexterous_developer_runner --server http://*.*.*.*:4321命令，理想情况下在专用目录中

在没有热重载的情况下运行或构建

要构建或运行不带热重载的应用程序版本，请记住避免包含hot功能，因为它是设计在可重载库内部使用的！。

灵感

最初的灵感来自DGriffin91的Ridiculous bevy热重载

Bevy版本支持