如何在 Rust 中指定链接器路径？

Question

我正在尝试将 Rust 程序与 libsoundio 链接。我正在使用 Windows，并且有一个 GCC 二进制下载可用。如果我将它放在与我的项目相同的文件夹中，我可以这样链接它：

#[link(name = ":libsoundio-1.1.0/i686/libsoundio.a")]
#[link(name = "ole32")]
extern {
    fn soundio_version_string() -> *const c_char;
}

但我真的很想指定#[link(name = "libsoundio")] 甚至#[link(name = "soundio")]，然后在其他地方提供链接器路径。

在哪里可以指定该路径？

我尝试了rustc-link-search的建议如下：

#[link(name = "libsoundio")]
#[link(name = "ole32")]
extern {
    fn soundio_version_string() -> *const c_char;
}

在.cargo/config:

[target.i686-pc-windows-gnu.libsoundio]
rustc-link-search = ["libsoundio-1.1.0/i686"]
rustc-link-lib = ["libsoundio.a"]

[target.x86_64-pc-windows-gnu.libsoundio]
rustc-link-search = ["libsoundio-1.1.0/x86_64"]
rustc-link-lib = ["libsoundio.a"]

但它仍然只将"-l" "libsoundio" 传递给gcc，并以相同的ld: cannot find -llibsoundio 失败。我错过了一些非常明显的东西吗？文档似乎表明这应该可行。

Answer 1

如documentation for a build script中所述：

构建脚本[...开始]以cargo:打印到标准输出的所有行都由Cargo直接解释[...]rustc-link-search表示指定的值应作为@987654326传递给编译器@标志。

在您的 Cargo.toml 中：

[package]
name = "link-example"
version = "0.1.0"
authors = ["An Devloper <an.devloper@example.com>"]
build = "build.rs"

还有你的 build.rs：

fn main() {
    println!(r"cargo:rustc-link-search=C:\Rust\linka\libsoundio-1.1.0\i686");
}

请注意，您的构建脚本可以使用 Rust 的所有功能，并且可以根据目标平台（例如 32 位和 64 位）输出不同的值。

最后，你的代码：

extern crate libc;

use libc::c_char;
use std::ffi::CStr;

#[link(name = "soundio")]
extern {
    fn soundio_version_string() -> *const c_char;
}

fn main() {
    let v = unsafe { CStr::from_ptr(soundio_version_string()) };
    println!("{:?}", v);
}

证据在布丁中：

$ cargo run
    Finished debug [unoptimized + debuginfo] target(s) in 0.0 secs
     Running `target\debug\linka.exe`
"1.0.3"

---

理想情况下，您将使用the convention for *-sys packages 创建一个soundio-sys 包。那只是有一个构建脚本，它链接到适当的库并公开 C 方法。它将使用Cargo links key 来唯一标识本机库并防止多次链接到它。然后其他库可以包含这个新的 crate，而不必担心那些链接细节。

Answer 2

另一种可能的方式是setting the RUSTFLAGSlike：

RUSTFLAGS='-L my/lib/location' cargo build # or cargo run

我不知道这是否是最有条理和最推荐的方法，但它适用于我的简单项目。

Answer 3

我发现一些可行的方法：您可以在 Cargo.toml 中指定 links：

[package]
links = "libsoundio"
build = "build.rs"

这指定项目链接到libsoundio。现在您可以在.cargo/config 文件中指定搜索路径和库名称：

[target.i686-pc-windows-gnu.libsoundio]
rustc-link-search = ["libsoundio-1.1.0/i686"]
rustc-link-lib = [":libsoundio.a"]

[target.x86_64-pc-windows-gnu.libsoundio]
rustc-link-search = ["libsoundio-1.1.0/x86_64"]
rustc-link-lib = [":libsoundio.a"]

（: 前缀告诉 GCC 使用实际的文件名，而不是使用其所有愚蠢的 lib-前置和扩展魔术。）

你还需要创建一个空的build.rs：

fn main() {}

这个文件永远不会运行，因为.cargo/config 中的值覆盖了它的输出，但出于某种原因，Cargo 仍然需要它 - 任何时候你使用 links = 都必须有 build =，即使它不是用过。

终于在main.rs:

#[link(name = "libsoundio")]
#[link(name = "ole32")]
extern {
    fn soundio_version_string() -> *const c_char;
}

Answer 4

对于rustc，使用-L 和-l：

$ rustc --help
...
-L [KIND=]PATH      Add a directory to the library search path. The
                    optional KIND can be one of dependency, crate, native,
                    framework or all (the default).
-l [KIND=]NAME      Link the generated crate(s) to the specified native
                    library NAME. The optional KIND can be one of static,
                    dylib, or framework. If omitted, dylib is assumed.
...

注意，对于-l，您应该丢弃静态库的前缀lib 和扩展名.a：-lsoundio