Rust crate type
bin
二进制可执行 crate,编译出的文件为二进制可执行文件。必须要有 main 函数作为入口。这种 crate 不需要在 Cargo.toml 中或 --crate-type 命令行参数中指定,会自动识别。
lib
库 crate。它其实并不是一种具体的库,它指代后面各种库 crate 中的一种,可以认为是一个代理名称(alias)。
通常来讲,如果什么都不配置,默认指的是 rlib, 会生成 .rlib 的文件。
rlib
rlib 是 Rust Library 特定静态中间库格式。如果只是纯 Rust 代码项目之间的依赖和调用,那么,用 rlib 就能完全满足使用需求。
rlib 实现为一个 ar 归档文件。
rlib 中包含很多 metadata 信息(比如可能的上游依赖信息),用来做后面的 linkage。
在 Cargo.toml 中配置:
可以指定生成 rlib,但是一般没必要设置,因为默认 lib 就是 rlib。
rlib 是平台(Linux, MacOS, Windows ...)无关的。
dylib
动态库。
在 Cargo.toml 中配置:
会在编译的时候,生成动态库(Linux 上为 .so, MacOS 上为 .dylib, Windows 上为 .dll)。
动态库是平台相关的库。动态库在被依赖并链接时,不会被链接到目标文件中。这种动态库只能被 Rust 写的程序(或遵循 Rust 内部不稳定的规范的程序)调用。这个动态库可能依赖于其它动态库(比如,Linux 下用 C 语言写的 PostgreSQL 的 libpq.so,或者另一个编译成 "dylib" 的 Rust 动态库)。
cdylib
C 规范动态库。
在 Cargo.toml 中配置:
与 dylib 类似,也会生成 .so, .dylib 或 .dll 文件。但是这种动态库可以被其它语言调用(因为几乎所有语言都有遵循 C 规范的 FFI 实现),也就是跨语言 FFI 使用。这个动态库可能依赖于其它动态库(比如,Linux 下用 C 语言写的 PostgreSQL 的 libpq.so)。
staticlib
静态库。
在 Cargo.toml 中配置:
编译会生成 .a 文件(在 Linux 和 MacOS 上),或 .lib 文件(在 Windows 上)。
编译器会把所有实现的 Rust 库代码以及依赖的库代码全部编译到一个静态库文件中,也就是对外界不产生任何依赖了。这特别适合将 Rust 实现的功能封装好给第三方应用使用。
proc-macro
过程宏 crate.
在 Cargo.toml 中配置:
这种 crate 里面只能导出过程宏,被导出的过程宏可以被其它 crate 引用。