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

Google Play का ऐप्लिकेशन डिलीवरी मॉडल, हर उपयोगकर्ता के डिवाइस कॉन्फ़िगरेशन के लिए ऑप्टिमाइज़ किए गए APK जनरेट करने और उन्हें डिलीवर करने के लिए, 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 सॉफ़्टवेयर डेवलपमेंट किट की सेवा की शर्तों को स्वीकार कर लिया है. कृपया लाइब्रेरी को ऐक्सेस करने से पहले, इस पर लागू होने वाली सभी शर्तों और नीतियों को पढ़कर समझ लें.

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

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

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

Play Feature Delivery

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