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

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

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

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

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

डिफ़ॉल्ट रूप से, Android Studio आपके ऐप्लिकेशन को डिप्लॉय करने के लिए, ऐप्लिकेशन बंडल का इस्तेमाल नहीं करता. इसके बजाय, IDE आपके डिवाइस पर ऐसे APK बनाता है और उन्हें इंस्टॉल करता है जिन्हें डिप्लॉयमेंट की स्पीड के लिए ऑप्टिमाइज़ किया गया है. ये 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 Analyzer का इस्तेमाल किया जा सकता है. इससे, अपने फ़ीचर मॉड्यूल APK की जांच की जा सकती है और पैकेज का नाम पता लगाया जा सकता है:

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

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

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

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

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

अन्य संसाधन

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

ब्लॉग पोस्ट

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

वीडियो

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

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

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

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

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

ज़्यादा भाषाओं के एपीआई

Play Feature Delivery

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