सुविधा लॉन्च करने के फ़्लैग की वैल्यू सेट करना

डिफ़ॉल्ट रूप से, सभी फ़ीचर लॉन्च फ़्लैग READ_WRITE होते हैं और DISABLED पर सेट होते हैं. किसी फ़ीचर की जांच करने से पहले, आपको फ़्लैग के लिए फ़्लैग वैल्यू वाली फ़ाइल बनाकर, बिल्ड में इस्तेमाल की गई डिफ़ॉल्ट वैल्यू को बदलनी होगी. फ़्लैग वैल्यू वाली फ़ाइल में, हर फ़्लैग की स्थिति (ENABLED या DISABLED) और अनुमति (READ_WRITE या READ_ONLY) सेट की जाती है.

रिलीज़ कॉन्फ़िगरेशन एक डायरेक्ट्री होती है. इसमें Android के किसी खास बिल्ड के लिए, फ़्लैग वैल्यू वाली सभी फ़ाइलें शामिल होती हैं. इसमें कुछ फ़ीचर चालू और कुछ बंद होते हैं.

AOSP में, रिलीज़ के कुछ कॉन्फ़िगरेशन शामिल होते हैं. जैसे, trunk_staging. रिलीज़ कॉन्फ़िगरेशन वाली डायरेक्ट्री, WORKING_DIRECTORY/build/release/aconfig/ में मौजूद होती हैं.

टारगेट चुनने के लिए, lunch कमांड का इस्तेमाल करने पर, टारगेट के लिए रिलीज़ कॉन्फ़िगरेशन भी सेट हो जाता है. उदाहरण के लिए, यहां trunk_staging टारगेट दिया गया है:

lunch aosp_cf_x86_64_only_phone-trunk_staging-userdebug

ट्रंक स्टेजिंग, डेवलपमेंट रिलीज़ कॉन्फ़िगरेशन है, क्योंकि Google इसका इस्तेमाल, सामान्य रिलीज़ से पहले फ़ीचर की जांच करने के लिए करता है. इस कॉन्फ़िगरेशन में, ज़्यादातर READ_WRITE फ़्लैग का इस्तेमाल किया जाता है. इनकी मदद से, रनटाइम पर फ़ीचर चालू या बंद करके, अपने कोड की जांच की जा सकती है.

सामान्य रिलीज़ के लिए, रिलीज़ रिलीज़ कॉन्फ़िगरेशन का इस्तेमाल करें. रिलीज़ रिलीज़ कॉन्फ़िगरेशन में, ज़्यादातर READ_ONLY फ़्लैग का इस्तेमाल किया जाता है. साथ ही, इसमें उस रिलीज़ के लिए चालू किए गए सभी कोड दिखते हैं.

trunk_staging रिलीज़ कॉन्फ़िगरेशन में फ़्लैग जोड़ना

किसी नए फ़्लैग की जांच करने के लिए, उसे trunk_staging रिलीज़ कॉन्फ़िगरेशन में इस तरह जोड़ें:

1. WORKING_DIRECTORY/build/release/aconfig/trunk_staging/ पर जाएं
2. अपने फ़्लैग के पैकेज के नाम से एक डायरेक्ट्री बनाएं. जैसे, com.example.android.aconfig.demo.flags Java के लिए aconfig फ़्लैग की जानकारी देना में दिखाया गया है.
3. नई डायरेक्ट्री पर जाएं.
4. डायरेक्ट्री में, फ़्लैग वैल्यू वाली एक फ़ाइल बनाएं. इसमें फ़्लैग के एलान (.aconfig) वाली फ़ाइल में इस्तेमाल किया गया नाम शामिल हो. जैसे, my_static_flag में दिखाया गया Java के लिए aconfig फ़्लैग की जानकारी देना के साथ _flag_values.textproto. इससे बनने वाली फ़ाइल का नाम my_static_flag_flag_values.textproto होगा.

5. फ़ाइल में बदलाव करें और इसमें, यहां दिए गए उदाहरण जैसा flag_value जोड़ें:

   flag_value {
     package: "com.example.android.aconfig.demo.flags"
     name: "my_static_flag"
     state: DISABLED
     Permission: READ_WRITE
   }
   

   यहां:

   • package में, एलान में इस्तेमाल किया गया पैकेज का नाम शामिल होता है.
   • name में, एलान में इस्तेमाल किया गया नाम शामिल होता है.
   • state की वैल्यू ENABLED या DISABLED होती है.
   • permission की वैल्यू READ_WRITE या READ_ONLY होती है. आम तौर पर, रिलीज़ कॉन्फ़िगरेशन का हिस्सा बनने वाली फ़्लैग वैल्यू वाली फ़ाइलों के लिए, permission की वैल्यू READ_ONLY पर सेट होती है.

6. फ़ाइल सेव करें और एडिटर से बाहर निकलें.

7. फ़्लैग वैल्यू वाली फ़ाइल की डायरेक्ट्री में, Android.bp नाम की एक बिल्ड फ़ाइल बनाएं. इस फ़ाइल का इस्तेमाल, बिल्ड में फ़्लैग वैल्यू वाली फ़ाइल को शामिल करने के लिए किया जाता है.

8. Android.bp फ़ाइल में, यहां दिए गए उदाहरण जैसा aconfig_values सेक्शन बनाएं:

   aconfig_values {
     name: "aconfig-values-platform_build_release-trunk-staging-com.example.android.aconfig.demo.flags-all",
     package: "com.example.android.aconfig.demo.flags",
     srcs: [
       "*_flag_values.textproto",
     ]
   }
   

   यहां:

   • name, Soong बिल्ड मॉड्यूल का यूनीक नाम होता है. Google, कन्वेंशन का इस्तेमाल करता है aconfig-values-platform_PATH_TO_RELEASE_CONFIG_DIR-CONFIG_NAME-package.name-all. यह नाम, पैरंट डायरेक्ट्री की Android.bp फ़ाइल में aconfig_value_set के एलान के आधार पर, Soong के ऑटोमैटिक तरीके से जनरेट किए गए नाम से मेल खाना चाहिए. ध्यान दें कि PATH_TO_RELEASE_CONFIG_DIR की वैल्यू build_release होती है.
   • package में, एलान में इस्तेमाल किया गया पैकेज का नाम शामिल होता है.
   • srcs, फ़्लैग वैल्यू वाली आपकी सभी फ़ाइलों की सूची होती है.

9. फ़ाइल सेव करें और एडिटर से बाहर निकलें.

10. मौजूदा डायरेक्ट्री से ऊपर वाली डायरेक्ट्री पर जाएं (cd ..)

11. Android को बिल्ड करें और अपने नए कोड को चलाकर देखें कि वह फ़्लैग वैल्यू वाली फ़ाइल में दी गई सेटिंग के मुताबिक काम कर रहा है या नहीं.