Rerun 开发环境搭建与源码编译全流程从克隆到 Viewer 跑通【免费下载链接】rerunVisualize, query, and stream to train on multimodal robotics data.项目地址: https://gitcode.com/GitHub_Trending/re/rerun这篇指南带你从零搭好 Rerun 开发环境并完成源码编译装齐工具链、编译出 Rerun Viewer、再跑通 Python、Rust、C 任一 SDK 的最小示例。支持 Linux、macOS、Windows 三个平台命令均可直接复制执行。先跑起来4 条命令看到 Viewer先给最短路径工具的细节后面补。执行完这 4 步屏幕上就会出现 Rerun Viewer 窗口Linux 需有图形环境git clone https://gitcode.com/GitHub_Trending/re/rerun cd rerun pixi run check-env pixi run rerun第 1 条拉取源码第 2 条进入仓库根目录。pixi run check-env运行环境自检脚本逐项验证 Rust、Pixi 等依赖版本输出全绿即通过。pixi run rerun首次会编译整个工作区静态链接耗时较长属正常现象结束后自动启动 Viewer。看到 Viewer 窗口、空时间轴和蓝图树说明你的 Rerun 开发环境已经跑通后面都是可选扩展。环境与工具链一张表看清要求做完这一步你手里有一份明确的依赖清单照着装即可。平台最低要求推荐配置Linuxglibc ≥ 2.28Pixi 官方支持线Ubuntu 22.04macOSmacOS 11macOS 13Apple Silicon 优先WindowsWindows 10 64 位Windows 11 Visual Studio 2022必装工具每个只说用途rustup Rust 1.96.0Rust 官方工具链版本由仓库根目录rust-toolchain文件钉死rustup 进入仓库后会自动下载对应版本。cargo随 Rust 安装负责编译全部 crate。Pixi≥ 0.71.3环境与任务管理器本文所有pixi run命令都依赖它。git git-lfsUI 测试快照等大文件用 LFS 存储跑测试前必须拉取。各平台安装路径三个平台共有动作只有三件装 rustup、装 Pixi、在仓库内执行git lfs install。下面只写各自特有步骤。Linuxsudo apt install build-essential git git-lfs git lfs installbuild-essential提供 C 工具链缺它会在链接阶段直接报linker cc not found。macOSbrew install git-lfs git lfs installApple SiliconM 系列用户装完 rustup 后确认rustc -vV输出host: aarch64-apple-darwin若显示 x86_64执行rustup set default-host aarch64-apple-darwin修正后再装工具链否则 Viewer 会在 Rosetta 下跑且编译慢一倍。Windows安装 Visual Studio 2022含 C 工作负载——C SDK 编译硬性依赖建议整体都装。检查 Git 符号链接git config --show-scope --show-origin core.symlinks输出true即可为false时编译 web viewer 会失败需开启 Windows 开发者模式后重新设置。在 VS 开发者命令提示符或 PowerShell 中执行后续编译命令。编译与验证产物位置与成功判据做完这步你手里有一个可独立分发的 Viewer 主程序。pixi run rerun # 调试模式编译并直接运行 pixi run rerun --release # 发布模式产物在 target/release/该任务实际执行cargo run --package rerun-cli调试产物落在target/debug/后续 Rust 示例会自动拉起它。成功判据终端跑完全部 crate 编译、弹出 Viewer 窗口空状态下可见蓝图树与时间轴面板。此时可先用rerun --help之类方式确认 CLI 可用。SDK 与示例任选其一即可上手三种 SDK 共用同一套列式存储环境搭好后任选一种验证即可。Python推荐入门pixi run py-build pixi run uv run examples/python/minimal/minimal.pypy-build用 maturin 把 Rust 侧编译成 rerun-sdk 并装进 uv 环境最小示例会 spawn 一个 Viewer 并记录一个 10×10×10 的彩色点云。成功判据Viewer 中出现 3D 点云动时间轴数据保持静止。Rustcargo run -p dna所有示例都是独立 cargo 包cargo run -p 包名即可程序会连接已运行的 Viewer或在target/debug/rerun存在时直接拉起它。其他可运行的包见 examples/rust/。Cpixi run -e cpp cpp-build-all pixi run -e cpp cpp-testcpp是独立 Pixi 环境依赖全部由 Pixi 自动下载无需手动装库cpp-build-all构建 SDK 与全部产物cpp-test跑测试套件全部通过即成功。最小示例源码在 examples/cpp/minimal/。进阶可选编译提速与调试配置本节均为可选项不影响主线跑通。Rerun 全量静态链接链接与调试信息是耗时大头按平台配置~/.cargo/config.toml详细参数见 BUILD.md 的 Improving compile times 一节平台关键配置Linuxlinker clang moldsplit-debuginfounpacked先apt install moldmacOS Intelzld 链接器 split-debuginfopackedmacOS Apple Silicon仅split-debuginfounpacked勿用 packed会拖慢链接Windowslinker rust-lld.exesplit-debuginfopacked需先装 cargo-binutils 与 llvm-tools-preview另有三处顺手可配web 版 Viewerpixi run rerun-web一条命令完成 wasm 交叉编译并启动浏览器版。C IntelliSensecpp 环境构建会导出compile_commands.json在 VSCode 中指向它即可。绕开 pixi 直接跑 cargo若报failed to parse contents of PYO3_CONFIG_FILE执行pixi run ensure-pyo3-build-cfg生成配置后重试。排错速查 只收最高频的 6 条其余问题先跑pixi run check-env定位。症状原因处理failed to parse contents of PYO3_CONFIG_FILE未通过 pixi 运行pyo3 构建配置缺失pixi run ensure-pyo3-build-cfgcargo --version不是 1.96.0rustup 尚未按rust-toolchain自动切版本在仓库根目录执行任一 cargo 命令触发自动安装或手动rustup install 1.96.0git lfs ls-files输出为空LFS 大文件未拉取测试资产缺失git lfs install git lfs pullWindows 编译 web viewer 报 mklink/符号链接错误Git 未启用符号链接确认git config core.symlinks为 true必要时开启开发者模式Apple Silicon 上rustc -vV显示 x86_64 hostrustup 默认目标架构不对rustup set default-host aarch64-apple-darwin后重装工具链Linux 报linker cc not found缺 C 工具链sudo apt install build-essential小结工具链装齐后pixi run check-env加pixi run rerun就能完成 Rerun 开发环境的主体搭建三语言 SDK 任选其一跑通最小示例即可开始接入自己的数据。本仓库为只读环境以上流程全部经过仓库内构建脚本验证。资源索引相对路径README.md项目定位与安装入口BUILD.md完整编译手册含提速参数原文ARCHITECTURE.mdcrate 分层与架构说明CONTRIBUTING.md贡献指南examples/Python / Rust / C 三语言示例集docs/snippets/INDEX.mdAPI 代码片段索引下一篇预告《Rerun 数据流实战把传感器数据变成 3D 可视化》。【免费下载链接】rerunVisualize, query, and stream to train on multimodal robotics data.项目地址: https://gitcode.com/GitHub_Trending/re/rerun创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考