crank

Crank 是为在Playdate便携式游戏机上用Rust开发游戏时包装 cargo 的工具。这是一个工具，实际上Playdate的Rust包装器可以在其自己的仓库中找到。

该软件不是由 Panic 赞助或支持的。

要求

• 在 Linux 或 MacOS 上的 $HOME/Developer/PlaydateSDK 或 Windows 上的 $HOME/Documents/PlaydateSDK 中安装了 Playdate SDK，或者是在 $PLAYDATE_SDK 环境变量指定的路径。
• Rust，最简单的安装方式是rustup。
• 使用 rustup toolchain install nightly 切换到夜间工具链，这是 build-std 功能所需的。
• 如果您想为 Playdate 设备构建，则需要 thumbv7em-none-eabihf 目标。可以通过 rustup +nightly target add thumbv7em-none-eabihf 添加。
• 所有要求都列在 Inside Playdate with C 中。

安装

由于 crank 还不在 crates.io 上，需要使用 git 下载并使用 cargo 安装。

cargo install --git=https://github.com/pd-rs/crank

之后应该能够运行 crank

crankstart $ crank build -h
crank-build 0.1.0
Build binary targeting Playdate device or Simulator

USAGE:
    crank build [FLAGS] [OPTIONS]

FLAGS:
        --device     Build for the Playdate device
    -h, --help       Prints help information
        --release    Build artifacts in release mode, with optimizations
        --run        Run
    -V, --version    Prints version information

OPTIONS:
        --example <example>                Build a specific example from the examples/ dir
        --manifest-path <manifest-path>    Path to Cargo.toml

命令 build 稍有些误导，因为它既构建，也创建了一个 .pdx 目录，并在模拟器或设备上运行游戏。

为了包含图像等资源，Crank可以选择读取一个Crank.toml文件，该文件包含要包含在.pdx目录中的文件列表。请参阅包装仓库中的示例。

Crank仅在Mac上定期测试，但过去在Windows和Linux上也能工作。