ऐप्लिकेशन बंडल, APK से अलग होता है. इसे किसी डिवाइस पर डिप्लॉय नहीं किया जा सकता. इसके बजाय, यह एक पब्लिशिंग फ़ॉर्मैट है. इसमें आपके ऐप्लिकेशन के कंपाइल किए गए सभी कोड और संसाधन, एक ही बिल्ड आर्टफ़ैक्ट में शामिल होते हैं. इसलिए, साइन किया गया ऐप्लिकेशन बंडल अपलोड करने के बाद, Google Play के पास आपके ऐप्लिकेशन के APK बनाने, उन्हें साइन करने, और उपयोगकर्ताओं को उपलब्ध कराने के लिए ज़रूरी सभी चीज़ें होती हैं.
शुरू करें
ज़्यादातर ऐप्लिकेशन प्रोजेक्ट में, Android ऐप्लिकेशन बंडल के साथ काम करने के लिए ज़्यादा मेहनत नहीं करनी पड़ती.
ऐसा इसलिए है, क्योंकि आपके ऐप्लिकेशन के बेस APK के लिए कोड और संसाधनों वाला मॉड्यूल, स्टैंडर्ड ऐप्लिकेशन मॉड्यूल होता है. यह आपको डिफ़ॉल्ट रूप से तब मिलता है, जब Android Studio में कोई नया ऐप्लिकेशन प्रोजेक्ट बनाया जाता है. इसका मतलब है कि application प्लगिन को लागू करने वाला मॉड्यूल, अपनी build.gradle फ़ाइल को आपके ऐप्लिकेशन की बुनियादी सुविधाओं के लिए कोड और संसाधन उपलब्ध कराता है. इसके बारे में यहां दिए गए स्निपेट में बताया गया है.
Groovy
// The standard application plugin creates your app's base module. plugins { id 'com.android.application' }
Kotlin
plugins { // The standard application plugin creates your app's base module. id("com.android.application") }
बेस मॉड्यूल, आपके ऐप्लिकेशन के लिए मुख्य फ़ंक्शन उपलब्ध कराने के साथ-साथ, कई बिल्ड कॉन्फ़िगरेशन और मेनिफ़ेस्ट एंट्री भी उपलब्ध कराता है. इनसे आपके पूरे ऐप्लिकेशन प्रोजेक्ट पर असर पड़ता है.
बेस मॉड्यूल का बिल्ड कॉन्फ़िगरेशन
ज़्यादातर मौजूदा ऐप्लिकेशन प्रोजेक्ट के लिए, आपको अपने बेस मॉड्यूल के बिल्ड कॉन्फ़िगरेशन में कुछ भी बदलने की ज़रूरत नहीं है. हालांकि, अगर आपको अपने ऐप्लिकेशन प्रोजेक्ट में फ़ीचर मॉड्यूल जोड़ने हैं या आपने पहले कई APKs का इस्तेमाल करके अपना ऐप्लिकेशन रिलीज़ किया है, तो आपको बेस मॉड्यूल के बिल्ड कॉन्फ़िगरेशन के कुछ पहलुओं का ध्यान रखना चाहिए.
वर्शन कोड और ऐप्लिकेशन के अपडेट
Android ऐप्लिकेशन बंडल की मदद से, आपको Google Play पर अपलोड किए जाने वाले कई APKs के वर्शन कोड मैनेज करने की ज़रूरत नहीं पड़ती. इसके बजाय, आपको अपने ऐप्लिकेशन के बेस मॉड्यूल में सिर्फ़ एक वर्शन कोड मैनेज करना होगा, जैसा कि यहां दिखाया गया है:
// In your base module build.gradle file
android {
defaultConfig {
…
// You specify your app's version code only in the base module.
versionCode 5
versionName "1.0"
}
}
ऐप्लिकेशन बंडल अपलोड करने के बाद, Google Play आपके बेस मॉड्यूल में मौजूद वर्शन कोड का इस्तेमाल करता है. इससे, उस बंडल से जनरेट होने वाले सभी APK को एक ही वर्शन कोड असाइन किया जाता है. इसका मतलब है कि जब कोई डिवाइस आपके ऐप्लिकेशन को डाउनलोड और इंस्टॉल करता है, तो उस ऐप्लिकेशन के सभी split APKs का वर्शन कोड एक ही होता है.
जब आपको अपने ऐप्लिकेशन को नए कोड या संसाधनों के साथ अपडेट करना हो, तो आपको अपने ऐप्लिकेशन के बेस मॉड्यूल में वर्शन कोड को अपडेट करना होगा. साथ ही, एक नया और पूरा ऐप्लिकेशन बंडल बनाना होगा. जब उस ऐप्लिकेशन बंडल को Google Play पर अपलोड किया जाता है, तो वह बेस मॉड्यूल के वर्शन कोड के आधार पर APKs का एक नया सेट जनरेट करता है. इसके बाद, जब उपयोगकर्ता आपके ऐप्लिकेशन को अपडेट करते हैं, तो Google Play उन्हें डिवाइस पर इंस्टॉल किए गए सभी APKs के अपडेट किए गए वर्शन उपलब्ध कराता है. इसका मतलब है कि इंस्टॉल किए गए सभी APK, नए वर्शन कोड पर अपडेट हो जाते हैं.
ध्यान देने वाली अन्य बातें
- ऐप्लिकेशन साइनिंग: अगर आपको अपनी बिल्ड फ़ाइलों में साइनिंग की जानकारी शामिल करनी है, तो इसे सिर्फ़ बेस मॉड्यूल की बिल्ड कॉन्फ़िगरेशन फ़ाइल में शामिल करें. ज़्यादा जानकारी के लिए, अपने ऐप्लिकेशन पर हस्ताक्षर करने के लिए Gradle को कॉन्फ़िगर करना लेख पढ़ें.
- कोड छोटा करना: अगर आपको अपने पूरे ऐप्लिकेशन प्रोजेक्ट (इसमें फ़ीचर मॉड्यूल भी शामिल हैं) के लिए कोड छोटा करने की सुविधा चालू करनी है, तो आपको बेस मॉड्यूल की
build.gradleफ़ाइल से ऐसा करना होगा. इसका मतलब है कि किसी फ़ीचर मॉड्यूल में कस्टम ProGuard नियम शामिल किए जा सकते हैं. हालांकि, फ़ीचर मॉड्यूल के बिल्ड कॉन्फ़िगरेशन मेंminifyEnabledप्रॉपर्टी को अनदेखा कर दिया जाता है. splitsब्लॉक को अनदेखा किया जाता है: ऐप्लिकेशन बंडल बनाते समय, Gradleandroid.splitsब्लॉक में मौजूद प्रॉपर्टी को अनदेखा कर देता है. अगर आपको यह कंट्रोल करना है कि आपका ऐप्लिकेशन बंडल किस तरह के कॉन्फ़िगरेशन APK के साथ काम करे, तो इसके बजायandroid.bundleका इस्तेमाल करके, कॉन्फ़िगरेशन APK के टाइप बंद करें.- ऐप्लिकेशन का वर्शन तय करना: बेस मॉड्यूल, आपके पूरे ऐप्लिकेशन प्रोजेक्ट के लिए वर्शन कोड और वर्शन का नाम तय करता है. ज़्यादा जानकारी के लिए, वर्शन कोड और ऐप्लिकेशन के अपडेट देखें.
कॉन्फ़िगरेशन APK के टाइप को फिर से चालू या बंद करना
डिफ़ॉल्ट रूप से, ऐप्लिकेशन बंडल बनाने पर, यह भाषा के संसाधनों, स्क्रीन डेंसिटी के संसाधनों, और एबीआई लाइब्रेरी के हर सेट के लिए, कॉन्फ़िगरेशन APK जनरेट करने की सुविधा देता है. अपने बेस मॉड्यूल की build.gradle फ़ाइल में android.bundle ब्लॉक का इस्तेमाल करके, एक या उससे ज़्यादा तरह के कॉन्फ़िगरेशन APKs के लिए सहायता बंद की जा सकती है. इसके बारे में यहां बताया गया है:
Groovy
android { // When building Android App Bundles, the splits block is ignored. // You can remove it, unless you're going to continue to build multiple // APKs in parallel with the app bundle splits {...} // Instead, use the bundle block to control which types of configuration APKs // you want your app bundle to support. bundle { language { // This property is set to true by default. // You can specify `false` to turn off // generating configuration APKs for language resources. // These resources are instead packaged with each base and // feature APK. // Continue reading below to learn about situations when an app // might change setting to `false`, otherwise consider leaving // the default on for more optimized downloads. enableSplit = false } density { // This property is set to true by default. enableSplit = true } abi { // This property is set to true by default. enableSplit = true } } }
Kotlin
android { // When building Android App Bundles, the splits block is ignored. // You can remove it, unless you're going to continue to build multiple // APKs in parallel with the app bundle splits {...} // Instead, use the bundle block to control which types of configuration APKs // you want your app bundle to support. bundle { language { // This property is set to true by default. // You can specify `false` to turn off // generating configuration APKs for language resources. // These resources are instead packaged with each base and // feature APK. // Continue reading below to learn about situations when an app // might change setting to `false`, otherwise consider leaving // the default on for more optimized downloads. enableSplit = false } density { // This property is set to true by default. enableSplit = true } abi { // This property is set to true by default. enableSplit = true } } }
भाषा में हुए बदलावों को मैनेज करना
Google Play यह तय करता है कि ऐप्लिकेशन के साथ कौनसे भाषा संसाधन इंस्टॉल करने हैं. यह उपयोगकर्ता के डिवाइस की सेटिंग में चुनी गई भाषा के आधार पर तय होता है. मान लें कि कोई उपयोगकर्ता आपका ऐप्लिकेशन डाउनलोड करने के बाद, अपने डिवाइस की डिफ़ॉल्ट भाषा बदलता है. अगर आपका ऐप्लिकेशन उस भाषा के साथ काम करता है, तो डिवाइस Google Play से उस भाषा के संसाधनों के लिए, अतिरिक्त कॉन्फ़िगरेशन APK का अनुरोध करता है और उन्हें डाउनलोड करता है.
कुछ ऐप्लिकेशन में, भाषा चुनने की सुविधा मौजूद होती है. साथ ही, सिस्टम लेवल पर भाषा की सेटिंग के बजाय, ऐप्लिकेशन की भाषा को डाइनैमिक तौर पर बदला जा सकता है. ऐसे ऐप्लिकेशन के लिए, आपको कुछ बदलाव करने होंगे, ताकि ज़रूरी संसाधन न होने की वजह से ऐप्लिकेशन क्रैश न हो. android.bundle.language.enableSplit प्रॉपर्टी को false पर सेट करें या Play Core लाइब्रेरी का इस्तेमाल करके, मांग पर भाषा डाउनलोड करने की सुविधा लागू करें. इसके बारे में भाषा के अन्य संसाधन डाउनलोड करें में बताया गया है.