कंडिशनल डिलीवरी कॉन्फ़िगर करें

शर्तों के हिसाब से डिलीवरी की सुविधा से, डिवाइस कॉन्फ़िगरेशन की कुछ ज़रूरी शर्तें सेट की जा सकती हैं. इससे ऐप्लिकेशन इंस्टॉल करने के दौरान, फ़ीचर मॉड्यूल अपने-आप डाउनलोड हो जाते हैं. उदाहरण के लिए, डेवलपर ऐसा फ़ीचर मॉड्यूल कॉन्फ़िगर कर सकते हैं जिसमें ऑगमेंटेड रिएलिटी (एआर) की सुविधा शामिल हो. इससे, ऐप्लिकेशन इंस्टॉल करने पर यह सुविधा सिर्फ़ उन डिवाइसों पर उपलब्ध होगी जो एआर के साथ काम करते हैं.

फ़िलहाल, डिलीवरी के इस तरीके से, ऐप्लिकेशन इंस्टॉल करते समय मॉड्यूल के डाउनलोड को कंट्रोल किया जा सकता है. इसके लिए, डिवाइस के इन कॉन्फ़िगरेशन का इस्तेमाल किया जाता है:

अगर कोई डिवाइस आपकी बताई गई सभी ज़रूरी शर्तें पूरी नहीं करता है, तो ऐप्लिकेशन इंस्टॉल करते समय मॉड्यूल डाउनलोड नहीं होता. हालांकि, आपका ऐप्लिकेशन बाद में Play Core SDK टूल का इस्तेमाल करके, मांग पर मॉड्यूल डाउनलोड करने का अनुरोध कर सकता है.

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

शर्तों के साथ डिलीवरी के विकल्पों वाला नया मॉड्यूल जोड़ना

