Dexterous Developer

Rust 的模块化热重载系统。

最新版本的文档可在：https://lee-orr.github.io/dexterous_developer/ 获取

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

特性

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

Bevy 特定

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

未来工作

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

安装

通过运行以下命令安装CLI: cargo install dexterous_developer_cli。这会安装2个命令行工具

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

设置

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

[features]
hot = ["dexterous_developer/hot"]

[dependencies]
bevy = "0.14"
dexterous_developer = { version = "0.4.0-pre.0", features = ["bevy"] }
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（可选地传递特定的包或示例）。

要在不同机器（具有相同平台）上运行应用程序，请在这两台机器上安装dexterous_developer_cli，然后在开发机器上

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

不使用热重载运行或构建

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

灵感

最初的灵感来自DGriffin91的Ridiculous bevy hot reloading

Bevy版本支持