कैसे करें

Keep के नियमों को बेहतर तरीके से लागू करना: लाइब्रेरी उपलब्ध कराने वाली कंपनियां, ऐप्लिकेशन-लेवल पर DEX कोड ऑप्टिमाइज़ेशन को कैसे अनब्लॉक कर सकती हैं

पढ़ने में लगने वाला समय: 6 मिनट
Breana Tate की प्रोफ़ाइल देखें
Breana Tate डेवलपर रिलेशंस इंजीनियर

Android ऐप्लिकेशन और लाइब्रेरी डेवलपर के तौर पर, हम सभी का एक ही लक्ष्य होता है: ऐसे ऐप्लिकेशन बनाना जो बेहतर परफ़ॉर्म करें और उपयोगकर्ताओं को बेहतरीन अनुभव दें. R8, Android का ऐप्लिकेशन ऑप्टिमाइज़र है. इसका इस्तेमाल करके, ऐप्लिकेशन के साइज़ को कम किया जा सकता है. R8, इस्तेमाल न किए गए कोड को हटाकर, ऐप्लिकेशन की परफ़ॉर्मेंस को बेहतर बनाता है. साथ ही, बाकी कोड को ऑप्टिमाइज़ और अस्पष्ट बनाता है.

Google Play ने हाल ही में ऐप्लिकेशन और गेम के लिए, DEX कोड ऑप्टिमाइज़ेशन के नए थ्रेशोल्ड का एलान किया है. इनसे ऐप्लिकेशन के स्टार्टअप टाइम को बेहतर बनाने और मेमोरी फ़ुटप्रिंट को कम करने में मदद मिलती है. साथ ही, Android के इस लक्ष्य को पूरा करने में मदद मिलती है कि ज़्यादा मेमोरी इस्तेमाल करने वाले ऐप्लिकेशन की वजह से, उपयोगकर्ता अनुभव पर असर न पड़े. ये थ्रेशोल्ड, ऐप्लिकेशन और गेम पर लागू होते हैं. हालांकि, इन्हें पूरा करना पूरे नेटवर्क की ज़िम्मेदारी है. R8, किसी ऐप्लिकेशन को सिर्फ़ दिए गए पैरामीटर के हिसाब से ऑप्टिमाइज़ कर सकता है. इनमें, ऐप्लिकेशन की डिपेंडेंसी वाली लाइब्रेरी के बंडल किए गए नियम शामिल हैं.

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

इस गाइड में बताया गया है कि लाइब्रेरी उपलब्ध कराने वाली कंपनियां, आम तौर पर आने वाली कुछ समस्याओं को कैसे हल कर सकती हैं. साथ ही, बेहतर परफ़ॉर्मेंस वाले और सटीक नियम कैसे लागू कर सकती हैं, ताकि उनके ग्राहक Google Play की तकनीकी ज़रूरी शर्तें पूरी कर सकें.

उपभोक्ता के लिए डेटा को सेव रखने के नियम क्या हैं?

उपभोक्ता के लिए बनाए गए नियम, Android या JAR लाइब्रेरी में बंडल किए गए निर्देश होते हैं. इनसे R8 को यह पता चलता है कि ऐप्लिकेशन-लेवल पर कंपाइलेशन प्रोसेस के दौरान, लाइब्रेरी कोड के किन हिस्सों को ऑप्टिमाइज़ नहीं किया जा सकता. आर्टफ़ैक्ट को छोटा करने के लिए, ऐप्लिकेशन या लाइब्रेरी में लिखे गए स्टैंडर्ड कीप रूल के उलट, उपभोक्ता के कीप रूल लाइब्रेरी में एम्बेड किए जाते हैं. साथ ही, ये इस बात पर असर डालते हैं कि पूरे ऐप्लिकेशन को ऑप्टिमाइज़ करने के दौरान, लाइब्रेरी को कैसे छोटा किया जाता है. इससे यह पक्का होता है कि इंटरनल रिफ़्लेक्शन टारगेट और नेटिव इंटरफ़ेस में कोई बदलाव न हो. इसके लिए, ऐप्लिकेशन डेवलपर को उन्हें मैन्युअल तरीके से पहचानने की ज़रूरत नहीं होती.

उपभोक्ता के लिए, जान-बूझकर और सीमित दायरे में बनाए गए नियम, सबसे सही तरीका है. इससे लाइब्रेरी और उसे इस्तेमाल करने वाले ऐप्लिकेशन, दोनों को फ़ायदा मिलता है. उपभोक्ता के लिए बनाए गए बहुत ज़्यादा सामान्य नियमों की वजह से, इस्तेमाल न होने वाला कोड सेव रहता है. इस वजह से, ऐप्लिकेशन के ऑप्टिमाइज़ेशन और परफ़ॉर्मेंस पर असर पड़ता है. DEX कोड ऑप्टिमाइज़ेशन से जुड़ी अहम जानकारी को Play Console में जोड़ा गया है. इससे ऐप्लिकेशन डेवलपर को जो मेट्रिक दिखेंगी वे ऐप्लिकेशन और उसमें इंटिग्रेट की गई लाइब्रेरी, दोनों के नियमों के असर को मिलाकर दिखाएंगी.

