R8 की मदद से ऐप्लिकेशन ऑप्टिमाइज़ेशन की सुविधा चालू करना

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

• तेजी से शुरू कर सकते हैं
• मेमोरी का इस्तेमाल कम करें
• रेंडरिंग और रनटाइम परफ़ॉर्मेंस बेहतर हुई
• एक से ज़्यादा बार, ऐप्लिकेशन से प्रतिक्रिया न मिलना (ANR) की समस्या कम हुई

R8 ऑप्टिमाइज़ेशन की खास जानकारी

R8, आपके ऐप्लिकेशन को साइज़ और स्पीड के हिसाब से ऑप्टिमाइज़ करने के लिए, कई चरणों वाली प्रोसेस का इस्तेमाल करता है. मुख्य कार्रवाइयों में ये शामिल हैं:

• कोड छोटा करना (इसे ट्री शेकिंग भी कहा जाता है): R8, आपके ऐप्लिकेशन और उसकी लाइब्रेरी डिपेंडेंसी से, ऐसे कोड की पहचान करता है जिसे ऐक्सेस नहीं किया जा सकता. इसके बाद, उसे हटा देता है. R8, आपके ऐप्लिकेशन के एंट्री पॉइंट (जैसे, मेनिफ़ेस्ट में तय की गई Activities या Services) का विश्लेषण करके, रेफ़रंस वाले कोड का ग्राफ़ बनाता है. इसके बाद, ऐसे कोड को हटा देता है जिसका कोई रेफ़रंस नहीं होता.

• लॉजिकल ऑप्टिमाइज़ेशन: R8, एक्ज़ीक्यूशन की क्षमता को बेहतर बनाने और ओवरहेड को कम करने के लिए, आपके कोड को फिर से लिखता है. मुख्य तकनीकों में ये शामिल हैं:

  • मेथड इनलाइनिंग: R8, मेथड कॉल साइट को कॉल की गई मेथड के असल बॉडी से बदल देता है. इससे फ़ंक्शन कॉल का ओवरहेड खत्म हो जाता है और R8 को आगे ऑप्टिमाइज़ेशन करने की अनुमति मिलती है.

  • क्लास मर्ज करना: R8, क्लास और इंटरफ़ेस के सेट को एक क्लास में जोड़ता है. इससे ऐप्लिकेशन में क्लास की संख्या कम हो जाती है. साथ ही, मेमोरी पर पड़ने वाला दबाव कम हो जाता है और स्टार्टअप की स्पीड बेहतर हो जाती है.

• कोड को उलझाना (इसे काट-छांट की सुविधा भी कहा जाता है): DEX फ़ाइल का साइज़ कम करने के लिए, R8 क्लास, फ़ील्ड, और मेथड के नामों को छोटा करता है. उदाहरण के लिए, com.example.MyActivity को a.b.a बनाया जा सकता है.

Android Gradle प्लगिन (AGP) के 8.12.0 वर्शन के बाद से, R8, ऑप्टिमाइज़ेशन के चरणों के तहत संसाधनों को भी ऑप्टिमाइज़ करता है. ज़्यादा जानकारी के लिए, इस्तेमाल न किए जाने वाले ऑप्टिमाइज़ रिसॉर्स को हटाने की सुविधा लेख पढ़ें.

ऑप्टिमाइज़ेशन की सुविधा चालू करना

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

AGP के 9.3 और इसके बाद के वर्शन के लिए

AGP के 9.3 और इसके बाद के वर्शन के लिए, ऐप्लिकेशन के ऑप्टिमाइज़ेशन की सुविधा चालू करने के लिए:

• रिलीज़ के लिए तैयार बिल्ड के ऐप्लिकेशन-लेवल के बिल्ड स्क्रिप्ट में, optimization ब्लॉक में enable = true सेट करें.
• अपने कीप नियम को src/<variant>/keepRules सोर्स सेट में, .keep सफ़िक्स वाली किसी फ़ाइल में जोड़ें. उदाहरण के लिए, src/main/keepRules/custom-rules.keep.

android {
    buildTypes {
        release {
            optimization {
                enable = true // Enables code and resource optimizations.
            }
        }
    }
}

