Windows

1. 安装PlaydateSDK（默认安装到~/Documents/PlaydateSDK）
2. 设置PLAYDATE_SDK_PATH
   1. 按windows+r，运行: sysdm.cpl
   2. 高级选项卡 -> 环境变量 -> 新建
   3. 变量名称: PLAYDATE_SDK_PATH
   4. 变量值: C:\Users\username\Documents\PlaydateSDK
3. 安装CMake: cmake下载
4. 安装 rust nightly： rustup toolchain install nightly
5. 安装arm工具链: arm gnu工具链下载。文件名将类似于 'arm-gnu-toolchain-13.2.rel1-mingw-w64-i686-arm-none-eabi.exe'。
6. 将arm工具链和cmake添加到PATH环境变量
   1. 按windows+r，运行: sysdm.cpl
   2. 高级选项卡 -> 环境变量。
   3. 找到Path并点击编辑
   4. 点击新建并添加C:\Program Files\CMake\bin
   5. 点击新建并添加C:\Program Files (x86)\Arm GNU Toolchain arm-none-eabi\13.2 Rel1\bin

另请参阅: Inside Playdate with C: Prerequisites

Cargo-Playdate安装

cargo +nightly install cargo-playdate
cargo +nightly playdate --version

或者安装使用本地git克隆的尖端功能

cargo +nightly install cargo-playdate --git=https://github.com/boozook/playdate.git

Hello World

使用new或init命令生成新项目。

mkdir -p ~/code/pd-hello/
cd ~/code/pd-hello/
cargo +nightly playdate init --lib --full-metadata --deps="playdate"
cargo +nightly playdate run

注意，此命令有更多选项，例如--deps="sys:git, controls:git"。运行cargo playdate new --help以获取更多信息。

将创建新的包。

查看包清单文件（Cargo.toml）。

Playdate包有额外的元数据。

有关元数据的更多信息，请参阅文档。

配置

没有其他配置，只是继承自cargo和某些特殊环境变量。

• CARGO_PLAYDATE_LOG与CARGO_LOG或默认的RUST_LOG作用相同。还有CARGO_PLAYDATE_LOG_STYLE
• PLAYDATE_SDK_PATH指向SDK根目录
• ARM_GCC_PATH指向arm-none-eabi-gcc可执行文件。

运行cargo playdate -h获取更多详细信息，或者使用--help获取更多信息。

限制

• cargo-playdate支持cargo的自动目标，如bin和example，但仅限于二进制可执行目标，忽略#![crate_type = "lib"]属性。因此，如果您想将example目标作为lib构建，这需要在模拟器中运行，您可以在包清单中声明它，如下所示

  [[example]]
  name = "demo"
  crate-type = ["dylib", "staticlib"]
  path = "examples/demo.rs"
  

  否则，example 将会被构建为 bin 并仅能在设备上运行。在未来版本中，可能会通过添加对 rustc 命令的支持来修复此问题，就像添加 cargo rustc 到设置 --crate-type 一样。

• 特别为 example 定制的 cargo-targets 继承自包资产。目前尚无方法为单个 cargo-target 设置资产，只能为整个包 以及 dev-targets - 有一个由包资产继承的额外表 dev-assets。

故障排除

• 在任何操作系统上，如果硬件因权限不足而无法弹出，则可能是因为环境受限。尝试给予权限和/或使用具有功能 eject 的 cargo-playdate 构建。

• 欢迎加入 讨论 和 问题。

本软件不受 Panic 的赞助或支持。