Rust लाइब्रेरी मॉड्यूल दो तरह के होते हैं. एक Rust लाइब्रेरी बनाता है और दूसरा C के साथ काम करने वाली लाइब्रेरी बनाता है. इसके अलावा, बिल्ड सिस्टम के लिए, Rust के प्रोसीजरल मैक्रोज़ (proc-macros) को एक खास तरह की लाइब्रेरी के तौर पर इस्तेमाल किया जा सकता है.
rust_library
rust_library मॉड्यूल, अन्य Rust मॉड्यूल के इस्तेमाल के लिए Rust लाइब्रेरी बनाता है.
_host वैरिएंट के अलावा, Rust लाइब्रेरी में मॉड्यूल टाइप होते हैं. ये मॉड्यूल टाइप, उपलब्ध लिंकेज को कंट्रोल करते हैं.
| Rust Library Module Type | परिभाषा |
|---|---|
| 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 मॉड्यूल, C के साथ काम करने वाली लाइब्रेरी बनाता है, ताकि CC मॉड्यूल के साथ इंटरऑपरेट किया जा सके.
_host के अलावा, Rust FFI लाइब्रेरी में मॉड्यूल टाइप होते हैं. ये टाइप, उपलब्ध लिंकेज को कंट्रोल करते हैं. इनके बारे में यहां दी गई टेबल में बताया गया है.
| Rust FFI लाइब्रेरी मॉड्यूल का टाइप | परिभाषा |
|---|---|
| rust_ffi | यह C लाइब्रेरी के दोनों वैरिएंट उपलब्ध कराता है: स्टैटिक और शेयर की गई. |
| rust_ffi_shared | यह सिर्फ़ C शेयर की गई लाइब्रेरी का वैरिएंट उपलब्ध कराता है. |
| rust_ffi_static | सिर्फ़ C स्टैटिक लाइब्रेरी वैरिएंट उपलब्ध कराता है. |
C से Rust को कॉल करने के लिए rust_ffi का इस्तेमाल करने का बुनियादी उदाहरण देखने के लिए, Android Rust Patterns पेज देखें.
ज़्यादा बेहतर तरीके से इस्तेमाल करने के बारे में जानने के लिए, Rust का आधिकारिक दस्तावेज़ पढ़ें.
rust_proc_macro
Rust के प्रोसीजरल मैक्रो (प्रॉक-मैक्रो), कंपाइलर को इन कामों के लिए एक्सटेंड करने में मददगार हो सकते हैं: सोर्स कोड में बदलाव करना या नए एट्रिब्यूट उपलब्ध कराना. इनके बारे में ज़्यादा जानकारी, Rust के आधिकारिक दस्तावेज़ के Procedural Macros पेज पर मिल सकती है.
बिल्ड सिस्टम के लिए, 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 के तौर पर लिंक करते हैं.)
rlibs, डाइनैमिक और स्टैटिक, दोनों तरह के libstd लिंकेज वैरिएंट उपलब्ध कराता है. इससे, रूट डिपेंडेंसी मॉड्यूल बनाए जा सकते हैं. ये मॉड्यूल, किसी भी डाइनैमिक रस्ट लाइब्रेरी (जैसे कि स्टैटिक एक्ज़ीक्यूटेबल) पर निर्भर नहीं होते. Soong, सही वैरिएंट को अपने-आप लिंक कर देता है.