बंडलटूल

bundletool एक ऐसा टूल है जो Android Studio, Android Gradle है प्लगिन और Google Play का इस्तेमाल करके Android ऐप्लिकेशन बंडल बनाया जाता है. bundletool अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है किसी ऐप्लिकेशन बंडल को डिवाइसों पर डिप्लॉय किए गए अलग-अलग APK में बदल सकता है.

Android SDK बंडल (ASB) और उनके APK, bundletool की मदद से बनाए गए हैं. हां कमांड-लाइन टूल के तौर पर भी उपलब्ध है, ताकि आप ऐप्लिकेशन बंडल बना सकें और SDK टूल खुद को बंडल करते हैं और अपने ऐप्लिकेशन के Google Play के सर्वर-साइड बिल्ड को फिर से बनाते हैं APK या आपके रनटाइम की सुविधा वाले SDK टूल के APKs.

bundletool भाषा डाउनलोड करें

अगर आपने पहले से ऐसा नहीं किया है, तो यहां से bundletool को डाउनलोड करें: GitHub का डेटा स्टोर करने की जगह.

ऐप्लिकेशन बंडल बनाना और उसकी जांच करना

अपने ऐप्लिकेशन को बनाने के लिए, Android Studio या bundletool कमांड-लाइन टूल का इस्तेमाल किया जा सकता है Android ऐप्लिकेशन बंडल चुनें और फिर इस ऐप्लिकेशन बंडल से APK जनरेट करने की जांच करें.

ऐप्लिकेशन बंडल बनाना

Android Studio और 'Android Gradle प्लग इन' का इस्तेमाल करके Android ऐप्लिकेशन बंडल बनाएं और उस पर हस्ताक्षर करें. हालांकि, अगर IDE का इस्तेमाल करना एक विकल्प नहीं है—उदाहरण के लिए, क्योंकि आप लगातार चलने वाला सर्वर है, तो आपको अपने संगठन के कमांड लाइन से अपना ऐप्लिकेशन बंडल बनाना और इसका इस्तेमाल करके हस्ताक्षर करें jarsigner.

ध्यान दें: अपने ऐप्लिकेशन बंडल पर हस्ताक्षर करने के लिए, apksigner का इस्तेमाल नहीं किया जा सकता.

bundletool के साथ ऐप्लिकेशन बंडल बनाने के बारे में ज़्यादा जानकारी के लिए, देखें बंडलटूल का इस्तेमाल करके ऐप्लिकेशन बंडल बनाएं.

अपने ऐप्लिकेशन बंडल से APKs का सेट जनरेट करें

Android ऐप्लिकेशन बंडल बनाने के बाद, देखें कि Google Play किस तरह से काम करता है इसका इस्तेमाल APK जनरेट करने के लिए करता है. साथ ही, यह भी बताता है कि डिवाइस पर डिप्लॉय किए जाने पर ये APK कैसे काम करते हैं.

अपने ऐप्लिकेशन बंडल की जांच करने के दो तरीके हैं:

• bundletool कमांड-लाइन टूल का इस्तेमाल स्थानीय तौर पर करें.
• Play Console पर अपना बंडल अपलोड करना Google Play पर उपलब्ध है.

इस सेक्शन में बताया गया है कि ऐप्लिकेशन बंडल को स्थानीय तौर पर टेस्ट करने के लिए, bundletool का इस्तेमाल कैसे किया जा सकता है.

जब bundletool आपके ऐप्लिकेशन बंडल से APKs जनरेट करता है, तो उसमें जनरेट किए गए APK भी शामिल होते हैं ऐसे कंटेनर में APK जिसे APK सेट संग्रह कहते हैं, जिसमें .apks फ़ाइल का इस्तेमाल किया जाता है एक्सटेंशन चुनें. आपका ऐप्लिकेशन सभी डिवाइस कॉन्फ़िगरेशन के लिए सेट किया गया APK जनरेट करने के लिए को डाउनलोड करने की सुविधा देता है, तो bundletool build-apks निर्देश का इस्तेमाल इस तरह करें दिखाया गया:

bundletool build-apks --bundle=/MyApp/my_app.aab --output=/MyApp/my_app.apks

अगर आप किसी डिवाइस पर APK डिप्लॉय करना चाहते हैं, तो आपको अपने ऐप्लिकेशन के जैसा कि नीचे दिए गए कमांड में दिखाया गया है. अगर आप तय नहीं करते हैं, तो साइनिंग जानकारी, bundletool आपके APK को डीबग कुंजी से साइन करने की कोशिश करता है आपके लिए.

bundletool build-apks --bundle=/MyApp/my_app.aab --output=/MyApp/my_app.apks
--ks=/MyApp/keystore.jks
--ks-pass=file:/MyApp/keystore.pwd
--ks-key-alias=MyKeyAlias
--key-pass=file:/MyApp/key.pwd

नीचे दी गई टेबल में उन अलग-अलग फ़्लैग और विकल्पों के बारे में बताया गया है जिन्हें कब सेट किया जा सकता है bundletool build-apks कमांड का इस्तेमाल करके ज़्यादा जानकारी पाएं:

टेबल 1. bundletool build-apks निर्देश

