基础开发环境搭建

Mac环境搭建

主要步骤

TIP

⚠️注意：当前项目中已经默认携带了rust-toolchain.toml, 因此默认情况下会使用该文件配置的rustc环境，如果通过brew安装了rust 可能会出现版本被覆盖的问题， 需要卸载后重新按照该内容进行搭建

代码运行需要先搭建Rust开发环境，初始化rust环境后。 项目主要依赖 cmake、rocksdb、 protoc， 需要根据不同的操作系统环境去安装这些依赖。

• 安装 Rust 基础环境 参考文档：https://course.rs/first-try/installation.html

• Rust 版本 目前依赖的rust 版本是：stable

rustup install stable
rustup default stable
rustc --version

• 安装 Cmake. mac 安装命令如下：

brew install cmake

• 安装 RocksDB 参考文档：https://github.com/rust-rocksdb/rust-rocksdb 安装 rocksdb。

mac 安装命令如下：

brew install rocksdb

• 安装 protoc 参考文档：https://www.jianshu.com/p/341293ee1286　安装protoc

mac 安装命令如下：

brew install protobuf

配置pre-commit插件

RobustMQ默认使用pre-commit进行了代码预提交，因此需要安装指定版本的 pre-commit工具。

首先你需要通过Python(3.8版本以上)构建一个虚拟环境，安装命令如下:

python3 -m venv precommit_venv

安装完成后，通过如下命令进入虚拟环境:

source ./precommit_venv/bin/activate

然后安装对应版本的pre-commit工具, 这里使用项目环境内指定版本的 pre-commit:

pip3 install -r ./.requirements-precommit.txt

完成安装后，需要初始化一下项目内容的pre-commit钩子，使用如下命令:

pre-commit install

TIP

⚠️注意:

1. 后续进行任何的git commit操作，pre-commit都会执行 对应的检查， 这里如果不想每次提交都进行检查可以使用git commit -n 来跳过检查。
2. pre-commit检查已经设置了stage，对于测试以及严格的检查会在 pre-push阶段进行，需要使用pre-commit install --hook-type pre-push 来安装pre-push的hooks。

pre-commit携带的检查功能使用了next-test,hawkeye,clippy, typos,cargo-deny等工具, 这些工具如果缺少可以参考如下命令进行安装

cargo install hawkeye@5.8.1
cargo install typos-cli
cargo install cargo-deny@0.16.2 --locked
cargo install cargo-nextest@0.9.84