编译与发布使用

本章给出用户侧最常用的构建与排错流程。

1. 默认构建（cc 后端）

cargo build
cargo run

2. 切换 cmake 后端

$env:ROPLAT_NATIVE_BACKEND='cmake'
cargo build

3. 回退默认后端

Remove-Item Env:ROPLAT_NATIVE_BACKEND -ErrorAction SilentlyContinue
cargo clean
cargo build

4. 发布库使用建议

当 roplat/roplat_build 已发布后，建议：

1. 使用 cargo add roplat、cargo add roplat_build --build。
2. 锁定主版本，避免无感升级。
3. 升级前先跑 cargo clippy --all-targets -- -D warnings。

5. 常见故障定位顺序

1. 依赖安装是否成功（cargo tree）。
2. build.rs 是否执行并生成目录。
3. 生成文件是否落到 cpp/roplat_gen、py/roplat_gen。
4. 用户实现文件是否在 cpp/src、py/*.py。

6. 推荐命令集合

cargo fmt
cargo test
cargo build
cargo run
cargo clippy --all-targets -- -D warnings

7. 辅助示例

可参考 examples/docs_path_lab，它用于演示路径检查与阶段排错。