如何在Linux上构建Rust的静态库和动态库

在Linux上构建Rust的静态库与动态库

想在Linux环境下把Rust代码打包成可供其他程序调用的库文件？无论是追求极致性能、希望将代码直接“焊”进可执行文件的静态库，还是青睐灵活更新、便于共享的动态库，Rust的工具链都能提供清晰的支持。下面这份指南，将带你走通从项目初始化到最终构建的完整流程。

构建静态库

1. 万事开头先建项。创建一个新的Rust库项目是第一步：

   cargo new --lib my_library
   cd my_library

2. 接下来，配置项目的“蓝图”——Cargo.toml文件。关键在于[lib]部分，你需要确保它包含以下内容，明确指定构建类型为静态库：

   [lib]
   name = "my_library"
   crate-type = ["staticlib"]

3. 蓝图已就绪，该编写核心逻辑了。你的库代码就放在src/lib.rs这个文件中。

4. 最后，执行构建命令。使用cargo build --release进行优化构建。完成后，你需要的静态库文件（通常命名为libmy_library.a）就会安静地躺在target/release/目录下，等待被调用。

构建动态库

1. 同样，如果还没有项目，先创建一个Rust库项目：

   cargo new --lib my_library
   cd my_library

2. 配置Cargo.toml文件。这次，构建类型需要改为动态库：

   [lib]
   name = "my_library"
   crate-type = ["cdylib"]

3. 在src/lib.rs中编写你的库功能代码。

4. 执行构建。运行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的静态库和动态库，为你的代码共享和集成铺平道路。