चिह्नित करें	ब्यौरा
--bundle=path	(ज़रूरी है) ऐप्लिकेशन बंडल का पाथ बताता है जिसे Android Studio का इस्तेमाल करके बनाया है. इस बारे में ज़्यादा जानने के लिए, पढ़ें अपना प्रोजेक्ट बनाएं.
--output=path	(ज़रूरी है) आउटपुट का नाम बताता है .apks फ़ाइल मिलेगी, जिसमें आपके ऐप्लिकेशन के सभी APK आर्टफ़ैक्ट शामिल हैं है. इस फ़ाइल में मौजूद आर्टफ़ैक्ट को किसी डिवाइस पर टेस्ट करने के लिए, इसमें दिया गया तरीका अपनाएं APK डिप्लॉय करने के तरीके से जुड़ा सेक्शन कनेक्ट किए गए डिवाइस पर.
--overwrite	यह किसी भी मौजूदा आउटपुट फ़ाइल को इससे ओवरराइट कर देता है ऐसा पाथ जिसे आपने --output विकल्प का इस्तेमाल करके तय किया है. अगर आपको इस फ़्लैग को शामिल न करें और आउटपुट फ़ाइल पहले से मौजूद है, तो आपको बिल्ड में गड़बड़ी हुई.
--aapt2=path	AAPT2 के लिए पसंद के मुताबिक पाथ बताता है. डिफ़ॉल्ट रूप से, bundletool में AAPT2 का अपना वर्शन शामिल है.
--ks=path	(ज़रूरी नहीं) डिप्लॉयमेंट कीस्टोर का पाथ बताता है, ताकि APK साइन करना चाहते हैं. अगर इस फ़्लैग को शामिल नहीं किया जाता है, bundletool, डीबग साइनिंग की मदद से आपके APK को साइन करने की कोशिश करता है बटन दबाएं.
--ks-pass=pass:password या --ks-pass=file:/path/to/file	यह आपके कीस्टोर पासवर्ड के बारे में बताता है. अगर आपको पासवर्ड को सादे टेक्स्ट में लिखें और pass: से पासवर्ड क्वालीफ़ाई करें. अगर आपने किसी ऐसी फ़ाइल का पाथ पास किया है जिसमें पासवर्ड है, तो file: के साथ. अगर आपको किसी --ks-pass तय किए बिना --ks फ़्लैग, bundletool आपको कमांड लाइन से पासवर्ड डालने के लिए कहता है.
--ks-key-alias=alias	आपको जिस साइनिंग पासकोड से साइन इन करना है उसका उपनाम बताता है इस्तेमाल करें.
--key-pass=pass:password या --key-pass=file:/path/to/file	यह साइनिंग पासकोड के लिए पासवर्ड बताता है. अगर आपको पासवर्ड को सादे टेक्स्ट में लिखें और pass: से पासवर्ड क्वालीफ़ाई करें. अगर आप किसी ऐसी फ़ाइल का पाथ पास करते हैं जिसमें पासवर्ड है, तो file: के साथ. अगर यह पासवर्ड, के लिए, आप इस फ़्लैग को छोड़ सकते हैं.
--connected-device	यह bundletool को ऐसे APK बनाने का निर्देश देता है जो कनेक्ट किए गए डिवाइस का कॉन्फ़िगरेशन. अगर इस फ़्लैग को शामिल नहीं किया जाता है, bundletool, आपके सभी डिवाइस कॉन्फ़िगरेशन के लिए APKs जनरेट करता है काम करता है.
--device-id=serial-number	अगर आपके पास एक से ज़्यादा कनेक्ट किए गए डिवाइस हैं, तो उस डिवाइस का सीरियल आईडी डालें जिस पर आपको अपना ऐप्लिकेशन डिप्लॉय करना है.
--device-spec=spec_json	आपकी जानकारी के लिए .json फ़ाइल, जो आपके पसंदीदा डिवाइस कॉन्फ़िगरेशन के बारे में बताती है टारगेट करने के लिए. ज़्यादा जानने के लिए, डिवाइस के हिसाब से JSON फ़ॉर्मैट जनरेट और इस्तेमाल करना फ़ाइलें में सेव किया जाता है.
--mode=universal	मोड को universal पर सेट करता है. अगर आप चाहें, तो इस विकल्प का इस्तेमाल करें bundletool ऐसा सिंगल APK बनाने के लिए करें जिसमें ये सभी चीज़ें शामिल हों आपके ऐप्लिकेशन के कोड और संसाधनों को ऐक्सेस कर सके, ताकि APK सभी ऐसे डिवाइस कॉन्फ़िगरेशन जो आपके ऐप्लिकेशन पर काम करते हों. ध्यान दें: bundletool में सिर्फ़ सुविधाओं वाले मॉड्यूल शामिल हैं जो इसमें <dist:fusing dist:include="true"/> को बताता है का मेनिफ़ेस्ट एक ही दुनिया में उपलब्ध है. ज़्यादा जानने के लिए, फ़ीचर मॉड्यूल मेनिफ़ेस्ट. ध्यान रखें कि ये APK, ऑप्टिमाइज़ किए गए APK से बड़े हैं ख़ास डिवाइस कॉन्फ़िगरेशन के लिए. हालांकि, वे आसानी से इंटरनल टेस्टर के साथ शेयर कर सकते हैं, जैसे कि कई डिवाइस कॉन्फ़िगरेशन पर आपके ऐप्लिकेशन की जांच करना चाहते हैं.
--local-testing	इससे आपके ऐप्लिकेशन बंडल को स्थानीय जांच के लिए चालू किया जाता है. लोकल टेस्टिंग की मदद से, बिना किसी ज़रूरत के तुरंत और बार-बार टेस्ट किया जा सकता है Google Play सर्वर पर अपलोड करने के लिए. यहां दिए गए उदाहरण का इस्तेमाल करके, मॉड्यूल इंस्टॉलेशन की जांच करने का तरीका जानें. --local-testing फ़्लैग, देखें स्थानीय तौर पर टेस्ट मॉड्यूल इंस्टॉल.