शर्त के साथ डिलीवरी की सुविधा वाला नया फ़ीचर मॉड्यूल बनाने का सबसे आसान तरीका, नया मॉड्यूल विज़र्ड है. इसके लिए, यह तरीका अपनाएं:

  1. नया मॉड्यूल डायलॉग खोलने के लिए, मेन्यू बार में जाकर फ़ाइल > नया > नया मॉड्यूल को चुनें.
  2. New Module डायलॉग बॉक्स में, Dynamic Feature Module को चुनें और Next पर क्लिक करें.
  3. अपने मॉड्यूल को सामान्य तरीके से कॉन्फ़िगर करें और आगे बढ़ें पर क्लिक करें.
  4. Module Download Options सेक्शन में, यह तरीका अपनाएं:

    1. मॉड्यूल का टाइटल डालें. इसमें ज़्यादा से ज़्यादा 50 वर्ण होने चाहिए. प्लैटफ़ॉर्म इस टाइटल का इस्तेमाल, उपयोगकर्ताओं को मॉड्यूल की पहचान कराने के लिए करता है. उदाहरण के लिए, यह पुष्टि करने के लिए कि उपयोगकर्ता को मॉड्यूल डाउनलोड करना है या नहीं. इस वजह से, आपके ऐप्लिकेशन के बेस मॉड्यूल में, मॉड्यूल का टाइटल स्ट्रिंग रिसॉर्स के तौर पर शामिल होना चाहिए. इसे अनुवाद किया जा सकता है. Android Studio का इस्तेमाल करके मॉड्यूल बनाते समय, IDE आपके लिए बेस मॉड्यूल में स्ट्रिंग रिसॉर्स जोड़ता है. साथ ही, फ़ीचर मॉड्यूल के मेनिफ़ेस्ट में यह एंट्री इंजेक्ट करता है:

      <dist:module
          ...
          dist:title="@string/feature_title">
      </dist:module>
      
    2. इंस्टॉल के समय शामिल करें के ड्रॉप-डाउन मेन्यू में जाकर, सिर्फ़ उन डिवाइसों के लिए ऐप्लिकेशन इंस्टॉल करते समय मॉड्यूल शामिल करें जिनमें बताई गई सुविधाएं मौजूद हैं को चुनें. इससे एक ऐसा मॉड्यूल बनता है जो ऐप्लिकेशन इंस्टॉल करते समय, सिर्फ़ उन डिवाइसों पर आपके ऐप्लिकेशन के साथ शामिल होता है जिनमें आपके बताए गए कॉन्फ़िगरेशन मौजूद होते हैं. जैसे, डिवाइस की सुविधाएं या देश. Android Studio, मॉड्यूल के मेनिफ़ेस्ट में ये चीज़ें इंजेक्ट करता है, ताकि आपकी पसंद के मुताबिक बदलाव किए जा सकें:

      <dist:module ... >
        <dist:delivery>
            <dist:install-time>
                <dist:conditions>
                    <!-- If you specify conditions, as described in the steps
                         below, the IDE includes them here. -->
                </dist:conditions>
            </dist:install-time>
        </dist:delivery>
      </dist:module>
      
    3. अगर आपको मॉड्यूल के अपने-आप डाउनलोड होने की सुविधा को कुछ देशों या कम से कम एपीआई लेवल तक सीमित करना है, तो मॉड्यूल बनाने की प्रोसेस पूरी करने के लिए, पूरा करें पर क्लिक करें. इसके बाद, देश या कम से कम एपीआई लेवल के आधार पर शर्तें तय करने के बारे में जानकारी देने वाला सेक्शन पढ़ें. अगर ऐसा नहीं है, तो + डिवाइस की सुविधा पर क्लिक करके, ऐसी सुविधा जोड़ें जिसकी ज़रूरत किसी डिवाइस को इंस्टॉल के समय मॉड्यूल डाउनलोड करने के लिए होती है.

    4. डिवाइस की सुविधा के बगल में मौजूद ड्रॉप-डाउन मेन्यू से, इनमें से कोई एक विकल्प चुनें और उसकी वैल्यू तय करें:

      • Name: इससे आपको हार्डवेयर या सॉफ़्टवेयर की ऐसी सुविधा के बारे में बताने में मदद मिलती है जो किसी डिवाइस को इंस्टॉल के समय मॉड्यूल डाउनलोड करने के लिए ज़रूरी होती है. शर्तों के साथ डिलीवरी की सुविधा, उन सुविधाओं के साथ काम करती है जो PackageManager के FEATURE_* कॉन्सटेंट के तौर पर लिस्ट की गई हैं. अगर आपने यह विकल्प चुना है, तो ड्रॉप-डाउन मेन्यू के बगल में मौजूद फ़ील्ड में, सुविधा की कॉन्स्टेंट वैल्यू का कोई भी हिस्सा टाइप करना शुरू करें. जैसे, "ब्लूटूथ". इसके बाद, दिखने वाले सुझावों में से कोई एक चुनें.
      • OpenGL ES वर्शन: इससे OpenGL ES का वह वर्शन तय किया जा सकता है जो किसी डिवाइस को इंस्टॉल करते समय मॉड्यूल डाउनलोड करने के लिए ज़रूरी होता है. अगर आपने यह विकल्प चुना है, तो ड्रॉप-डाउन मेन्यू के बगल में मौजूद फ़ील्ड में वर्शन टाइप करना शुरू करें, जैसे कि "0x00030001". इसके बाद, दिखने वाले सुझावों में से कोई एक चुनें.
    5. अगर आपको डिवाइस की उपलब्ध सुविधाओं के आधार पर कई शर्तें जोड़नी हैं, तो हर शर्त के लिए + डिवाइस की सुविधा पर क्लिक करें.

    6. अगर आपको इस मॉड्यूल को Android 4.4 (एपीआई लेवल 20) और इससे पहले के वर्शन वाले डिवाइसों के लिए उपलब्ध कराना है, तो फ़्यूज़िंग के बगल में मौजूद बॉक्स को चुनें. साथ ही, इसे मल्टी-APK में शामिल करें. इसका मतलब है कि इस मॉड्यूल के लिए, मांग पर उपलब्ध होने की सुविधा चालू की जा सकती है. साथ ही, फ़्यूज़ करने की सुविधा को बंद किया जा सकता है, ताकि इसे उन डिवाइसों से हटाया जा सके जो split APKs को डाउनलोड और इंस्टॉल नहीं कर सकते. Android Studio, आपकी पसंद के हिसाब से मॉड्यूल के मेनिफ़ेस्ट में यह जानकारी डालता है:

      <dist:module ...>
          <dist:fusing dist:include="true | false" />
      </dist:module>
      
  5. मॉड्यूल डाउनलोड करने के विकल्पों को कॉन्फ़िगर करने के बाद, Finish पर क्लिक करें.

