Rust 库模块有两种类型：一种生成 Rust 库，另一种生成 C 兼容库。此外，对于构建系统来说，可将 Rust 过程宏 (proc-macros) 视为一种特殊类型的库。
rust_library
rust_library 模块会生成供其他 Rust 模块使用的 Rust 库。
除了 _host 变体外，Rust 库还有用于控制可用关联的模块类型。
| Rust 库模块类型 | 定义 |
|---|---|
| rust_library | 提供两种库变体：rlib 和 dylib。AOSP 推荐使用此模块类型的 Rust 库，因为它可以让模块在列为 rustlibs 属性下的依赖项时正常工作 |
| rust_library_rlib | 仅提供 Rust 库的 rlib 变体；仅提供 rlib 变体的模块不能保证可与 rustlibs 属性搭配使用。 |
| rust_library_dylib | 仅提供 Rust 库的 dylib 变体；仅提供 dylib 变体的模块不能保证可与 rustlibs 属性搭配使用。 |
rust_ffi
rust_ffi 模块会生成用于与 CC 模块互操作的 C 兼容库。
除了 _host 变体外，Rust FFI 库还有用于控制可用关联的模块类型，如下表所示。
| Rust FFI 库模块类型 | 定义 |
|---|---|
| rust_ffi | 提供两种 C 库变体：静态库变体和共享库变体。 |
| rust_ffi_shared | 仅提供 C 共享库变体。 |
| rust_ffi_static | 仅提供 C 静态库变体。 |
如需查看使用 rust_ffi 从 C 调用 Rust 的基本示例，请参阅 Android Rust 模式页面。
如需了解更高级的用法，请访问官方 Rust 文档。
rust_proc_macro
Rust 过程宏 (proc-macros) 可用于扩展编译器，以执行源代码转换或提供新属性。如需了解详情，请参阅 Rust 官方文档的过程宏页面。
对于构建系统来说，rust_proc_macro 模块的工作方式与 rust_library 模块类似。对于依赖于 rust_proc_macros 的模块，请将模块名称添加到 proc_macros 属性中。
由于 proc_macros 是编译器插件，它们必然是以主机为目标，而且不会生成任何会在设备上运行的代码。
重要的 Rust 库属性
除了适用于所有模块的重要的通用属性之外，还有下表中定义的一些属性。这些属性要么对 Rust 库模块特别重要，要么具有特定于 rust_library 模块类型的独有行为。
| Rust 库属性 | 定义 |
|---|---|
| stem/name | stem 属性用于控制输出库文件名，此文件名原本默认为 name。
Rust 编译器对库文件名规定了一些要求，因此构建系统会强制执行这些要求以避免出现编译问题。输出文件名必须符合 |
| crate_name | 对于会生成库的模块，这是必需属性；此外，它与输出文件名也存在关系。（请参阅 stem 定义。） |
| export_include_dirs | 对于 rust_ffi 模块，此属性会定义一个字符串列表，列出表示相对包含路径的字符串。相对包含路径是包含相关 cc 模块可以使用的头文件的路径。 |
rust_library 或 rust_ffi 的关联
默认情况下，以设备为目标的 Rust 库模块始终动态关联到 libstd。但是，主机模块始终静态关联到 libstd。
用于 rustlibs 依赖项的关联根据根模块的关联偏好设置而定。（例如，具有 prefer_rlib: true 设置的 rust_binary 所使用的 Rust 库变体将关联 rustlibs 作为 rlibs。）
为了允许生成不依赖于任何动态 Rust 库的根依赖项模块（例如静态可执行文件），rlibs 同时提供动态和静态 libstd 关联变体。Soong 会自动关联正确的变体。