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

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

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 के ये नियम, बिल्ड के समय अन्य मॉड्यूल (इनमें बेस मॉड्यूल भी शामिल है) के नियमों के साथ मर्ज हो जाते हैं. इसलिए, भले ही हर फ़ीचर मॉड्यूल के लिए नियमों का एक नया सेट तय किया जा सकता है, लेकिन वे नियम ऐप्लिकेशन प्रोजेक्ट के सभी मॉड्यूल पर लागू होते हैं.

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

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

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

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

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

कस्टम डिलीवरी के लिए फ़ीचर मॉड्यूल इस्तेमाल करना

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

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

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

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

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

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

अगर आपको यूआरआई का इस्तेमाल करके, फ़ीचर मॉड्यूल में सेव किए गए किसी संसाधन को ऐक्सेस करना है, तो 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();

संसाधन के पाथ का हर हिस्सा रन टाइम के दौरान बनाया जाता है. इससे यह पक्का होता है कि split 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 का इस्तेमाल करके नया फ़ीचर मॉड्यूल बनाते समय, आईडीई में ज़्यादातर मेनिफ़ेस्ट एट्रिब्यूट शामिल होते हैं. ये एट्रिब्यूट, मॉड्यूल को फ़ीचर मॉड्यूल की तरह काम करने के लिए ज़रूरी होते हैं. इसके अलावा, कंपाइल के समय बिल्ड सिस्टम कुछ एट्रिब्यूट इंजेक्ट करता है. इसलिए, आपको उन्हें खुद तय करने या उनमें बदलाव करने की ज़रूरत नहीं है. यहां दी गई टेबल में, मेनिफ़ेस्ट के उन एट्रिब्यूट के बारे में बताया गया है जो फ़ीचर मॉड्यूल के लिए ज़रूरी हैं.

अन्य संसाधन

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

ब्लॉग पोस्ट

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

वीडियो

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

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

Play Feature Delivery लाइब्रेरी को ऐक्सेस या इस्तेमाल करने का मतलब है कि आपको Play Core सॉफ़्टवेयर डेवलपमेंट किट की सेवा की शर्तें मंज़ूर हैं. लाइब्रेरी को ऐक्सेस करने से पहले, कृपया लागू होने वाली सभी शर्तों और नीतियों को पढ़ें और समझें.

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

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

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

Play Feature Delivery

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