ध्यान दें कि Android Gradle प्लग इन, डाइनैमिक-फ़ीचर मॉड्यूल से लिंट चलाने की सुविधा के साथ काम नहीं करता. किसी ऐप्लिकेशन मॉड्यूल से लिंट चलाने पर, उसके डाइनैमिक-फ़ीचर मॉड्यूल पर लिंट चलेगा. साथ ही, ऐप्लिकेशन की लिंट रिपोर्ट में सभी समस्याएं शामिल होंगी.

किसी मौजूदा फ़ीचर मॉड्यूल में, कुछ शर्तों के साथ डिलीवरी के विकल्प जोड़ना

मॉड्यूल के मेनिफ़ेस्ट की मदद से, किसी मौजूदा फ़ीचर मॉड्यूल में शर्त के हिसाब से डिलीवरी के विकल्प जोड़े जा सकते हैं. हालांकि, आपको पहले शर्त के हिसाब से डिलीवरी के विकल्पों की काम करने की क्षमता के बारे में पढ़ना चाहिए. साथ ही, डिलीवरी के उन अन्य विकल्पों के बारे में भी पढ़ना चाहिए जिन्हें आपने पहले से चालू किया हुआ है.

शुरू करने के लिए, आपको सबसे पहले अपने मेनिफ़ेस्ट को नए <dist:delivery> एलिमेंट पर माइग्रेट करना होगा. नीचे दिए गए कोड स्निपेट में, पुराने सिंटैक्स का एक उदाहरण दिया गया है:

<!-- This is the old syntax. -->
<dist:module
  dist:title="@string/feature_title" dist:onDemand="true">
  <dist:fusing dist:include="true"/>
</dist:module>

डिलीवरी के ऊपर दिए गए विकल्पों को अब इस तरह से बताया गया है.

<dist:module
  dist:title="@string/feature_title">
  <dist:delivery>
      <dist:on-demand/>
  </dist:delivery>
  <dist:fusing dist:include="true"/>
</dist:module>

इसके बाद, डिवाइस की सुविधाओं के आधार पर, कुछ शर्तों के साथ डिलीवरी के विकल्प शामिल किए जा सकते हैं.

<dist:module
    dist:title="@string/feature_title">
    <dist:delivery>
      <dist:on-demand/>
      <dist:install-time>
        <dist:conditions>
          <!-- Requires that the device support AR to download the module at
          app install-time.  -->
          <dist:device-feature dist:name="android.hardware.camera.ar"/>
        </dist:conditions>
      </dist:install-time>
    </dist:delivery>
    <dist:fusing dist:include="true"/>
</dist:module>

नीचे दिए गए सेक्शन में, शर्त के हिसाब से डिलीवरी के अन्य विकल्पों के बारे में बताया गया है. जैसे, देश या कम से कम एपीआई लेवल के हिसाब से डिलीवरी.

मॉड्यूल डाउनलोड करने के अन्य विकल्पों के साथ काम करना

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