कनेक्ट किए गए डिवाइस पर APKs डिप्लॉय करना

APK का सेट जनरेट करने के बाद, bundletool जिसमें से APK के उन वर्शन को मिलाकर बनाया गया है जो कनेक्ट किए गए डिवाइस पर सेट हैं.

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

अपने ऐप्लिकेशन को APK सेट से डिप्लॉय करने के लिए, install-apks निर्देश का इस्तेमाल करें और तय करें कि का उपयोग करके सेट किए गए APK का पाथ --apks=/path/to/apks फ़्लैग, इसके तौर पर जो नीचे दिए गए निर्देश में दिखाए गए हैं. अगर आपने कई डिवाइस कनेक्ट किए हुए हैं, इसे जोड़कर लक्षित डिवाइस तय करें --device-id=serial-id फ़्लैग.

bundletool install-apks --apks=/MyApp/my_app.apks

ध्यान दें: अगर build-apks कमांड के साथ --local-testing फ़्लैग का इस्तेमाल किया जा रहा है, अपने APK इंस्टॉल करने के लिए install-apks का इस्तेमाल करें, ताकि यह पक्का किया जा सके कि लोकल टेस्टिंग ठीक से काम कर रही है या नहीं.

डिवाइस के हिसाब से, APK का सेट जनरेट करना

अगर आपको अपने ऐप्लिकेशन के सभी डिवाइस कॉन्फ़िगरेशन के लिए APKs का सेट नहीं बनाना है, तो का इस्तेमाल करता है, तो आप ऐसे APK बना सकते हैं जो सिर्फ़ कनेक्ट किए गए कॉन्फ़िगरेशन को टारगेट करते हैं डिवाइस का --connected-device विकल्प उपयोग कर रहा है, जैसा कि नीचे दिए गए आदेश में दिखाया गया है. अगर आपने कई डिवाइस कनेक्ट किए हुए हैं, तो --device-id=serial-id फ़्लैग.

bundletool build-apks --connected-device
--bundle=/MyApp/my_app.aab --output=/MyApp/my_app.apks

डिवाइस के हिसाब से JSON फ़ाइलें जनरेट करना और उनका इस्तेमाल करना

bundletool, किसी डिवाइस को टारगेट करने वाला APK सेट जनरेट कर सकता है JSON फ़ाइल में सेट किया गया कॉन्फ़िगरेशन. सबसे पहले कनेक्ट किए गए डिवाइस के लिए, नीचे दिया गया निर्देश चलाएं:

bundletool get-device-spec --output=/tmp/device-spec.json

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

bundletool build-apks --device-spec=/MyApp/pixel2.json
--bundle=/MyApp/my_app.aab --output=/MyApp/my_app.apks

मैन्युअल तरीके से डिवाइस की खास बातें JSON बनाएं

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

{
  "supportedAbis": ["arm64-v8a", "armeabi-v7a"],
  "supportedLocales": ["en", "fr"],
  "screenDensity": 640,
  "sdkVersion": 27
}

इसके बाद, इस JSON को bundle extract-apks कमांड को पास किया जा सकता है. इसका तरीका बताया गया है पर क्लिक करें.

किसी मौजूदा APK सेट से, डिवाइस के हिसाब से बनाए गए APK एक्सट्रैक्ट करना

अगर आपके पास कोई मौजूदा APK सेट है और आप उससे APK का सबसेट निकालना चाहते हैं, तो जो खास डिवाइस कॉन्फ़िगरेशन को टारगेट करते हैं, तो आप extract-apks का इस्तेमाल कर सकते हैं निर्देश दें और डिवाइस स्पेसिफ़िकेशन JSON को इस तरह से बताएँ:

bundletool extract-apks
--apks=/MyApp/my_existing_APK_set.apks
--output-dir=/MyApp/my_pixel2_APK_set.apks
--device-spec=/MyApp/bundletool/pixel2.json

किसी APK सेट में मौजूद APKs के अनुमानित डाउनलोड साइज़ का आकलन करना

किसी APK में APK के डाउनलोड साइज़ का अनुमानित साइज़ मापने के लिए, जैसे कि वे तार की मदद से कंप्रेस किया गया हो, इसके लिए get-size total निर्देश का इस्तेमाल करें:

bundletool get-size total --apks=/MyApp/my_app.apks

get-size total कमांड के व्यवहार में बदलाव करने के लिए, ये फ़्लैग मिल जाएंगे:

दूसरी टेबल. get-size total निर्देश