android {
    buildTypes {
        release {
            optimization {
                enable = true // Enables code and resource optimizations.
            }
        }
    }
}

AGP के 9.3 से पहले के वर्शन के लिए लेगसी डीएसएल

ऐप्लिकेशन के ऑप्टिमाइज़ेशन की सुविधा चालू करने के लिए, रिलीज़ के लिए तैयार बिल्ड के ऐप्लिकेशन-लेवल के बिल्ड स्क्रिप्ट में, isMinifyEnabled = true (कोड ऑप्टिमाइज़ेशन के लिए) और isShrinkResources = true (संसाधन ऑप्टिमाइज़ेशन के लिए) सेट करें. हमारा सुझाव है कि दोनों सेटिंग हमेशा चालू रखें.

android {
    buildTypes {
        release {

            // Enables code optimizations.
            isMinifyEnabled = true

            // Enables resource shrinking.
            isShrinkResources = true

            proguardFiles(
                // Default file with automatically generated optimization rules.
                getDefaultProguardFile("proguard-android-optimize.txt"),

                ...
            )
            ...
        }
    }
    ...
}

android {
    buildTypes {
        release {

            // Enables code optimizations.
            minifyEnabled = true

            // Enables resource shrinking.
            shrinkResources = true

            // Default file with automatically generated optimization rules.
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt')

            ...
        }
    }
}

R8 ऑप्टिमाइज़ेशन को बेहतर बनाना

R8 की परफ़ॉर्मेंस के फ़ायदे, सीधे तौर पर इस बात से जुड़े होते हैं कि R8, आपके कोडबेस को कितना ऑप्टिमाइज़ कर पाता है. R8 से ज़्यादा से ज़्यादा फ़ायदे पाने के लिए, सबसे सही तरीकों का पालन करें:

• R8 को फ़ुल मोड में चालू करें
• कोड को उलझाने, ऑप्टिमाइज़ेशन, और कोड छोटा करने की सुविधा चालू करें
• इस्तेमाल न किए जाने वाले रिसॉर्स को हटाने की सुविधा और ऑप्टिमाइज़ रिसॉर्स को हटाने की सुविधा चालू करें
• कीप नियमों को बेहतर बनाएं, ताकि क्लास, फ़ील्ड, और मेथड को ज़्यादा से ज़्यादा ऑप्टिमाइज़ किया जा सके.

कीप नियमों को बेहतर बनाने में मदद पाने के लिए, R8 कॉन्फ़िगरेशन एनलाइज़र का इस्तेमाल करें.

R8 कॉन्फ़िगरेशन एनलाइज़र की मदद से, ये काम किए जा सकते हैं:

• R8 कॉन्फ़िगरेशन एनलाइज़र की रिपोर्ट में दी गई मेट्रिक की निगरानी करके, R8 के कॉन्फ़िगरेशन की कुल क्वालिटी को ट्रैक करें और उसे बेहतर बनाएं.
• सबसे ज़्यादा कीप नियमों का पता लगाएं. ये नियम, ऑप्टिमाइज़ेशन को सबसे ज़्यादा रोकते हैं
• और यह समझें कि वे किस ऑप्टिमाइज़ेशन को रोकते हैं, ताकि उन्हें बेहतर बनाया जा सके.

R8 कॉन्फ़िगरेशन एनलाइज़र, AGP के 9.3.0-alpha05 वर्शन या R8 के 9.3.7-dev वर्शन में उपलब्ध है. ज़्यादा जानकारी के लिए, R8 कॉन्फ़िगरेशन का विश्लेषण करना लेख पढ़ें.

इस्तेमाल न किए जाने वाले ऑप्टिमाइज़ रिसॉर्स को हटाने की सुविधा की मदद से, ऐप्लिकेशन के साइज़ को और कम करना

