Play Feature Delivery के बारे में खास जानकारी

Google Play का ऐप्लिकेशन उपलब्ध कराने वाला मॉडल, हर उपयोगकर्ता के डिवाइस कॉन्फ़िगरेशन के लिए ऑप्टिमाइज़ किए गए APKs जनरेट और उन्हें उपलब्ध कराने के लिए, Android ऐप्लिकेशन बंडल का इस्तेमाल करता है. इससे, उपयोगकर्ता सिर्फ़ वही कोड और संसाधन डाउनलोड करते हैं जो आपके ऐप्लिकेशन को चलाने के लिए ज़रूरी होते हैं.

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

फ़ीचर मॉड्यूल का बिल्ड कॉन्फ़िगरेशन

Android Studio का इस्तेमाल करके कोई नया सुविधा मॉड्यूल बनाने पर, IDE, मॉड्यूल की build.gradle फ़ाइल में नीचे दिया गया Gradle प्लग इन लागू करता है.

// The following applies the dynamic-feature plugin to your feature module.
// The plugin includes the Gradle tasks and properties required to configure and build
// an app bundle that includes your feature module.

plugins {
  id 'com.android.dynamic-feature'
}

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

सुविधा वाले मॉड्यूल के बिल्ड कॉन्फ़िगरेशन में क्या शामिल नहीं करना चाहिए

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

• साइन करने के कॉन्फ़िगरेशन: ऐप्लिकेशन बंडल को साइन करने के लिए, साइन करने के उन कॉन्फ़िगरेशन का इस्तेमाल किया जाता है जिन्हें आपने बेस मॉड्यूल में बताया है.
• minifyEnabled प्रॉपर्टी: सिर्फ़ बुनियादी मॉड्यूल के बिल्ड कॉन्फ़िगरेशन से, अपने पूरे ऐप्लिकेशन प्रोजेक्ट के लिए कोड छोटा करने की सुविधा चालू की जा सकती है. इसलिए, आपको इस प्रॉपर्टी को सुविधा वाले मॉड्यूल से हटा देना चाहिए. हालांकि, हर सुविधा मॉड्यूल के लिए, ProGuard के अन्य नियम तय किए जा सकते हैं.
• versionCode और versionName: ऐप्लिकेशन बंडल बनाते समय, Gradle, ऐप्लिकेशन के वर्शन की उस जानकारी का इस्तेमाल करता है जो बेस मॉड्यूल उपलब्ध कराता है. आपको अपने सुविधा मॉड्यूल की build.gradle फ़ाइल से इन प्रॉपर्टी को हटा देना चाहिए.

बेस मॉड्यूल से संबंध जोड़ना

जब Android Studio आपका फ़ीचर मॉड्यूल बनाता है, तो वह इसे बेस मॉड्यूल के लिए दिखने लायक बना देता है. इसके लिए, वह बेस मॉड्यूल की build.gradle फ़ाइल में android.dynamicFeatures प्रॉपर्टी जोड़ता है. इस बारे में यहां बताया गया है:

// In the base module’s build.gradle file.
android {
    ...
    // Specifies feature modules that have a dependency on
    // this base module.
    dynamicFeatures = [":dynamic_feature", ":dynamic_feature2"]
}

इसके अलावा, Android Studio में बेस मॉड्यूल को सुविधा मॉड्यूल की डिपेंडेंसी के तौर पर शामिल किया जाता है, जैसा कि यहां दिखाया गया है:

// In the feature module’s build.gradle file:
...
dependencies {
    ...
    // Declares a dependency on the base module, ':app'.
    implementation project(':app')
}

ProGuard के अन्य नियमों के बारे में बताना

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

android.buildTypes {
     release {
         // You must use the following property to specify additional ProGuard
         // rules for feature modules.
         proguardFiles 'proguard-rules-dynamic-features.pro'
     }
}

