#godot #module #command-line #gdnlib #nativescript #rust

app godot-rust-cli

为您的Godot项目提供了一种方便使用Rust的方法

8个不稳定版本 (3个破坏性版本)

0.4.0 2021年7月10日
0.3.1 2021年6月22日
0.2.0 2021年6月5日
0.1.3 2021年4月2日
0.1.2 2021年2月12日

#926 in 游戏开发

每月下载24

MIT许可证

85KB
1.5K SLoC

Godot Rust CLI

Godot Rust CLI是一种易于将Rust模块集成到您的Godot项目中的工具。

main workflow Crates.io Crates.io Crates.io Discord

注意:Godot Rust CLI版本低于v1.0.0,可能存在错误,请在GitHub仓库中报告任何错误,或者在Discord中自由提问。

请注意,主分支通常会领先于crates.io上的版本。

目录

简介

注意:Godot Rust CLI版本低于v1.0.0,可能存在错误,请在GitHub仓库中报告任何错误。

Godot Rust CLI是一个简单的命令行界面,可以帮助您创建和更新Godot项目的Rust组件。

在您的Godot项目中使用Rust对于性能关键的代码非常出色,而Godot Rust CLI可以帮助您在Rust中创建整个项目,或者与新的或现有的gdscript混合。

目前,Godot Rust CLI支持为Windows、MacOS和Linux创建Rust模块。如果您需要其他平台的支持,请将请求作为GitHub仓库中的问题提出,如果可能的话,将会添加支持。

注意:Godot Rust CLI是Godot Rust Helper的继任者。Godot Rust CLI旨在更加简单,但更加严格。这也意味着Godot Rust CLI功能较少,并强制执行更加严格的项目结构。

先决条件

Godot Rust CLI需要以下先决条件

  • bindgen - 这是为了构建所需的gdnative存储库所必需的,因此您应该按照说明为您的操作系统安装它。

  • Rust的最新版本。

  • rustfmt - 这是为了在创建/编辑文件后格式化文件所必需的。您可以使用以下命令安装它:rustup component add rustfmt

安装

要安装Godot Rust CLI,请使用

cargo install godot-rust-cli

要升级您的Godot Rust CLI版本到最新版本,请使用

cargo install --force godot-rust-cli

教程

  1. 基本用法
  2. 创建Godot插件
  3. 平台(实验性)

命令参考

兼容性

Godot Rust 版本 Godot Rust CLI 版本
0.9.1 >=0.1.1
0.9.3 >=0.2.0

更新

0.1.x 到 0.2.x

要将您的项目更新到与 0.2.x 版本兼容,您需要将您的 project.toml 文件重命名为 godot-rust-cli.toml

0.2.x 到 0.3.x

库已从 toml 配置切换到 json 配置,因此如果您想更新您的库,建议检查 json 配置的样式,并更新本地配置以匹配。

正在开发一个工具,以使在主要更改之间升级更容易。如果您需要帮助,问题和疑虑始终欢迎在 Discord 上提出。

如果您正在开发插件,很遗憾没有升级的方法而不创建一个新的项目,因为插件创建经过了重大改版。

问题

查看 Discord 以提出有关 CLI 或 Godot + Rust 的任何问题或疑虑。

许可证

MIT

依赖项

~6–16MB
~194K SLoC