在Linux上构建Rust的静态库与动态库
想在Linux环境下把Rust代码打包成可供其他程序调用的库文件?无论是追求极致性能、希望将代码直接“焊”进可执行文件的静态库,还是青睐灵活更新、便于共享的动态库,Rust的工具链都能提供清晰的支持。下面这份指南,将带你走通从项目初始化到最终构建的完整流程。
构建静态库
-
万事开头先建项。创建一个新的Rust库项目是第一步:
cargo new --lib my_library cd my_library -
接下来,配置项目的“蓝图”——
Cargo.toml文件。关键在于[lib]部分,你需要确保它包含以下内容,明确指定构建类型为静态库:[lib] name = "my_library" crate-type = ["staticlib"] -
蓝图已就绪,该编写核心逻辑了。你的库代码就放在
src/lib.rs这个文件中。 -
最后,执行构建命令。使用
cargo build --release进行优化构建。完成后,你需要的静态库文件(通常命名为libmy_library.a)就会安静地躺在target/release/目录下,等待被调用。
构建动态库
-
同样,如果还没有项目,先创建一个Rust库项目:
cargo new --lib my_library cd my_library -
配置
Cargo.toml文件。这次,构建类型需要改为动态库:[lib] name = "my_library" crate-type = ["cdylib"] -
在
src/lib.rs中编写你的库功能代码。 -
执行构建。运行
cargo build --release。构建成功后,动态库文件(通常为libmy_library.so)同样位于target/release/目录中。
注意事项
- 链接依赖:如果你的库还依赖其他第三方库,务必在
Cargo.toml文件中正确配置这些依赖项,并确保它们的路径设置无误,否则构建过程可能会卡壳。 - 平台差异:动态库的文件扩展名并非放之四海而皆准。例如,在Windows平台上,动态库的扩展名通常是
.dll,这一点在跨平台开发时需要留心。 - 环境变量:使用动态库时,有时系统会找不到它。这时候,你可能需要设置
LD_LIBRARY_PATH这个环境变量,把库所在的路径告诉系统。
示例
假设你已经按照上述步骤,创建好了一个名为my_library的库项目。现在,我们来分别构建它的静态库和动态库版本。
构建静态库
cd my_library
cargo build --release
构建完成后,生成的静态库文件路径为:
target/release/libmy_library.a
构建动态库
cd my_library
cargo build --release
构建完成后,生成的动态库文件路径为:
target/release/libmy_library.so
遵循这些步骤,你应该能在Linux系统上顺利构建出Rust的静态库和动态库,为你的代码共享和集成铺平道路。