चिह्नित करें	ब्यौरा
--apks=path	(ज़रूरी है) मौजूदा APK सेट फ़ाइल का पाथ बताता है जिसका डाउनलोड साइज़ मापा जा रहा है.
--device-spec=path	डिवाइस की खास जानकारी वाली फ़ाइल का पाथ बताता है (इससे get-device-spec या मैन्युअल तरीके से बनाया गया हो). कॉन्फ़िगरेशन के सेट का आकलन करने के लिए, पार्शियल पाथ तय किया जा सकता है.
--dimensions=dimensions	साइज़ के अनुमान का हिसाब लगाते समय इस्तेमाल किए गए डाइमेंशन की जानकारी देता है. स्वीकार की जाती हैं कॉमा लगाकर अलग की गई सूची: SDK, ABI, SCREEN_DENSITY और LANGUAGE. इनकी मदद से, सभी डाइमेंशन में, ALL तय करें.
--instant	यह तुरंत चालू होने वाले APK के डाउनलोड साइज़ का आकलन करता है, ऐसे APK जिन्हें इंस्टॉल किया जा सकता है. डिफ़ॉल्ट रूप से bundletool, इंस्टॉल किए जा सकने वाले APK का डाउनलोड साइज़.
--modules=modules	APK में विचार करने के लिए सेट किए गए मॉड्यूल की ऐसी सूची तय करता है जिसे कॉमा लगाकर अलग किया गया है को भी मापा जा सकता है. bundletool निर्देश अपने-आप चला जाता है इसमें किसी सेट के लिए सभी डिपेंडेंट मॉड्यूल शामिल हैं. डिफ़ॉल्ट रूप से, कमांड, इस दौरान इंस्टॉल किए गए सभी मॉड्यूल के डाउनलोड साइज़ को मापता है पहला डाउनलोड.

SDK टूल बंडल डिपेंडेंसी के साथ ऐप्लिकेशन बंडल बनाना (एक्सपेरिमेंट के तौर पर उपलब्ध)

Android SDK बंडल (ASB) डिपेंडेंसी के साथ Android ऐप्लिकेशन बंडल बनाया जा सकता है कमांड लाइन से साइन किया जा सकता है और उसका इस्तेमाल करके Jarsigner.

ध्यान दें: आप apksigner का इस्तेमाल करके, अपने Android ऐप्लिकेशन बंडल को ASB डिपेंडेंसी.

हर ऐप्लिकेशन बंडल मॉड्यूल में, एक मॉड्यूल प्रोटोकॉल बफ़र (.pb) फ़ाइल शामिल होती है: runtime_enabled_sdk_config.pb. इस फ़ाइल में SDK टूल की सूची शामिल है जिस पर ऐप्लिकेशन बंडल मॉड्यूल निर्भर करता है. इस फ़ाइल की पूरी जानकारी के लिए, देखें runtime_enabled_sdk_config.proto फ़ाइल.

SDK टूल बंडल डिपेंडेंसी के साथ ऐप्लिकेशन बंडल बनाने के लिए, इस बारे में सेक्शन में दिया गया तरीका अपनाएं बंडलटूल का इस्तेमाल करके ऐप्लिकेशन बंडल बनाना और runtime_enabled_sdk_config.pb फ़ाइल को हर ऐप्लिकेशन मॉड्यूल के ज़िप में फ़ाइल में कोड और संसाधन शामिल हैं.

runtime_enabled_sdk_config.pb फ़ाइल में मौजूद कुछ अहम फ़ील्ड:

• सर्टिफ़िकेट का ब्यौरा: कुंजी के लिए सर्टिफ़िकेट का SHA-256 डाइजेस्ट का इस्तेमाल, SDK टूल के APK को साइन करने के लिए किया जाता है. यह SdkMetadata.pb फ़ाइल, Android SDK आर्काइव फ़ॉर्मैट में.

• संसाधन पैकेज आईडी: वह पैकेज आईडी जो इस SDK टूल में मौजूद सभी संसाधन है SDK टूल को ऐप्लिकेशन में एम्बेड करने के लिए, APKs जनरेट करते समय, उन्हें फिर से मैप किया जाता है. इससे, पुराने सिस्टम के साथ काम करने की सुविधा चालू हो जाती है.

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

SDK टूल बंडल डिपेंडेंसी वाले ऐप्लिकेशन बंडल से APK जनरेट करें (एक्सपेरिमेंट के तौर पर उपलब्ध)

अपने ऐप्लिकेशन बंडल से APK जनरेट करने के लिए, इसके बारे में सेक्शन में दिए गए चरणों को अपनाएं अपने ऐप्लिकेशन बंडल से APKs का सेट जनरेट करना या के बारे में डिवाइस के हिसाब से APK का सेट जनरेट करना और इन SDK टूल के साथ bundletool build-apks कमांड उपलब्ध कराएं निर्भर करता है. ये SDK टूल, SDK टूल बंडल फ़ॉर्मैट या SDK टूल में उपलब्ध कराए जा सकते हैं संग्रह का फ़ॉर्मैट.

आपके पास SDK टूल को SDK बंडल के तौर पर उपलब्ध कराने का विकल्प होता है. ऐसा करने के लिए, --sdk-bundles फ़्लैग जोड़ें: अनुसरण करता है:

bundletool build-apks --bundle=app.aab --sdk-bundles=sdk1.asb,sdk2.asb \
    --output=app.apks

--sdk-archives फ़्लैग जोड़कर, SDK टूल के संग्रह के तौर पर SDK टूल उपलब्ध कराए जा सकते हैं. इस तरह से:

bundletool build-apks --bundle=app.aab --sdk-archives=sdk1.asar,sdk2.asar \
    --output=app.apks

जिन डिवाइसों में SDK टूल की लाइब्रेरी की सुविधा नहीं है उनके लिए, SDK टूल बंडल डिपेंडेंसी वाले ऐप्लिकेशन बंडल से APK जनरेट करें