ध्यान दें कि ProGuard के इन नियमों को बिल्ड के समय, अन्य मॉड्यूल (इनमें बेस मॉड्यूल भी शामिल है) के नियमों के साथ मर्ज किया जाता है. इसलिए, हर सुविधा वाले मॉड्यूल में नियमों का एक नया सेट तय किया जा सकता है. हालांकि, ये नियम ऐप्लिकेशन प्रोजेक्ट के सभी मॉड्यूल पर लागू होते हैं.

अपना ऐप्लिकेशन डिप्लॉय करना

सुविधा वाले मॉड्यूल के साथ अपना ऐप्लिकेशन डेवलप करते समय, कनेक्ट किए गए डिवाइस पर अपने ऐप्लिकेशन को डिप्लॉय किया जा सकता है. इसके लिए, मेन्यू बार से रन करें > रन करें को चुनें या टूलबार में रन करें पर क्लिक करें.

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

1. मेन्यू बार से, चलाएं > कॉन्फ़िगरेशन में बदलाव करें को चुनें.
2. रन/डीबग कॉन्फ़िगरेशन डायलॉग के बाएं पैनल से, अपनी पसंद का Android ऐप्लिकेशन कॉन्फ़िगरेशन चुनें.
3. सामान्य टैब में, डिप्लॉय करने के लिए डाइनैमिक सुविधाएं में जाकर, हर उस सुविधा मॉड्यूल के बगल में मौजूद बॉक्स को चुनें जिसे आपको ऐप्लिकेशन डिप्लॉय करते समय शामिल करना है.
4. ठीक है पर क्लिक करें.

डिफ़ॉल्ट रूप से, Android Studio आपके ऐप्लिकेशन को डिप्लॉय करने के लिए, ऐप्लिकेशन बंडल का इस्तेमाल नहीं करता. इसके बजाय, IDE आपके डिवाइस पर ऐसे APK बनाता और इंस्टॉल करता है जो APK के साइज़ के बजाय, डिप्लॉय करने की स्पीड के लिए ऑप्टिमाइज़ किए जाते हैं. अगर आपको Android Studio को ऐप्लिकेशन बंडल से APK और इंस्टैंट ऐप्लिकेशन बनाने और डिप्लॉय करने के लिए कॉन्फ़िगर करना है, तो अपने रन/डीबग कॉन्फ़िगरेशन में बदलाव करें.

पसंद के मुताबिक डिलीवरी के लिए, सुविधा वाले मॉड्यूल इस्तेमाल करना

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

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

मान लें कि आपने एक ऐसा ऐप्लिकेशन बनाया है जिसमें उपयोगकर्ताओं को ऑनलाइन मार्केटप्लेस पर सामान खरीदने और बेचने की सुविधा मिलती है. ऐप्लिकेशन की इन सभी सुविधाओं को अलग-अलग सुविधा मॉड्यूल में मॉड्यूलर तरीके से व्यवस्थित किया जा सकता है:

• खाते में लॉगिन करना और खाता बनाना
• मार्केटप्लेस को ब्राउज़ करना
• किसी आइटम को बिक्री के लिए उपलब्ध कराना
• पेमेंट प्रोसेस करना

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

किसी संसाधन के लिए यूआरआई बनाना

अगर आपको किसी सुविधा वाले मॉड्यूल में सेव किए गए रिसॉर्स को यूआरआई का इस्तेमाल करके ऐक्सेस करना है, तो Uri.Builder() का इस्तेमाल करके, सुविधा वाले मॉड्यूल के रिसॉर्स का यूआरआई जनरेट करने का तरीका यहां बताया गया है:

val uri = Uri.Builder()
                .scheme(ContentResolver.SCHEME_ANDROID_RESOURCE)
                .authority(context.getPackageName()) // Look up the resources in the application with its splits loaded
                .appendPath(resources.getResourceTypeName(resId))
                .appendPath(String.format("%s:%s",
                  resources.getResourcePackageName(resId), // Look up the dynamic resource in the split namespace.
                  resources.getResourceEntryName(resId)
                  ))
                .build()

