फ़्लैग के इस्तेमाल और टाइप का पता लगाना

Google, सुविधा लॉन्च फ़्लैग का इस्तेमाल, कोड की स्थिर शाखाओं को पक्का करने के लिए करता है. कुछ खास तरह के योगदान के लिए भी ये फ़्लैग ज़रूरी हैं को एओएसपी के तौर पर भेजना होगा. सुविधा के लॉन्च को फ़्लैग करने की सुविधा लागू करने से पहले, यह तय करें कि आपके बदलाव के लिए फ़्लैग ज़रूरी है या नहीं. अगर फ़्लैग ज़रूरी है, तो आपको यह तय करना चाहिए कि किस तरह का फ़्लैग इस्तेमाल करना है.

फ़्लैग के इस्तेमाल का पता लगाना

सुविधा लॉन्च करने के लिए फ़्लैग का इस्तेमाल कब करना है, यह तय करने के लिए इन दिशा-निर्देशों का पालन करें:

  • अगर कोई ऐसा बदलाव किया जा रहा है जिसकी वजह से AOSP कोडबेस अस्थिर हो सकता है, तो सुविधा लॉन्च करने के लिए फ़्लैग का इस्तेमाल करें. जैसे, कोई नई सुविधा जोड़ना या किसी खास तरह के गड़बड़ी को ठीक करना.

  • इसके उलट, अगर कोड में बदलाव किया जा रहा है, तो कोड बेस में बदलाव न कर सके, जैसे कि टिप्पणियों में बदलाव करना. ऐसे में, आपको फ़ीचर लॉन्च फ़्लैग.

फ़्लैग का टाइप तय करना

फ़्लैग दो तरह के होते हैं: aconfig फ़्लैग और बिल्ड फ़्लैग.

Aconfig फ़्लैग

Aconfig फ़्लैग का इस्तेमाल रिलीज़ नहीं हुए कोड के निष्पादन को अलग करने के लिए किया जाता है टेस्ट और रिलीज़ प्रोसेस के दौरान कोड रिलीज़ किया जाता है. Aconfig फ़्लैग, रीड-राइट या रीड-ओनली हो सकते हैं:

  • रीड-राइट कॉन्फ़िगरेशन फ़्लैग बूलियन वैरिएबल हैं. इन्हें चालू किया जा सकता है. इन वैरिएबल को इस पर सेट करें: true) या रनटाइम के दौरान बंद (false पर सेट करें) करना होगा. मुख्य शाखा के स्टेबिलिटी पर असर डाले बिना, बदलावों को टेस्ट करने और रिलीज़ करने के लिए, रीड-राइट फ़्लैग का इस्तेमाल करें.

  • रीड-ओनली aconfig फ़्लैग, बूलियन कॉन्स्टेंट होते हैं. इन्हें रनटाइम के दौरान बदला नहीं जा सकता. रीड-राइट कॉन्फ़िगरेशन फ़्लैग को रीड-ओनली कॉन्फ़िगरेशन वाले फ़्लैग में बदला जा सकता है जो स्थायी कोड और रिलीज़ के लिए तैयार है.

    इसके अलावा, आपके इस्तेमाल किए जा रहे कंपाइलर के आधार पर, जब कोई रीड-ओनली फ़्लैग होता है का इस्तेमाल किया है, तो हो सकता है कि चलाया न गया कोड बाहर रखा गया हो बिल्ड में मौजूद है. इसलिए, रीड-ओनली फ़्लैग का इस्तेमाल करके, किसी भी ऐसे कोड को छिपाया जा सकता है जो रिलीज़ का हिस्सा नहीं है.

फ़्लैग बनाएं

बिल्ड फ़्लैग, बिल्ड-टाइम कॉन्सटेंट (स्ट्रिंग) होते हैं और इन्हें इस दौरान नहीं बदला जा सकता रनटाइम. इन फ़्लैग का इस्तेमाल उन स्थितियों में करें जहां कॉन्फ़िगरेशन फ़्लैग का इस्तेमाल नहीं किया जा सकता, जैसे:

  • आपके पास पहले से कंपाइल किया गया या पहले से बना कोड है, जिसे आपको बिल्ड में शामिल करना है.
  • सिस्टम को बनाने में आपको बदलाव करना हो.
  • आपको कोड के साइज़ को मैनेज करने के लिए, डिपेंडेंसी के आस-पास फ़्लैग लगाने हैं.