Android 13 से पहले के वर्शन वाले डिवाइसों पर, SDK टूल की लाइब्रेरी इंस्टॉल करने या उन्हें चलाने की सुविधा काम नहीं करती का इस्तेमाल किया जा सकता है. बंडलटूल, पुराने सिस्टम के साथ काम करने की क्षमता को छिपा देता है और जब आप एक ही ऐप्लिकेशन बंडल से आपके APK सेट के कई वैरिएंट जनरेट करते हैं --sdk-bundles या --sdk-archives विकल्प के साथ bundletool build-apks को चलाएं. अलग-अलग वैरिएंट, अलग-अलग सुविधाओं वाले डिवाइसों को टारगेट करते हैं:

• नए डिवाइसों के लिए एक वैरिएंट उपलब्ध है, जिसमें SDK टूल को एक अलग वैरिएंट के तौर पर इंस्टॉल किया गया है ऐप्लिकेशन के पैकेज और ऐप्लिकेशन के APK में, SDK टूल से जुड़ा कोई कॉन्टेंट शामिल नहीं होता.
• पुराने डिवाइसों के लिए, एक या उससे ज़्यादा वैरिएंट उपलब्ध हैं, जिनमें SDK टूल के APKs जोड़े गए हैं स्प्लिट किए गए ऐप्लिकेशन APK के लिए भी ऐसा किया जा सकता है. SDK टूल के APK, ऐप्लिकेशन से जुड़े हैं पैकेज. इस मामले में, SDK टूल का रनटाइम, इस डिवाइस.

बिना SDK टूल की डिपेंडेंसी के ऐप्लिकेशन बंडल के लिए APK जनरेट करने के तरीके की तरह ही, bundletool extract-apks और bundletool install-apks, फ़िल्टर किया गया सेट दिखाते हैं कनेक्ट किए गए डिवाइस या उपलब्ध कराए गए डिवाइस के सबसे अच्छे वैरिएंट के APKs कॉन्फ़िगरेशन.

बेहतर इस्तेमाल के मामलों के लिए, जहां आपकी दिलचस्पी सिर्फ़ APK स्प्लिट जनरेट करने में है को इस्तेमाल करने के लिए, SDK टूल के संग्रह से, bundletool build-sdk-apks-for-app निर्देश इस तरह है:

bundletool build-sdk-apks-for-app --app-properties=app-properties.json \
    --sdk-archive=sdk.asar --output=sdk.apks

app-properties फ़ाइल में वे फ़ील्ड होने चाहिए जिनके बारे में इसमें बताया गया है runtime_enabled_sdk_config.proto फ़ाइल. app-properties फ़ाइल इस तरह दिखती है:

{
  "package_name": "com.my.app",
  "version_code": 1234,
  "min_sdk_version": 21,
  "resources_package_id": 0x7e
}

bundletool build-sdk-apks-for-app निर्देश ऐप्लिकेशन का सबसेट जनरेट करता है ऐसे APK जो ऐप्लिकेशन के पैकेज के नाम में SDK टूल के कॉन्टेंट से मिलते-जुलते हैं. आप इन APK को ऐसे अन्य APK के साथ मिलाना होगा जिनमें ऐप्लिकेशन का कॉन्टेंट शामिल है. उदाहरण के लिए, अगर आपको उन्हें अलग-अलग और बढ़ाना होगा. साथ ही, डिवाइस पर एक साथ इंस्टॉल करना होगा जो SDK टूल के रनटाइम के साथ काम नहीं करता है.

SDK टूल का बंडल बनाना और उसकी जांच करना (एक्सपेरिमेंट के तौर पर उपलब्ध है)

bundletool का इस्तेमाल करके, ASB बनाया जा सकता है. साथ ही, फ़ाइलें इंस्टॉल और उपलब्ध कराने के लिए ज़रूरी हैं.

SDK टूल का बंडल बनाएं

कमांड लाइन से ASB बनाया जा सकता है और उस पर हस्ताक्षर किया जा सकता है इसका उपयोग कर रहा है Jarsigner.

ध्यान दें: अपने SDK टूल के बंडल पर साइन करने के लिए, apksigner का इस्तेमाल नहीं किया जा सकता.

SDK टूल का बंडल बनाने के लिए, यह तरीका अपनाएं:

1. प्रोटो फ़ॉर्मैट में, SDK टूल के बंडल का मेनिफ़ेस्ट और संसाधनों को जनरेट करना इसके लिए, वही तरीका अपनाएं जो ऐप्लिकेशन बंडल के लिए इस्तेमाल किया जाता है.

2. अपने SDK टूल के कंपाइल किए गए कोड और संसाधनों को एक बेस ज़िप फ़ाइल में पैकेज के तौर पर इकट्ठा करना, जैसा आप किसी ऐप मॉड्यूल में करेंगे.

3. SdkModulesConfig.pb.json फ़ाइल और SdkBundleConfig.pb.json जनरेट करें फ़ाइल, जो Android SDK बंडल की खास बातें.

4. bundletool build-sdk-bundle निर्देश का इस्तेमाल करके अपना ASB बनाएं: अनुसरण करता है:

bundletool build-sdk-bundle --sdk-bundle-config=SdkBundleConfig.pb.json \
    --sdk-modules-config=SdkModulesConfig.pb.json \
    --modules=base.zip --output=sdk.asb

नीचे दी गई टेबल में उन अलग-अलग फ़्लैग और विकल्पों के बारे में बताया गया है जिन्हें कब सेट किया जा सकता है bundletool build-sdk-bundle कमांड का इस्तेमाल करके, ज़्यादा जानकारी पाएं.