मॉड्यूल डाउनलोड करने का विकल्प शर्तों के साथ डिलीवरी की सुविधा के साथ काम करना
फ़्यूज़ किया जा रहा है (<dist:fusing dist:include="true"/>) अगर कोई मॉड्यूल इस विकल्प को 'सही' पर सेट करता है, तो Google Play, एपीआई लेवल 19 या इससे पहले के लेवल पर काम करने वाले डिवाइसों पर आपका ऐप्लिकेशन डिप्लॉय करते समय, आपके तय किए गए शर्तों के साथ डिलीवरी के विकल्पों का पालन नहीं करता है. इसका मतलब है कि फ़्यूज़िंग की सुविधा देने वाले फ़ीचर मॉड्यूल, एपीआई लेवल 19 या इससे पहले के वर्शन पर काम करने वाले डिवाइसों के लिए, इंस्टॉल के समय हमेशा शामिल किए जाते हैं.
झटपट खुलने वाला (<dist:module dist:instant="true"/>) झटपट खुलने वाले फ़ीचर मॉड्यूल के लिए, शर्त के साथ डिलीवरी के विकल्प इस्तेमाल नहीं किए जा सकते.
ऑन डिमांड (<dist:on-demand/>) डिफ़ॉल्ट रूप से, अगर आपने कुछ शर्तों के साथ डिलीवरी के विकल्प तय किए हैं, तो मॉड्यूल मांग पर भी उपलब्ध होता है.

देश के हिसाब से शर्तें तय करना

शर्तों के हिसाब से डिलीवरी की सुविधा से, यह भी तय किया जा सकता है कि ऐप्लिकेशन इंस्टॉल करते समय, आपको किन देशों में मॉड्यूल डाउनलोड करने की सुविधा देनी है या नहीं देनी है. इस शर्त को तय करना तब काम आ सकता है, जब आपका मॉड्यूल पेमेंट का ऐसा तरीका लागू करता हो जो कुछ इलाकों में उपलब्ध न हो.

इस मामले में, डिवाइस के देश का पता आम तौर पर, उपयोगकर्ता के Google Play खाते में रजिस्टर किए गए बिलिंग पते से चलता है.

अपने मॉड्यूल के लिए देशों की जानकारी देने के लिए, फ़ीचर मॉड्यूल के मेनिफ़ेस्ट में यह जानकारी शामिल करें.

<dist:conditions>
   <!-- Set to "true" to specify countries to exclude from downloading
   this module at app install-time. By default, modules are available
   for download to all user countries. -->
  <dist:user-countries dist:exclude="true">
    <!-- Specifies the two-letter  CLDR country code for regions that should
    not download the module at app install-time. -->
    <dist:country dist:code="CN"/>
    <dist:country dist:code="HK"/>
  </dist:user-countries>
</dist:conditions>

एपीआई लेवल के लिए शर्तें तय करना

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

डिवाइस के कम से कम या ज़्यादा से ज़्यादा एपीआई लेवल के आधार पर शर्त सेट करने के लिए, अपने फ़ीचर मॉड्यूल के मेनिफ़ेस्ट में यह शामिल करें.

<dist:conditions>
    <!-- Specifies the minimum API level that the device must satisfy
         in order to download your module at app install-time. The API level you
         specify must be greater or equal to the module's own minSdkVersion. -->
   <dist:min-sdk dist:value="21"/>
    <!-- Specifies the maximum API level that the device cannot exceed
         in order to download your module at app install-time. The API level you
         specify must be less than or equal to the module's own maxSdkVersion. -->
   <dist:max-sdk dist:value="24"/>
</dist:conditions>

डिवाइस की अन्य प्रॉपर्टी के लिए शर्तें तय करना (बीटा वर्शन)

डिवाइस की अन्य प्रॉपर्टी के लिए शर्तें तय करने के लिए, डिवाइस टारगेटिंग की कॉन्फ़िगरेशन फ़ाइल का इस्तेमाल किया जा सकता है. जैसे, मॉडल का नाम, रैम, सिस्टम की सुविधाएं, और चिप पर सिस्टम (SoC).

डिवाइस टारगेटिंग की कॉन्फ़िगरेशन फ़ाइल बनाने के लिए, डिवाइस टारगेटिंग के दस्तावेज़ देखें.

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

<dist:conditions>
   <dist:device-groups>
      <dist:device-group dist:name="myCustomGroup1"/>
      <dist:device-group dist:name="myCustomGroup2"/>
   </dist:device-groups>
</dist:conditions>