String uri = Uri.Builder()
                .scheme(ContentResolver.SCHEME_ANDROID_RESOURCE)
                .authority(context.getPackageName()) // Look up the resources in the application with its splits loaded
                .appendPath(resources.getResourceTypeName(resId))
                .appendPath(String.format("%s:%s",
                  resources.getResourcePackageName(resId), // Look up the dynamic resource in the split namespace.
                  resources.getResourceEntryName(resId)
                  ))
                .build().toString();

रिसॉर्स के पाथ का हर हिस्सा, रन टाइम पर बनाया जाता है. इससे यह पक्का किया जाता है कि अलग-अलग APK लोड होने के बाद, सही नेमस्पेस जनरेट हो.

यूआरआई जनरेट करने के तरीके के उदाहरण के तौर पर, मान लें कि आपके पास इन नामों के साथ एक ऐप्लिकेशन और फ़ीचर मॉड्यूल हैं:

• ऐप्लिकेशन के पैकेज का नाम: com.example.my_app_package
• सुविधा के संसाधनों के पैकेज का नाम: com.example.my_app_package.my_dynamic_feature

अगर ऊपर दिए गए कोड स्निपेट में मौजूद resId, आपके फ़ीचर मॉड्यूल में “my_video” नाम के रॉ फ़ाइल रिसॉर्स का रेफ़रंस देता है, तो ऊपर दिया गया Uri.Builder() कोड यह आउटपुट देगा:

android.resource://com.example.my_app_package/raw/com.example.my_app_package.my_dynamic_feature:my_video

इसके बाद, आपका ऐप्लिकेशन इस यूआरआई का इस्तेमाल करके, फ़ीचर मॉड्यूल के संसाधन को ऐक्सेस कर सकता है.

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

फ़ीचर मॉड्यूल के लिए ध्यान देने वाली बातें

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

• किसी शर्त के साथ या मांग पर डिलीवरी की सुविधा का इस्तेमाल करके, किसी एक डिवाइस पर 50 या उससे ज़्यादा सुविधा वाले मॉड्यूल इंस्टॉल करने पर, परफ़ॉर्मेंस से जुड़ी समस्याएं आ सकती हैं. इंस्टॉल के समय डिलीवर होने वाले ऐसे मॉड्यूल जो हटाए जा सकने वाले के तौर पर कॉन्फ़िगर नहीं किए गए हैं, वे बेस मॉड्यूल में अपने-आप शामिल हो जाते हैं. साथ ही, हर डिवाइस पर सिर्फ़ एक फ़ीचर मॉड्यूल के तौर पर गिने जाते हैं.
• इंस्टॉल के समय डिलीवरी के लिए, हटाए जा सकने वाले तौर पर कॉन्फ़िगर किए गए मॉड्यूल की संख्या को 10 या उससे कम पर सीमित करें. ऐसा न करने पर, आपके ऐप्लिकेशन को डाउनलोड और इंस्टॉल करने में ज़्यादा समय लग सकता है.
• मांग पर सुविधाएं डाउनलोड और इंस्टॉल करने की सुविधा, सिर्फ़ Android 5.0 (एपीआई लेवल 21) और इसके बाद के वर्शन वाले डिवाइसों पर काम करती है. अपनी सुविधा को Android के पुराने वर्शन के लिए उपलब्ध कराने के लिए, सुविधा मॉड्यूल बनाते समय फ़्यूज़ करना चालू करें.
• SplitCompat को चालू करें, ताकि आपके ऐप्लिकेशन के पास, मांग पर डिलीवर किए जाने वाले डाउनलोड किए गए सुविधा मॉड्यूल का ऐक्सेस हो.
• सुविधा वाले मॉड्यूल को अपने मेनिफ़ेस्ट में, गतिविधियों की जानकारी नहीं देनी चाहिए. इसके लिए, android:exported को true पर सेट करें. ऐसा इसलिए है, क्योंकि इस बात की कोई गारंटी नहीं है कि जब कोई दूसरा ऐप्लिकेशन गतिविधि शुरू करने की कोशिश करेगा, तब डिवाइस पर सुविधा मॉड्यूल डाउनलोड हो जाएगा. इसके अलावा, आपके ऐप्लिकेशन को किसी सुविधा के कोड और संसाधनों को ऐक्सेस करने से पहले, यह पुष्टि करनी चाहिए कि वह सुविधा डाउनलोड की गई है. ज़्यादा जानने के लिए, इंस्टॉल किए गए मॉड्यूल मैनेज करना लेख पढ़ें.
• Play Feature Delivery की सुविधा का इस्तेमाल करने के लिए, आपको ऐप्लिकेशन बंडल का इस्तेमाल करके अपना ऐप्लिकेशन पब्लिश करना होगा. इसलिए, पक्का करें कि आपको ऐप्लिकेशन बंडल से जुड़ी जानी-पहचानी समस्याओं के बारे में पता हो.

