如何在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

隨着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

Answer 2

正如documentation for a build script指出：

所有行printe d通過構建腳本到stdout [...起動]與cargo:直接由貨運解釋[...] rustc-link-search表示指定的值應該被傳遞到編譯器作爲-L標誌。

在你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"); 
} 

請注意，您的構建腳本可以使用生鏽的所有功能和能根據目標平臺（例如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" 

---

理想情況下，你將創建一個soundio-sys包，使用the convention for *-sys packages。這只是一個構建腳本，鏈接到適當的庫並公開C方法。它將使用Cargo links key來唯一標識本地庫並防止多次鏈接到它。其他圖書館可以包括這個新的箱子，而不用擔心這些鏈接細節。

Answer 3

我發現一些作品OK：您可以在Cargo.toml指定links：

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

這指定項目鏈接到libsoundio。現在，您可以指定.cargo/config文件的搜索路徑和庫名稱：（該:前綴告訴GCC使用的實際文件名，而不是做所有的愚蠢lib -prepending和延伸魔法）

[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"] 

您還需要創建一個空build.rs：

fn main() {} 

這個文件是永遠不會運行，因爲在.cargo/config值覆蓋它的輸出，但對於一些reaso ñ貨物仍然需要它 - 任何時候你使用links =你必須有build =，即使它沒有被使用。

最後在main.rs：

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