Android.bp फ़ाइलें, डिज़ाइन के हिसाब से आसान होती हैं. इनमें कंडिशनल या कंट्रोल फ़्लो स्टेटमेंट नहीं होते. सभी मुश्किलें, Go में लिखे गए बिल्ड लॉजिक की मदद से हैंडल की जाती हैं. मुमकिन होने पर, Android.bp फ़ाइलों के सिंटैक्स और सिमैंटिक, बेज़ल BUILD फ़ाइलों से मिलते-जुलते होते हैं.
मॉड्यूल
Android.bp फ़ाइल में मौजूद मॉड्यूल, मॉड्यूल टाइप से शुरू होता है. इसके बाद, name: "value", फ़ॉर्मैट में प्रॉपर्टी का एक सेट होता है:
cc_binary {
name: "gzip",
srcs: ["src/test/minigzip.c"],
shared_libs: ["libz"],
stl: "none",
}
हर मॉड्यूल में name प्रॉपर्टी होनी चाहिए. साथ ही, सभी Android.bp फ़ाइलों में इस प्रॉपर्टी की वैल्यू यूनीक होनी चाहिए. हालांकि, नेमस्पेस और पहले से बने मॉड्यूल में मौजूद name प्रॉपर्टी की वैल्यू दोहराई जा सकती हैं.
srcs प्रॉपर्टी, स्ट्रिंग की सूची के तौर पर मॉड्यूल बनाने के लिए इस्तेमाल की जाने वाली सोर्स फ़ाइलों के बारे में बताती है. मॉड्यूल रेफ़रंस सिंटैक्स ":<module-name>" का इस्तेमाल करके, genrule या filegroup जैसी सोर्स फ़ाइलें बनाने वाले अन्य मॉड्यूल के आउटपुट का रेफ़रंस दिया जा सकता है.
मान्य मॉड्यूल टाइप और उनकी प्रॉपर्टी की सूची के लिए, Soong मॉड्यूल का रेफ़रंस देखें.
प्रकार
वैरिएबल और प्रॉपर्टी अच्छी तरह से तय की जाती हैं. इनमें पहले असाइनमेंट के आधार पर डाइनैमिक तौर पर वैरिएबल सेट किए जाते हैं. साथ ही, प्रॉपर्टी को मॉड्यूल टाइप के हिसाब से स्टैटिक तरीके से सेट किया जाता है. इन टाइप की फ़ाइलें इस्तेमाल की जा सकती हैं:
- बूलियन (
trueयाfalse) - पूर्णांक (
int) - स्ट्रिंग (
"string") - स्ट्रिंग की सूचियां (
["string1", "string2"]) - मैप (
{key1: "value1", key2: ["value2"]})
मैप में किसी भी तरह की वैल्यू हो सकती हैं. इनमें नेस्ट किए गए मैप भी शामिल हैं. सूचियों और मैप में, आखिरी वैल्यू के बाद कॉमा हो सकते हैं.
ग्लॉब
srcs जैसी फ़ाइलों की सूची वाली प्रॉपर्टी में, ग्लोब पैटर्न भी इस्तेमाल किए जा सकते हैं. ग्लोब पैटर्न में सामान्य UNIX वाइल्डकार्ड * हो सकता है, जैसे कि
*.java. ग्लोब पैटर्न में, पाथ एलिमेंट के तौर पर एक ** वाइल्डकार्ड भी हो सकता है. यह शून्य या उससे ज़्यादा पाथ एलिमेंट से मैच करता है. उदाहरण के लिए,
java/**/*.java, java/Main.java और
java/com/android/Main.java, दोनों पैटर्न से मेल खाता है.
वैरिएबल
Android.bp फ़ाइल में, टॉप-लेवल वैरिएबल असाइनमेंट हो सकते हैं:
gzip_srcs = ["src/test/minigzip.c"],
cc_binary {
name: "gzip",
srcs: gzip_srcs,
shared_libs: ["libz"],
stl: "none",
}
वैरिएबल का दायरा, उस फ़ाइल के बाकी हिस्से तक होता है जिसमें उन्हें तय किया गया है. साथ ही, यह दायरा किसी भी चाइल्ड ब्लूप्रिंट फ़ाइल तक भी हो सकता है. वैरिएबल को एक अपवाद के साथ बदला नहीं जा सकता: उन्हें += असाइनमेंट के साथ जोड़ा जा सकता है, लेकिन उनका रेफ़रंस देने से पहले ही ऐसा किया जा सकता है.
टिप्पणियां
Android.bp फ़ाइलों में C-स्टाइल की एक से ज़्यादा लाइन वाली /* */ और C++ स्टाइल की एक लाइन वाली // टिप्पणियां हो सकती हैं.
ऑपरेटर
+ ऑपरेटर का इस्तेमाल करके, स्ट्रिंग, स्ट्रिंग की सूचियां, और मैप जोड़े जा सकते हैं.
+ ऑपरेटर का इस्तेमाल करके, पूर्णांकों का योग निकाला जा सकता है. किसी मैप को जोड़ने पर, दोनों मैप में मौजूद सभी बटन की वैल्यू जोड़ दी जाती हैं.
कंडीशनल
Soong, Android.bp फ़ाइलों में शर्तों के साथ काम नहीं करता. इसके बजाय, बिल्ड नियमों में मौजूद जटिलताएं, Go में मैनेज की जाती हैं. इसके लिए, भाषा की बेहतर सुविधाओं का इस्तेमाल किया जा सकता है. साथ ही, कंडिशनल के ज़रिए जोड़ी गई डिपेंडेंसी को ट्रैक किया जा सकता है. ज़्यादातर शर्तों को मैप प्रॉपर्टी में बदल दिया जाता है. इसमें मैप की किसी एक वैल्यू को चुना जाता है और उसे टॉप-लेवल प्रॉपर्टी में जोड़ दिया जाता है.
उदाहरण के लिए, खास तरह के आर्किटेक्चर वाली फ़ाइलों के साथ काम करने के लिए:
cc_library {
...
srcs: ["generic.cpp"],
arch: {
arm: {
srcs: ["arm.cpp"],
},
x86: {
srcs: ["x86.cpp"],
},
},
}
फ़ॉर्मैटर
सूंग में ब्लूप्रिंट फ़ाइलों के लिए एक कैननिकल फ़ॉर्मैटर शामिल है, जो gofmt की तरह है. मौजूदा डायरेक्ट्री की सभी Android.bp फ़ाइलों को बार-बार फ़ॉर्मैट करने के लिए, इसे चलाएं:
bpfmt -w .
कैननिकल फ़ॉर्मैट में, चार स्पेस वाले इंडेंट होते हैं. साथ ही, कई एलिमेंट वाली सूची के हर एलिमेंट के बाद नई लाइनें दिखती हैं. इसके अलावा, सूचियों और मैप में, इसके बाद में कॉमा भी होता है.