मान लें कि आपको अपने बिल्ड के हिस्से के तौर पर एक टूल चलाना होगा. उदाहरण के लिए, हो सकता है कि आप कोई सोर्स फ़ाइल जनरेट, प्रीप्रोसेस या बाइनरी को कंप्रेस करना चाहें. इस ट्यूटोरियल में, इमेज का साइज़ बदलने वाला मैक्रो बनाया जा सकता है.
मैक्रो आसान कामों के लिए काम करते हैं. अगर आपको कुछ और मुश्किल करना है, जैसे कि किसी नई प्रोग्रामिंग भाषा के लिए सहायता जोड़ना, तो एक नियम बनाएं. नियमों से आपको ज़्यादा कंट्रोल और सुविधा मिलती है.
किसी इमेज का साइज़ बदलने वाला मैक्रो बनाने का सबसे आसान तरीका, genrule का इस्तेमाल करना है:
genrule(
name = "logo_miniature",
srcs = ["logo.png"],
outs = ["small_logo.png"],
cmd = "convert $< -resize 100x100 $@",
)
cc_binary(
name = "my_app",
srcs = ["my_app.cc"],
data = [":logo_miniature"],
)
अगर आपको और इमेज का साइज़ बदलना है, तो कोड को फिर से इस्तेमाल किया जा सकता है. ऐसा करने के लिए, किसी अलग .bzl फ़ाइल में फ़ंक्शन तय करें और फ़ाइल miniature.bzl को कॉल करें:
def miniature(name, src, size="100x100", **kwargs):
"""Create a miniature of the src image.
The generated file is prefixed with 'small_'.
"""
native.genrule(
name = name,
srcs = [src],
outs = ["small_" + src],
cmd = "convert $< -resize " + size + " $@",
**kwargs
)
कुछ टिप्पणियां:
नियम के मुताबिक, मैक्रो में भी नियमों की तरह ही
nameआर्ग्युमेंट होता है.मैक्रो के व्यवहार का दस्तावेज़ बनाने के लिए, Python की तरह docstring का इस्तेमाल करें.
genruleया किसी दूसरे नेटिव नियम को कॉल करने के लिए,native.का इस्तेमाल करें.अतिरिक्त आर्ग्युमेंट को मौजूदा
genruleपर फ़ॉरवर्ड करने के लिए,**kwargsका इस्तेमाल करें. यह Python की तरह ही काम करता है. ऐसा करना मददगार होता है, ताकि उपयोगकर्ताvisibilityयाtagsजैसे स्टैंडर्ड एट्रिब्यूट का इस्तेमाल कर सके.
अब BUILD फ़ाइल से मैक्रो का इस्तेमाल करें:
load("//path/to:miniature.bzl", "miniature")
miniature(
name = "logo_miniature",
src = "image.png",
)
cc_binary(
name = "my_app",
srcs = ["my_app.cc"],
data = [":logo_miniature"],
)