Rust 라이브러리 모듈에는 두 가지 유형이 있습니다. 하나는 Rust 라이브러리를 생성하고, 다른 하나는 C 호환 라이브러리를 생성합니다. 빌드 시스템 용도로는 특수 유형의 라이브러리로 Rust 프로시저 매크로(proc-macros)를 사용할 수 있습니다.
rust_library
rust_library 모듈은 다른 Rust 모듈에서 사용할 Rust 라이브러리를 생성합니다.
Rust 라이브러리에는 _host 변형 외에도 사용 가능한 링크를 제어하는 모듈 유형이 있습니다.
| Rust 라이브러리 모듈 유형 | 정의 |
|---|---|
| rust_library | 두 가지 라이브러리 변형(rlib 및 dylib)을 모두 제공합니다. 이 유형은 모듈이 rustlibs 속성 아래에 종속 항목으로 나열된 경우 모듈이 올바르게 작동하도록 하므로 AOSP에서는 Rust 라이브러리용으로 이 모듈 유형을 권장합니다. |
| rust_library_rlib | Rust 라이브러리의 rlib 변형만 제공합니다. rlib 변형만 제공하는 모듈은 rustlibs 속성과의 작동이 보장되지 않습니다. |
| rust_library_dylib | Rust 라이브러리의 dylib 변형만 제공합니다. dylib 변형만 제공하는 모듈은 rustlibs 속성과의 작동이 보장되지 않습니다. |
rust_ffi
rust_ffi 모듈은 CC 모듈과의 상호 운용을 위한 C 호환 라이브러리를 생성합니다.
Rust FFI 라이브러리에는 _host 변형 외에도 아래 표에 나와 있는 것처럼 사용 가능한 링크를 제어하는 모듈 유형이 있습니다.
| Rust FFI 라이브러리 모듈 유형 | 정의 |
|---|---|
| rust_ffi | 두 가지 C 라이브러리 변형(정적 및 공유)을 모두 제공합니다. |
| rust_ffi_shared | C 공유 라이브러리 변형만 제공합니다. |
| rust_ffi_static | C 정적 라이브러리 변형만 제공합니다. |
C에서 Rust를 호출하기 위해 rust_ffi를 사용하는 기본적인 예는 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 정의를 참고하세요.) |
| include_dirs | rust_ffi 모듈의 경우 이 속성은 상대적인 포함 경로를 나타내는 문자열로 구성된 목록을 정의합니다. 경로는 종속된 cc 모듈이 사용할 수 있는 헤더를 포함합니다. |
rust_library 또는 rust_ffi의 링크
기기를 타게팅하는 Rust 라이브러리는 기본적으로 항상 libstd에 동적으로 링크됩니다. 반면에 호스트 모듈은 항상 libstd에 정적으로 링크됩니다.
rustlibs 종속 항목에 사용되는 링크는 루트 모듈 링크 설정에 종속됩니다. (예를 들어, prefer_rlib: true를 포함하는 rust_binary는 rustlibs를 rlibs로서 링크하는 Rust 라이브러리를 사용합니다.)
동적 Rust 라이브러리를 사용하지 않는 루트 종속 항목 모듈(예: 정적 실행 파일)을 생성할 수 있도록, rlibs는 동적 및 정적 libstd 링크 변형을 모두 제공합니다. Soong에 의해 자동으로 올바른 변형이 링크됩니다.