फ़ीचर मॉड्यूल मेनिफ़ेस्ट का रेफ़रंस

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

अन्य संसाधन

सुविधा वाले मॉड्यूल इस्तेमाल करने के बारे में ज़्यादा जानने के लिए, नीचे दिए गए संसाधन देखें.

ब्लॉग पोस्ट

• Google Play पर अपने कारोबार को डेवलप करने, रिलीज़ करने, और उसमें बढ़ोतरी करने में मदद करने वाली नई सुविधाएं
• Android ऐप्लिकेशन बंडल के नए अपडेट, जिनमें अन्य भाषाओं के एपीआई भी शामिल हैं
• पैचवर्क प्लेड — मॉड्यूलर बनाने की कहानी

वीडियो

• ऐप्लिकेशन बंडल की मदद से, अपनी पसंद के मुताबिक डिलीवरी और टेस्ट बिल्ड को आसानी से शेयर करना
• अपने ऐप्लिकेशन के साइज़ को ऑप्टिमाइज़ करने और Google Play पर इंस्टॉल की संख्या बढ़ाने के लिए नए टूल

सेवा की शर्तें और डेटा की सुरक्षा

Play की सुविधा डिलीवरी लाइब्रेरी को ऐक्सेस या इस्तेमाल करने का मतलब है कि आप Play Core Software Development Kit की सेवा की शर्तों से सहमत हैं. लाइब्रेरी को ऐक्सेस करने से पहले, कृपया इस पर लागू होने वाली सभी शर्तों और नीतियों को पढ़कर समझ लें.

डेटा की सुरक्षा

Play Core लाइब्रेरी, Google Play Store के साथ आपके ऐप्लिकेशन का रनटाइम इंटरफ़ेस होती हैं. इसलिए, जब आपके ऐप्लिकेशन में Play Core का इस्तेमाल किया जाता है, तो Play Store अपनी प्रोसेस चलाता है. इनमें, Google Play की सेवा की शर्तों के मुताबिक डेटा को मैनेज करना भी शामिल है. यहां दी गई जानकारी में बताया गया है कि आपके ऐप्लिकेशन के खास अनुरोधों को प्रोसेस करने के लिए, Play Core लाइब्रेरी डेटा को कैसे मैनेज करती हैं.

अन्य भाषाओं के एपीआई

Play Feature Delivery

हम ज़्यादा से ज़्यादा पारदर्शी होने की कोशिश करते हैं. हालांकि, ऐप्लिकेशन डेवलपर के तौर पर, यह तय करने की पूरी ज़िम्मेदारी आपकी है कि Google Play के डेटा सुरक्षा वाले सेक्शन के फ़ॉर्म में मांगी गई जानकारी कैसे देनी है. इस फ़ॉर्म में, ऐप्लिकेशन इस्तेमाल करने वाले लोगों का डेटा इकट्ठा करने, उसे शेयर करने, और उसकी सुरक्षा के तरीकों के बारे में जानकारी देनी होती है.