स्थिरता और परफ़ॉर्मेंस को संतुलित करना

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

हालांकि, क्रैश होने से रोकने के लिए, पैकेज-वाइड या अन्य ब्रॉड कीप नियमों को लंबे समय तक इस्तेमाल करने का सुझाव नहीं दिया जाता. ऐसा इसलिए, क्योंकि ये नियम R8 की पूरे प्रोग्राम के ऐप्लिकेशन को ऑप्टिमाइज़ करने की क्षमता को काफ़ी हद तक सीमित कर देते हैं. यहां कुछ रणनीतियां सुझाई गई हैं. इनकी मदद से, स्थिरता से समझौता किए बिना, बेहतर परफ़ॉर्मेंस वाले नियम बनाए जा सकते हैं:

1. सीमित दायरे वाले नियमों की जांच करना और उन्हें लागू करना

कम दायरे वाले नियमों को भरोसे के साथ रिलीज़ करने के लिए, यहां दिए गए सबसे सही तरीके अपनाएं:

  • सैंपल के तौर पर मिले ऐप्लिकेशन में टेस्ट करना: अपने ऑप्टिमाइज़ेशन की जांच करें में दिए गए लोकल टेस्टिंग के दिशा-निर्देश, सैंपल के तौर पर मिले ऐप्लिकेशन पर भी लागू होते हैं. R8 को चालू करने के बाद, क्रिटिकल यूज़र जर्नी की जांच करें. इससे यह पक्का किया जा सकेगा कि ऐप्लिकेशन की सुविधाएं उम्मीद के मुताबिक काम कर रही हैं.
  • सैंपल के तौर पर मिले ऐप्लिकेशन पर R8 Configuration Analyzer चलाएं. इससे आपको पता चलेगा कि ऐप्लिकेशन डेवलपर को अपने R8 कॉन्फ़िगरेशन का ऑडिट करते समय क्या दिखता है. इससे आपको डाउनस्ट्रीम ऐप्लिकेशन पर, अपने कीप रूल के असर को आसानी से विज़ुअलाइज़ करने में मदद मिलती है.
  • अपने एएआर या जेएआर के ऑप्टिमाइज़ेशन का आकलन करने के लिए, Android का सीएलआई से विश्लेषण करने वाले निर्देश का इस्तेमाल करें. इसमें, सेव किए गए तरीके, क्लास, और फ़ील्ड शामिल हैं. रिग्रेशन पर नज़र रखने के लिए, अलग-अलग रिलीज़ के हिसाब से इन नंबरों की तुलना की जा सकती है.
  • Google Play SDK Console में, लाइब्रेरी के वर्शन के इस्तेमाल और क्रैश को मॉनिटर करें.
  • सबसे सही तरीके जानने के लिए, लाइब्रेरी तैयार करने वालों के लिए ऑप्टिमाइज़ेशन से जुड़ी गाइड और R8 दस्तावेज़ देखें.

2. ज़्यादा जानकारी वाले कीप रूल के बिना, रिफ़्लेक्शन और जेएनआई टारगेट को सुरक्षित रखना

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

अगर आपका एसडीके, गेम या फ़ोटो और वीडियो एडिटर जैसे नेटिव कोड को टारगेट करता है, तो जेएनआई का इस्तेमाल करने वाली सभी क्लास के लिए नियम उपलब्ध कराएं. ज़्यादातर गेम, Unity और Unreal जैसे गेम इंजन पर चलते हैं. ये गेम को नेटिव कोड में कंपाइल करते हैं. गेम का नेटिव कोड और आपका प्लग इन, जेएनआई कॉल के ज़रिए Android फ़्रेमवर्क से कम्यूनिकेट करता है.

Jetpack Keep annotations, अब ऐल्फ़ा वर्शन में उपलब्ध है. इसकी मदद से, रिफ़्लेक्शन के इस्तेमाल के बारे में जानकारी दी जा सकती है. इससे, रिफ़्लेक्शन के रखरखाव की ज़रूरत को कम किया जा सकता है. इसके बाद, बिल्ड के समय कीप रूल जनरेट करने के लिए, इस जानकारी का इस्तेमाल किया जा सकता है.

रिफ़्लेक्शन के बजाय कोड जनरेशन का इस्तेमाल करना

