㈠ Rust Cargo使用指南 | 第十八篇 | build.rs 示例
通過構建腳本build.rs在Rust中實現代碼生成，以下是一個示例。首先，我們考慮目錄結構和Cargo.toml文件內容。在構建腳本中，我們編寫代碼以生成庫調用。生成代碼文件後，我們通過`rustc`的`include!`宏，以及`concat!`和`env!`宏，將生成的代碼文件（例如`hello.rs`）集成到項目的編譯流程中。這種操作清晰明了，易於理解和實現，對於生成代碼文件並將其編譯為項目的一部分非常有用。
在構建本地庫方面，我們有時候需要在Rust項目中使用基於C或C++的本地庫。為了實現這種需求，構建腳本提供了一個靈活的解決方案。以調用C並列印"Hello, World"為例，我們首先通過`gcc`編譯C文件，然後使用`ar`將編譯後的文件轉換為靜態庫，最後通過`cargo`將靜態庫集成到項目中。盡管這種方式在某些情況下可能需要硬編碼特定的依賴，但社區提供了解決方案，如`cc`包，可以簡化這一過程，同時提高了可移植性和穩定性。
在構建依賴中使用`cc`包，可以更簡潔地完成C代碼的集成。`cc`包提供了對C和C++代碼的抽象，允許在構建腳本中更輕松地管理依賴。通過引入`cc`依賴並使用其功能，我們能夠減少在每個構建腳本中重復編寫代碼的情況，從而簡化實現流程。
當構建需要鏈接本地系統庫的Rust包時，如使用Unix系統中的`zlib`庫進行數據壓縮，我們可以利用`pkg-config`包來實現平台透明化。通過`pkg-config`，我們能夠自動獲取目標庫的鏈接信息，簡化了配置過程。首先，修改`Cargo.toml`以添加鏈接命令，然後在構建腳本中使用`pkg-config`獲取庫信息。在代碼中應用這些信息時，運行`cargo build --vv`以觀察結果，`pkg-config`將幫助找到目標庫並提供必要的鏈接信息。
在Rust中使用`libz-sys`包可以自動發現或構建依賴於`zlib`的庫。這一功能特別適用於交叉編譯場景，如在Windows系統上缺少`zlib`庫。通過設置`include`元數據，`libz-sys`告知其他包如何找到`zlib`的頭文件，構建腳本則通過`DEP_Z_INCLUDE`環境變數讀取這些元數據。使用`libz-sys`簡化了編譯流程，使得C代碼僅需包含`zlib`頭文件即可，甚至在系統未安裝`zlib`時也能找到頭文件。
構建腳本還可以通過`rustc-cfg`指令實現編譯時條件檢查。以支持不同版本的`OpenSSL`庫為例，`openssl-sys`包提供了構建和鏈接功能，支持多個實現和版本。通過`links`配置，構建腳本可以傳遞所需信息。`openssl-sys`的構建腳本通過環境變數`DEP_OPENSSL_VERSION_NUMBER`傳遞版本號信息給依賴其的項目。依賴`openssl-sys`的項目可以使用此版本號信息進行條件編譯，實現特定功能的啟用或禁用，例如僅在特定版本的`OpenSSL`中啟用SHA3支持。然而，在使用時需注意，依賴於當前構建環境的信息可能在目標操作系統中不存在，這可能影響二進制文件的兼容性。