5分钟上手 LiteBox

本指南将帮助你在5分钟内完成LiteBox的编译,并运行一个简单的示例程序

环境要求

支持的操作系统

Linux Windows (WSL2) macOS

运行环境

Rust >= 1.70.0 必需

所需工具

Git

克隆项目代码

必需
Cargo

Rust包管理器,通常随Rust一起安装

必需

操作步骤

1

安装Rust工具链

如果尚未安装Rust,请先安装Rust和Cargo

安装Rust(Linux/macOS)
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
使Rust环境变量生效
source $HOME/.cargo/env

预期结果::安装完成后显示 'Rust is installed now. Great!'

Windows用户建议使用WSL2或从官网下载rustup-init.exe

2

克隆项目代码

获取LiteBox源代码

克隆仓库
git clone https://github.com/microsoft/litebox.git
进入项目目录
cd litebox

预期结果::成功下载项目文件到litebox目录

确保网络连接正常,可能需要配置Git代理

3

编译项目

使用Cargo编译LiteBox库

编译项目
cargo build

预期结果::显示 'Finished dev [unoptimized + debuginfo] target(s) in ...'

首次编译可能需要较长时间下载依赖,请耐心等待

4

运行测试示例

运行一个简单的测试来验证LiteBox基本功能

运行库测试
cargo test --lib

预期结果::显示 'test result: ok. ... passed; 0 failed'

如果测试失败,请检查Rust版本是否满足要求

验证成功

完成以上步骤后,你已经成功编译了LiteBox并运行了基本测试

项目编译成功无错误
测试用例全部通过
target/debug目录下生成了编译产物

快速提示

性能

使用 'cargo build --release' 进行优化编译,适合生产环境

配置

查看项目中的examples目录,了解更多使用示例

其他

使用 'cargo doc --open' 生成并查看API文档

常见问题

1

编译时出现 'linker cc not found' 错误

安装C编译器:Ubuntu/Debian使用 'sudo apt install build-essential',macOS使用 'xcode-select --install'

2

Rust版本过低导致编译失败

运行 'rustup update' 更新Rust到最新稳定版

3

网络问题导致依赖下载失败

配置Cargo镜像源,或使用代理

下一步

查看examples目录

探索更多使用示例,了解LiteBox的实际应用

阅读项目文档

深入了解LiteBox的架构和使用方法

尝试构建自己的沙箱应用

基于LiteBox创建安全的隔离环境

助手