रिफ़्लेक्शन की वजह से होने वाले क्रैश से बचने के लिए, हमारी सबसे बड़ी सलाह यह है कि रिफ़्लेक्शन से बचें और जहां हो सके वहां codegen का इस्तेमाल करें. 

रनटाइम रिफ़्लेक्शन, कंपाइलेशन के दौरान R8 से कोड के इस्तेमाल को छिपा देता है. इसके लिए, क्रैश से बचने के लिए नियमों को बनाए रखना ज़रूरी है. अगर codegen का इस्तेमाल किया जाता है, तो बिल्ड प्रोसेस के दौरान कोड ऑप्टिमाइज़ हो जाता है. इससे R8 को ज़रूरी जानकारी मिलती है, ताकि वह कम से कम नियमों का इस्तेमाल करके, कोड को सुरक्षित तरीके से ऑप्टिमाइज़ कर सके. कोड जनरेशन का इस्तेमाल आम तौर पर, सीरियलाइज़ेशन और डीसीरियलाइज़ेशन के साथ-साथ डिपेंडेंसी इंजेक्शन के लिए किया जाता है. Hilt, कोड जनरेशन का इस्तेमाल करने वाली लाइब्रेरी का एक उदाहरण है.

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

पहले से ऑप्टिमाइज़ की गई लाइब्रेरी के बिल्ड के लिए भी, स्कोप के नियमों को सीमित रखें

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

यह तब भी लागू होता है, जब आपने अपनी लाइब्रेरी बिल्ड को पहले से ही ऑप्टिमाइज़ या छिपाया हो. यह एक बेहतरीन तरीका है, जिससे यह पक्का किया जा सकता है कि एसडीके की परफ़ॉर्मेंस बेहतर हो और उसका साइज़ कम हो. आपके नियम, ऐप्लिकेशन के कंपाइलेशन के दौरान लागू होते हैं. इसलिए, R8 अब भी आपकी लाइब्रेरी को उन असल क्लास और तरीकों के आधार पर ऑप्टिमाइज़ कर सकता है जिनका इस्तेमाल डाउनस्ट्रीम ऐप्लिकेशन करता है. Android का सीएलआई विश्लेषण करने वाला निर्देश , पैकेज के लिए इस्तेमाल किए गए और इस्तेमाल नहीं किए गए, दोनों तरह के नियमों को पहले से ही दिखाता है. इनकी वजह से, ऑप्टिमाइज़ेशन ब्लॉक हो जाता है.

तीसरे पक्ष की डिपेंडेंसी के लिए, डेटा को बनाए रखने के नियमों का दायरा सीमित रखना

हमने आम तौर पर यह पैटर्न देखा है:

-keep public class com.google.android.gms.** { *; }

अगर आपके एसडीके को इंटिग्रेट करने वाला कोई ऐप्लिकेशन, किसी दूसरी GMS लाइब्रेरी का भी इस्तेमाल करता है और उसमें कोड की संख्या को सीमित रखने के लिए, 'keep' नियम शामिल है, तो यह सामान्य नियम उसकी जगह लागू हो जाता है. इससे ऐप्लिकेशन में ग़ैर-ज़रूरी कोड जुड़ जाता है. 

बाहरी लाइब्रेरी को शुरू करते समय, आपको ऐसे नियम बनाने चाहिए जो सिर्फ़ उन एलिमेंट को सुरक्षित रखें जिन्हें आपकी लाइब्रेरी रिफ़्लेक्शन के ज़रिए ऐक्सेस करती है. इसके अलावा, हकीकत यह है कि कई लाइब्रेरी (इनमें GMS भी शामिल है) पहले से ही अपने उपभोक्ता के लिए, कीप रूल उपलब्ध कराती हैं. पूरे पैकेज के लिए कीप रूल लागू करने से, डाउनस्ट्रीम लाइब्रेरी के लिए सावधानी से लिखे गए और सीमित दायरे वाले उपभोक्ता नियम भी शामिल हो सकते हैं.

विज्ञापन मीडिएशन अडैप्टर के लिए, शर्त के आधार पर डेटा बनाए रखने के नियमों का इस्तेमाल करें 