AGP के 8.12.0 वर्शन में, इस्तेमाल न किए जाने वाले ऑप्टिमाइज़ रिसॉर्स को हटाने की सुविधा जोड़ी गई है. इसका मकसद, संसाधन और कोड ऑप्टिमाइज़ेशन को इंटिग्रेट करके, ऐप्लिकेशन के साइज़ को और कम करना और उन्हें तेज़ी से काम करने लायक बनाना है. इस्तेमाल न किए जाने वाले ऑप्टिमाइज़ रिसॉर्स को हटाने की सुविधा से पहले, Android Asset Packaging Tool (AAPT2), कीप नियम जनरेट करता था. इससे, संसाधन ऑप्टिमाइज़ेशन को कोड से अलग माना जाता था. इसलिए, अक्सर ऐसे कोड या संसाधन सुरक्षित रखे जाते थे जिन्हें ऐक्सेस नहीं किया जा सकता था और जो एक-दूसरे को रेफ़र करते थे.

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

इस्तेमाल न किए जाने वाले ऑप्टिमाइज़ रिसॉर्स को हटाने की सुविधा चालू करना

AGP के 8.12 या 8.13 वर्शन के लिए, इस्तेमाल न किए जाने वाले ऑप्टिमाइज़ रिसॉर्स को हटाने की नई पाइपलाइन चालू करने के लिए, अपने प्रोजेक्ट की gradle.properties फ़ाइल में यह कोड जोड़ें:

अगर AGP के 9.0.0 या इसके बाद के वर्शन का इस्तेमाल किया जा रहा है, तो आपको android.r8.optimizedResourceShrinking=true सेट करने की ज़रूरत नहीं है. जब आपके बिल्ड कॉन्फ़िगरेशन में isShrinkResources = true चालू होता है, तो इस्तेमाल न किए जाने वाले ऑप्टिमाइज़ रिसॉर्स को हटाने की सुविधा अपने-आप लागू हो जाती है.

R8 ऑप्टिमाइज़ेशन सेटिंग की पुष्टि करना और उन्हें कॉन्फ़िगर करना

R8 को ऑप्टिमाइज़ेशन की पूरी क्षमताओं का इस्तेमाल करने की अनुमति देने के लिए, अपने प्रोजेक्ट की यह लाइन हटाएं. अगर यह लाइन मौजूद है, तो: gradle.properties फ़ाइल से

bash android.enableR8.fullMode=false # Remove this line from your codebase.

ध्यान दें कि ऐप्लिकेशन के ऑप्टिमाइज़ेशन की सुविधा चालू करने से, स्टैक ट्रेस को समझना मुश्किल हो जाता है. ऐसा तब होता है, जब R8, क्लास या मेथड के नामों को बदल देता है. सोर्स कोड से सही तरीके से मेल खाने वाले स्टैक ट्रेस पाने के लिए, ओरिजनल स्टैक ट्रेस वापस पाना लेख पढ़ें.

अगर R8 चालू है, तो आपको स्टार्टअप परफ़ॉइल भी बनाने चाहिए, ताकि स्टार्टअप परफ़ॉर्मेंस और बेहतर हो सके.

अगर ऐप्लिकेशन के ऑप्टिमाइज़ेशन की सुविधा चालू करने पर गड़बड़ियां होती हैं, तो उन्हें ठीक करने के लिए यहां कुछ रणनीतियां दी गई हैं:

• कुछ कोड को बिना बदलाव के रखने के लिए, कीप नियम जोड़ें.
• ऑप्टिमाइज़ेशन को धीरे-धीरे लागू करें.
• अपने कोड को अपडेट करें, ताकि ऑप्टिमाइज़ेशन के लिए बेहतर तरीके से काम करने वाली लाइब्रेरी का इस्तेमाल किया जा सके.

अगर आपको बिल्ड की स्पीड को ऑप्टिमाइज़ करना है, तो अपने एनवायरमेंट के हिसाब से R8 को कॉन्फ़िगर करने के तरीके के बारे में जानने के लिए, R8 को चलाने का तरीका कॉन्फ़िगर करना लेख पढ़ें.

AGP और R8 के वर्शन के व्यवहार में बदलाव

यहां दी गई टेबल में, Android Gradle प्लगिन (AGP) और R8 कंपाइलर के अलग-अलग वर्शन में जोड़ी गई मुख्य सुविधाओं के बारे में बताया गया है.