तीसरी टेबल. bundletool build-sdk-bundle निर्देश

चिह्नित करें	ब्यौरा
--modules	(ज़रूरी है) वह मॉड्यूल फ़ाइल जिसे फ़ाइनल बनाना है ASB की ओर से.
--output	(ज़रूरी है) वह पाथ जहां आपको ASB बनाना है.
--sdk-modules-config	(ज़रूरी है) कॉन्फ़िगरेशन के बारे में बताने वाली JSON फ़ाइल का पाथ के सभी मॉड्यूल देखे जा सकते हैं. JSON फ़ाइल को फ़ॉर्मैट करने का तरीका जानने के लिए, यहां जाएं: Android SDK बंडल की खास बातें सेक्शन.
--sdk-bundle-config	JSON फ़ाइल का पाथ, जो कॉन्फ़िगरेशन के बारे में बताता है के तौर पर उपलब्ध है. JSON फ़ाइल को फ़ॉर्मैट करने का तरीका जानने के लिए, यहां जाएं: Android SDK बंडल की खास बातें सेक्शन.
--metadata-file	ASB के लिए मेटाडेटा शामिल करने वाली फ़ाइल. फ़्लैग मान का फ़ॉर्मैट यह है <bundle-path>:<physical-file>, जहां <bundle-path> फ़ाइल की जगह को दिखाता है SDK टूल बंडल की मेटाडेटा डायरेक्ट्री और <physical-file> कोई मौजूदा फ़ाइल, जिसमें स्टोर किया जाने वाला रॉ डेटा होता है. फ़्लैग ये हो सकता है: दोहराया गया.
--overwrite	अगर यह नीति सेट की जाती है, तो यह पिछले मौजूदा आउटपुट की जगह लागू हो जाती है.

SDK टूल के बंडल से APK जनरेट करें

ASB बनाने के बाद, SDK टूल के बंडल को स्थानीय तौर पर टेस्ट किया जा सकता है. इसके लिए: bundletool build-sdk-apks निर्देश का इस्तेमाल करके, अपने APK जनरेट करना, जैसा कि यहां दिखाया गया है यह कोड डालें:

bundletool build-sdk-apks --sdk-bundle=sdk.asb --output=sdk.apks

जब bundletool आपके SDK टूल बंडल से APK जनरेट करता है, तो इस टूल में APK सेट संग्रह नाम के कंटेनर में मौजूद APK, जिसमें .apks फ़ाइल का इस्तेमाल किया जाता है एक्सटेंशन चुनें. bundletool, SDK टूल के बंडल से एक स्टैंडअलोन APK जनरेट करता है सभी डिवाइस कॉन्फ़िगरेशन को टारगेट करती है.

अगर आपको किसी डिवाइस पर ASB को डिप्लॉय करना है, तो आपको अपने ऐप्लिकेशन की साइनिंग जानकारी, जैसा कि यहां दिए गए कमांड में दिखाया गया है:

bundletool build-sdk-apks --sdk-bundle=sdk.asb --output=sdk.apks \
    --ks=keystore.jks \
    --ks-pass=file:/keystore.pwd \
    --ks-key-alias=KeyAlias \
    --key-pass=file:/key.pwd

ध्यान दें: अगर आपने साइनिंग की जानकारी नहीं दी है, तो bundletool, साइन करने की कोशिश करता है आपके लिए डीबग कुंजी वाले APK.

नीचे दी गई टेबल में उन अलग-अलग फ़्लैग और विकल्पों के बारे में बताया गया है जिन्हें कब सेट किया जा सकता है bundletool build-sdk-apks कमांड का इस्तेमाल करके, ज़्यादा जानकारी पाएं.

टेबल 4. bundletool build-sdk-apks निर्देश