अगर आपकी विज्ञापन लाइब्रेरी, मीडिएशन अडैप्टर का इस्तेमाल करके लोड की जाती है, तो डेटा बनाए रखने के लिए सीमित नियमों का इस्तेमाल अब भी किया जा सकता है. इस मामले में, हमारा सुझाव है कि आप शर्तों के साथ लागू होने वाले कीप रूल का इस्तेमाल करें. इससे सिर्फ़ कुछ सुविधाओं या फ़ॉर्मैट को सुरक्षित रखा जा सकता है. हालांकि, इसके लिए ज़रूरी है कि ऐप्लिकेशन में उनसे जुड़ा अडैप्टर शामिल हो. इससे यह पक्का होता है कि R8 अब भी उन सुविधाओं को छोटा कर सकता है जिनका इस्तेमाल ऐप्लिकेशन नहीं करता. इसके अलावा, Jetpack Keep एनोटेशन का इस्तेमाल करके, सोर्स कोड में सीधे तौर पर रिफ़्लेक्टिव कॉल को एनोटेट किया जा सकता है. इससे, आपको मैन्युअल तरीके से जटिल नियम लिखने की ज़रूरत नहीं पड़ेगी. साथ ही, उपभोक्ता के लिए शर्त के आधार पर, अपने-आप नियम जनरेट हो जाएंगे. इनमें वैकल्पिक ऐड-ऑन मॉड्यूल के नियम भी शामिल हैं.

उपभोक्ता के लिए बनाए गए नियमों में शिपिंग के नियम शामिल करें, न कि दस्तावेज़ में

अपनी लाइब्रेरी के साथ उपभोक्ता के नियम शिप करके, यह पक्का किया जा सकता है कि R8 की सुविधा वाले बिल्ड वाले ऐप्लिकेशन, आपकी लाइब्रेरी का इस्तेमाल कर सकें और ज़्यादा से ज़्यादा ऑप्टिमाइज़ेशन अनलॉक कर सकें. 

अपने दस्तावेज़ में नियम तय करने से, मैन्युअल सेटअप में परेशानी होती है. ऐसा इसलिए, क्योंकि बंडल किए गए उपभोक्ता के नियम, सालों से एएआर और जेएआर में काम करते हैं. साथ ही, इससे रखरखाव का खर्च भी बढ़ता है. अपनी लाइब्रेरी को अपडेट करते समय (इसमें रीफ़ैक्टरिंग, क्लास का नाम बदलना, और रिफ़्लेक्शन के इस्तेमाल का तरीका बदलना शामिल है), आपको दस्तावेज़ को अपडेट करना होगा. साथ ही, ऐप्लिकेशन को नए नियमों की जांच करनी होगी. समय के साथ, जब ऐप्लिकेशन आपकी लाइब्रेरी के कई वर्शन के ज़रिए अपग्रेड होते हैं, तो उनमें ऐसे लेगसी कीप रूल इकट्ठा हो सकते हैं जिनकी अब ज़रूरत नहीं है. इससे ऐप्लिकेशन में ग़ैर-ज़रूरी डेटा इकट्ठा हो सकता है.

3. रिलीज़ स्टैक ट्रेस को पढ़ा जा रहा है

ऐसा हो सकता है कि आपको कोड को छिपाने की वजह से, स्टैक ट्रेस को पढ़ने में समस्या आई हो. गहन विश्लेषण को अनब्लॉक करने के लिए, keepnames का इस्तेमाल किया जा सकता है. इससे फ़ाइल का साइज़ छोटा किया जा सकता है. हालांकि, इससे उपभोक्ता एप्लिकेशन में नाम बदलने जैसे अन्य ऑप्टिमाइज़ेशन नहीं किए जा सकते. स्टैक ट्रेस को डीबग करते समय, आपको सटीक वैल्यू की ज़रूरत होती है. 

पढ़ने लायक स्टैक ट्रेस पाने के लिए, आपको अतिरिक्त ऑप्टिमाइज़ेशन को रोकने की ज़रूरत नहीं है.

Firebase Crashlytics, Play Console, और Android Studio में Logcat, ऐप्लिकेशन डेवलपर के लिए स्टैक ट्रेस को डीऑब्फ़स्केट करते हैं. इसका मतलब है कि अगर कोई ऐप्लिकेशन डेवलपर आपके साथ स्टैक ट्रेस शेयर करता है, तो उसे पढ़ने के लिए आपको कोड को छिपाने की प्रोसेस को रोकने की ज़रूरत नहीं है.

SDK Console में मैपिंग फ़ाइल अपलोड करने पर, आपको SDK Console में डिकोड किए गए स्टैक ट्रेस दिखेंगे.

ऑप्टिमाइज़ेशन के लिए अनुमान लगाने की ज़रूरत नहीं है

अपनी लाइब्रेरी को ऑप्टिमाइज़ करना, बार-बार कोशिश करके सीखने जैसा नहीं लगना चाहिए.

उपभोक्ता के लिए ऐप्लिकेशन को बनाए रखने के नियमों का पालन करके, लाइब्रेरी उपलब्ध कराने वाली कंपनियां यह पक्का कर सकती हैं कि पूरे नेटवर्क में मौजूद ऐप्लिकेशन, ऑप्टिमाइज़ेशन से अनब्लॉक रहें.

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

लेखक:
पढ़ना जारी रखें