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

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

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 आपका फ़ीचर मॉड्यूल बनाता है, तो वह दिखता है बेस मॉड्यूल में android.dynamicFeatures प्रॉपर्टी जोड़कर बेस मॉड्यूल की build.gradle फ़ाइल, जैसा कि नीचे दिखाया गया है:

// 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 प्रॉपर्टी देखें, जैसा कि नीचे दिखाया गया है.

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 पर क्लिक करके इसमें टूलबार).

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

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

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

दूसरा डायग्राम. कंपाइल की गई रिसॉर्स फ़ाइल में पैकेज के नाम की जांच करने के लिए, APK ऐनालाइज़र का इस्तेमाल करें.

सुविधा वाले मॉड्यूल इस्तेमाल करते समय इन बातों का ध्यान रखें

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

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

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

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

अन्य संसाधन

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

ब्लॉग पोस्ट

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

वीडियो

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

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

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

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

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

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

Play Feature Delivery

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