चिह्नित करें	ब्यौरा
--sdk-bundle	(ज़रूरी है) SDK टूल के बंडल का पाथ. एक्सटेंशन होना ज़रूरी है .asb.
--output	(ज़रूरी है) डिफ़ॉल्ट रूप से, वह पाथ जहां आप APK सेट संग्रह चाहते हैं बनाया जाना चाहिए. वैकल्पिक रूप से, अगर आपको --output-format=DIRECTORY, यह उस डायरेक्ट्री का पाथ है जहां आपको जनरेट किए गए APKs सेव करने हैं.
--ks	कीस्टोर का वह पाथ जिसका इस्तेमाल आपको जनरेट किए गए APK हैं.
--ks-key-alias	हस्ताक्षर करने के लिए कीस्टोर में इस्तेमाल करने के लिए कुंजी का उपनाम जनरेट किए गए APK हैं.
--key-pass	कीस्टोर में मौजूद कुंजी का पासवर्ड, जिसका इस्तेमाल जनरेट किए गए पासकोड को साइन करने के लिए किया जा सकता है APK. अगर पासवर्ड को साफ़ टेक्स्ट में पास किया जाता है, तो आपको वैल्यू से पहले पुष्टि करनी होगी pass: के साथ. उदाहरण के लिए, pass:qwerty. अगर पासवर्ड किसी फ़ाइल की पहली लाइन है, तो आपको यूआरएल से पहले वैल्यू जोड़नी होगी file: के साथ. उदाहरण के लिए, file:/tmp/myPassword.txt. अगर यह फ़्लैग सेट नहीं है, तो कीस्टोर पासवर्ड की कोशिश की गई है. अगर ऐसा नहीं होता है, तो कमांड-लाइन टर्मिनल आपको डालें.
--ks-pass	कीस्टोर का पासवर्ड, जिसका इस्तेमाल जनरेट किए गए APK पर साइन करने के लिए किया जाना है. अगर पासवर्ड को साफ़ टेक्स्ट में पास किया जाता है, तो आपको वैल्यू से पहले पुष्टि करनी होगी pass: के साथ. उदाहरण के लिए, pass:qwerty. अगर पासवर्ड फ़ाइल की पहली पंक्ति है, तो आपको किसी फ़ाइल के file:. उदाहरण के लिए file:/tmp/myPassword.txt. अगर यह फ़्लैग सेट नहीं है, तो कमांड-लाइन टर्मिनल, आपसे पासवर्ड डालने का प्रॉम्प्ट करता है.
--aapt2	इस्तेमाल करने के लिए, AAPT2 बाइनरी का पाथ.
--output-format	जनरेट किए गए APKs के लिए आउटपुट फ़ॉर्मैट. डिफ़ॉल्ट रूप से, यह विकल्प APK_SET, जो APK सेट वाले संग्रह में APK को आउटपुट करता है. बनाया गया. अगर इसे DIRECTORY पर सेट किया जाता है, तो यह APK को --output के ज़रिए बताई गई डायरेक्ट्री.
--verbose	अगर सेट किया जाता है, तो यह विकल्प स्टैंडर्ड आउटपुट.
--version-code	SDK टूल का वर्शन कोड. Android प्लैटफ़ॉर्म इस वर्शन कोड का इस्तेमाल करता है APK इंस्टॉल करने के लिए ज़रूरी है, SDK टूल के वर्शन के लिए नहीं. इस विकल्प को आर्बिट्रेरी वैल्यू का इस्तेमाल करें. अगर यह नीति सेट नहीं है, तो इसकी डिफ़ॉल्ट वैल्यू 0 होती है.
--overwrite	अगर यह नीति सेट की जाती है, तो यह पिछले मौजूदा आउटपुट की जगह लागू हो जाती है.

SDK टूल के APKs को डिप्लॉय करना, एक्सट्रैक्ट करना, और उनके साइज़ का आकलन करना

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

SDK टूल के बंडल से SDK टूल का संग्रह जनरेट करें

अपने डिस्ट्रिब्यूशन चैनल पर एएसबी अपलोड करने के बाद, उदाहरण के लिए, Google Play में ASB को Android SDK टूल में बदल दिया गया है Maven के ज़रिए ऐप्लिकेशन डेवलपर को उपलब्ध कराने के लिए, संग्रहित करें (.asar). ज़्यादा के लिए इस बारे में जानकारी पाने के लिए, SDK टूल संग्रह के फ़ॉर्मैट की खास बातें.

अपना ASB बनाने के बाद, आपके पास bundletool build-sdk-asar निर्देश का इस्तेमाल करके, इस तरह से Android SDK टूल को स्थानीय तौर पर संग्रहित करें निम्न कोड में दिखाया गया है:

bundletool build-sdk-asar --sdk-bundle=sdk.asb --output=sdk.asar \
    --apk-signing-key-certificate=keycert.txt

नीचे दी गई टेबल में उन अलग-अलग फ़्लैग और विकल्पों के बारे में बताया गया है जिन्हें कब सेट किया जा सकता है bundletool build-sdk-asar कमांड का इस्तेमाल करके, ज़्यादा जानकारी पाएं.

पांचवीं टेबल. bundletool build-sdk-asar निर्देश

चिह्नित करें	ब्यौरा
--apk-signing-key-certificate	(ज़रूरी है) SDK टूल के APK साइनिंग सर्टिफ़िकेट का पाथ. यह है का प्रमाणपत्र, जिसका उपयोग आपने build-sdk-apks निर्देश.
--output	(ज़रूरी है) वह पाथ जहां आपको .asar फ़ाइल को रखना है बनाया गया.
--sdk-bundle	(ज़रूरी है) SDK टूल के बंडल का पाथ. एक्सटेंशन होना ज़रूरी है .asb.
--overwrite	अगर यह नीति सेट की जाती है, तो यह पिछले मौजूदा आउटपुट की जगह लागू हो जाती है.

रनटाइम के साथ काम करने वाले एसडीके फ़ॉर्मैट (एक्सपेरिमेंट के तौर पर उपलब्ध)

रनटाइम के साथ काम करने वाले SDK टूल के लिए, Android के दो फ़ाइल फ़ॉर्मैट उपलब्ध होते हैं:

• Android SDK बंडल (.asb), इसका इस्तेमाल रनटाइम के साथ काम करने वाला SDK टूल जोड़ दिया गया है.
• Android SDK आर्काइव (.asar), इसका इस्तेमाल Maven पर रनटाइम के साथ काम करने वाला SDK टूल.

Android SDK बंडल फ़ॉर्मैट

SDK बंडल, रनटाइम के साथ काम करने वाले SDK टूल के लिए पब्लिश किया जाने वाला फ़ॉर्मैट है. इसमें सभी चीज़ें शामिल हैं SDK टूल का कोड और संसाधन. इसमें, SDK टूल की किसी लाइब्रेरी का कोड भी शामिल होता है निर्भर करता है. इसमें रनटाइम के साथ काम करने वाले दूसरे रनटाइम के कोड और संसाधन शामिल नहीं होते SDK टूल जिन पर निर्भर करता है.

ध्यान दें: इस फ़ॉर्मैट को इस तरह इंस्टॉल नहीं किया जा सकता. इसने उस पीढ़ी को APK और Google Play या अन्य डिस्ट्रिब्यूशन चैनलों में साइन इन करना.

Android SDK बंडल (ASB), एक्सटेंशन वाली एक साइन की गई ZIP फ़ाइल होती है .asb. SDK टूल के कोड और संसाधनों को उसी तरह व्यवस्थित किया जाता है जिस तरह किसी APK में ढूंढें. ASB में कई कॉन्फ़िगरेशन फ़ाइलें होती हैं, जो इंस्टॉल किए जा सकने वाले APK जनरेट करते हैं.

पहली इमेज. इसका कॉन्टेंट Android SDK बंडल.

नीचे दी गई सूची में कुछ ASB फ़ाइलों के बारे में बताया गया है विवरण:

• SdkBundleConfig.pb: प्रोटो फ़ॉर्मैट में एक कॉन्फ़िगरेशन फ़ाइल, जिसमें रनटाइम के साथ काम करने वाले SDK टूल की सूची होनी चाहिए जिस पर आपका SDK टूल निर्भर करता है. पूरे के बारे में जानने के लिए, sdk_bundle_config.proto फ़ाइल से लिए जाते हैं.

• modules.resm: एक ज़िप फ़ाइल जिसमें SDK टूल के APKs.

• SdkModulesConfig.pb: प्रोटो फ़ॉर्मैट में एक कॉन्फ़िगरेशन फ़ाइल. यह फ़ाइल इसमें SDK टूल के एंट्री पॉइंट का नाम, वर्शन, और क्लास का नाम शामिल होता है फ़्रेमवर्क (SandboxedSdkProvider). पूरी परिभाषा जानने के लिए, यहां देखें: sdk_modules_config.proto फ़ाइल का इस्तेमाल किया जाएगा.

• base/: एक मॉड्यूल, जिसमें SDK टूल का कोड और संसाधन होते हैं.

  • manifest/: प्रोटो फ़ॉर्मैट में SDK टूल का मेनिफ़ेस्ट.
  • dex/: DEX फ़ॉर्मैट में कंपाइल किया गया कोड. एक से ज़्यादा DEX फ़ाइलें दी जा सकती हैं.
  • res/, lib/, assets/: ये डायरेक्ट्री, सामान्य APK. जनरेट करते समय इन डायरेक्ट्री में मौजूद पाथ सुरक्षित रखे जाते हैं: SDK टूल के APKs.
  • root/: यह डायरेक्ट्री उन फ़ाइलों को सेव करती है जिन्हें बाद में रूट किया जाता है APK फ़ॉर्मैट में बदलें. उदाहरण के लिए, इसमें Java-आधारित ऐसे संसाधन शामिल हो सकते हैं जो आपका SDK टूल, Class.getResource() तरीका. इस डायरेक्ट्री में मौजूद पाथ भी सुरक्षित रखे गए हैं.

• BUNDLE-METADATA: इस डायरेक्ट्री में, ऐसी मेटाडेटा फ़ाइलें शामिल हैं जिनमें टूल या ऐप स्टोर के लिए उपयोगी जानकारी हो. ऐसी मेटाडेटा फ़ाइलें इसमें ProGuard मैपिंग और अपने SDK टूल की DEX फ़ाइलों की पूरी सूची शामिल होती है. इस डायरेक्ट्री में मौजूद फ़ाइलें, आपके SDK टूल के APKs में पैकेज नहीं की जाती हैं.

Android SDK आर्काइव का फ़ॉर्मैट

Android SDK आर्काइव, रनटाइम के साथ काम करने वाले एसडीके का डिस्ट्रिब्यूशन फ़ॉर्मैट होता है. यह मेवन. यह एक ZIP फ़ाइल है, जिसका फ़ाइल एक्सटेंशन .asar है. फ़ाइल इसमें ऐसी सारी जानकारी शामिल है जो ऐप्लिकेशन बनाने वाले टूल को एक Android ऐप्लिकेशन बंडल होना चाहिए, जो रनटाइम के साथ काम करने वाले आपके SDK टूल पर निर्भर करता हो.

दूसरी इमेज. इसका कॉन्टेंट Android SDK टूल का संग्रह बंडल.

नीचे दी गई सूची में, Android SDK Archive की कुछ फ़ाइलों के बारे में बताया गया है विवरण:

• SdkMetadata.pb: प्रोटो फ़ॉर्मैट में एक कॉन्फ़िगरेशन फ़ाइल जिसमें SDK टूल का नाम, वर्शन, और हस्ताक्षर करने के लिए इस्तेमाल की गई कुंजी का सर्टिफ़िकेट डाइजेस्ट इस SDK टूल के लिए जनरेट किए गए APKs. पूरी परिभाषा जानने के लिए, यहां देखें: sdk_metadata.proto फ़ाइल से लिए जाते हैं.

• modules.resm: एक ज़िप फ़ाइल जिसमें SDK टूल के APKs. यह.resm Android SDK बंडल.

• AndroidManifest.xml: SDK टूल की मेनिफ़ेस्ट फ़ाइल, जो टेक्स्ट एक्सएमएल फ़ॉर्मैट में होती है.

अन्य संसाधन

bundletool इस्तेमाल करने के बारे में ज़्यादा जानने के लिए, यह वीडियो देखें ऐप्लिकेशन बंडल: बंडलटूल और Play Console के साथ टेस्टिंग बंडल.