Android बिल्ड में Java वर्शन

आपका सोर्स कोड Java, Kotlin या दोनों में लिखा गया हो, आपको अपने बिल्ड के लिए JDK या Java लैंग्वेज का वर्शन चुनना होगा.

पहली इमेज. बिल्ड में JDK के संबंध

शब्दावली

Java डेवलपमेंट किट (JDK)

Java डेवलपमेंट किट (जेडीके) में ये शामिल हैं:

• टूल, जैसे कि कंपाइलर, प्रोफ़ाइलर, और संग्रह बनाने वाला टूल. इनका इस्तेमाल, ऐप्लिकेशन बनाने के दौरान बैकग्राउंड में किया जाता है.
• ऐसी लाइब्रेरी जिनमें एपीआई शामिल होते हैं. इन्हें अपने Kotlin या Java सोर्स कोड से कॉल किया जा सकता है. ध्यान दें कि Android पर सभी फ़ंक्शन उपलब्ध नहीं हैं.
• Java Virtual Machine (JVM), एक इंटरप्रेटर है जो Java ऐप्लिकेशन को एक्ज़ीक्यूट करता है. Android Studio IDE और Gradle बिल्ड टूल को चलाने के लिए, JVM का इस्तेमाल किया जाता है. JVM का इस्तेमाल Android डिवाइसों या एम्युलेटर पर नहीं किया जाता.

JetBrains Runtime (JBR)

JetBrains Runtime (JBR) एक बेहतर JDK है. इसे Android Studio के साथ डिस्ट्रिब्यूट किया जाता है. इसमें Studio और JetBrains से जुड़े प्रॉडक्ट में इस्तेमाल करने के लिए कई ऑप्टिमाइज़ेशन शामिल हैं. हालाँकि, इसका इस्तेमाल अन्य Java ऐप्लिकेशन चलाने के लिए भी किया जा सकता है.

Android Studio चलाने के लिए, मैं JDK कैसे चुनूं?

हमारा सुझाव है कि Android Studio को चलाने के लिए, JBR का इस्तेमाल करें. इसे Android Studio के साथ डिप्लॉय किया जाता है और इसका इस्तेमाल Android Studio की जांच करने के लिए किया जाता है. साथ ही, इसमें Android Studio का बेहतर तरीके से इस्तेमाल करने के लिए कई सुधार किए गए हैं. यह पक्का करने के लिए, STUDIO_JDK एनवायरमेंट वैरिएबल सेट न करें.

Android Studio के लिए स्टार्टअप स्क्रिप्ट, इस क्रम में JVM ढूंढती हैं:

1. STUDIO_JDK एनवायरमेंट वैरिएबल
2. studio.jdk डायरेक्ट्री (Android Studio के डिस्ट्रिब्यूशन में)
3. jbr डायरेक्ट्री (JetBrains Runtime) में मौजूद है. यह Android Studio के डिस्ट्रिब्यूशन में शामिल है. सुझाई गई.
4. JDK_HOME एनवायरमेंट वैरिएबल
5. JAVA_HOME एनवायरमेंट वैरिएबल
6. PATH एनवायरमेंट वैरिएबल में java एक्ज़ीक्यूटेबल

मैं कैसे चुनूं कि मेरे Gradle बिल्ड को कौनसा JDK चलाएगा?

अगर Android Studio में मौजूद बटन का इस्तेमाल करके Gradle चलाया जाता है, तो Gradle को चलाने के लिए Android Studio की सेटिंग में सेट किए गए JDK का इस्तेमाल किया जाता है. अगर Gradle को Android Studio के अंदर या बाहर किसी टर्मिनल में चलाया जाता है, तो JAVA_HOME एनवायरमेंट वैरिएबल (अगर सेट है) यह तय करता है कि Gradle स्क्रिप्ट को कौनसे JDK से चलाया जाए. अगर JAVA_HOME सेट नहीं है, तो यह आपके PATH एनवायरमेंट वैरिएबल पर java कमांड का इस्तेमाल करता है.

सबसे सटीक नतीजे पाने के लिए, पक्का करें कि आपने JAVA_HOME एनवायरमेंट वैरिएबल और Android Studio में Gradle JDK कॉन्फ़िगरेशन को एक ही JDK पर सेट किया हो.

ध्यान दें: अगर आपने IDE का इस्तेमाल करके, Android Studio के टर्मिनल में Gradle कमांड चलाई है, तो यह JAVA_HOME के बजाय Android Studio की सेटिंग में मौजूद JDK का इस्तेमाल करेगा. इसके लिए, टर्मिनल में राइट क्लिक करें और हाइलाइट की गई कमांड चलाएं को चुनें.

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

अगर अलग-अलग JDK या Gradle वर्शन से बिल्ड शुरू किए जाते हैं, तो अतिरिक्त डेमॉन बनाए जाते हैं. इससे ज़्यादा सीपीयू और मेमोरी का इस्तेमाल होता है.

अहम जानकारी: एक साथ कई प्रोजेक्ट पर काम करते समय, अगर हो सके, तो उनके gradle-wrapper.properties फ़ाइल में एक ही Gradle वर्शन डालें. इससे, बनाए गए Gradle डेमॉन की संख्या कम हो जाएगी.

Android Studio में Gradle JDK कॉन्फ़िगरेशन

मौजूदा प्रोजेक्ट के Gradle JDK कॉन्फ़िगरेशन में बदलाव करने के लिए, फ़ाइल (macOS पर Android Studio) > सेटिंग > बिल्ड, एक्ज़ीक्यूशन, डिप्लॉयमेंट > बिल्ड टूल > Gradle से Gradle सेटिंग खोलें. Gradle JDK ड्रॉप-डाउन में, चुनने के लिए ये विकल्प होते हैं:

• JAVA_HOME और GRADLE_LOCAL_JAVA_HOME जैसे मैक्रो
• vendor-version फ़ॉर्मैट में JDK टेबल की एंट्री, जैसे कि jbr-17. इन्हें Android कॉन्फ़िगरेशन फ़ाइलों में सेव किया जाता है
• JDK डाउनलोड करना
• कोई खास JDK जोड़ना
• ऑपरेटिंग सिस्टम के डिफ़ॉल्ट JDK इंस्टॉलेशन डायरेक्ट्री से स्थानीय तौर पर पता लगाए गए JDK

चुना गया विकल्प, प्रोजेक्ट की .idea/gradle.xml फ़ाइल में मौजूद gradleJvm विकल्प में सेव होता है. साथ ही, Android Studio से शुरू किए जाने पर Gradle को चलाने के लिए, इसके JDK पाथ रिज़ॉल्यूशन का इस्तेमाल किया जाता है.

दूसरी इमेज. Android Studio में Gradle JDK की सेटिंग.

मैक्रो की मदद से, प्रोजेक्ट के लिए JDK पाथ को डाइनैमिक तरीके से चुना जा सकता है:

• JAVA_HOME: इसी नाम वाले एनवायरमेंट वैरिएबल का इस्तेमाल करता है
• GRADLE_LOCAL_JAVA_HOME: यह .gradle/config.properties फ़ाइल में मौजूद java.home प्रॉपर्टी का इस्तेमाल करता है. इसकी डिफ़ॉल्ट वैल्यू JetBrains Runtime होती है.

चुने गए JDK का इस्तेमाल, Gradle बिल्ड को चलाने और बिल्ड स्क्रिप्ट और सोर्स कोड में बदलाव करते समय JDK API रेफ़रंस को हल करने के लिए किया जाता है. ध्यान दें कि तय किए गए compileSdk से यह तय होगा कि सोर्स कोड में बदलाव करते समय और उसे बनाते समय, कौनसे Java सिंबल उपलब्ध होंगे.

ध्यान दें: ज़्यादातर मामलों में, हमारा सुझाव है कि आप GRADLE_LOCAL_JAVA_HOME का इस्तेमाल करें. यह नए प्रोजेक्ट के लिए डिफ़ॉल्ट रूप से उपलब्ध होता है. इसकी मदद से, प्रोजेक्ट को खोले बिना ही, प्रोजेक्ट के हिसाब से JDK तय किया जा सकता है.

पक्का करें कि आपने ऐसा JDK वर्शन चुना हो जो Gradle बिल्ड में इस्तेमाल किए जाने वाले प्लगिन के JDK वर्शन से ज़्यादा या उसके बराबर हो. Android Gradle प्लग इन (AGP) के लिए, कम से कम ज़रूरी JDK वर्शन का पता लगाने के लिए, प्रॉडक्ट की जानकारी में दी गई, कंपैटिबिलिटी टेबल देखें.

उदाहरण के लिए, Android Gradle Plugin के 8.x वर्शन के लिए JDK 17 की ज़रूरत होती है. अगर JDK के पुराने वर्शन के साथ इसका इस्तेमाल करने वाली Gradle बिल्ड को चलाने की कोशिश की जाती है, तो यह इस तरह का मैसेज दिखाता है:

An exception occurred applying plugin request [id: 'com.android.application']
> Failed to apply plugin 'com.android.internal.application'.
   > Android Gradle plugin requires Java 17 to run. You are currently using Java 11.
      Your current JDK is located in /usr/local/buildtools/java/jdk
      You can try some of the following options:
       - changing the IDE settings.
       - changing the JAVA_HOME environment variable.
       - changing `org.gradle.java.home` in `gradle.properties`.

मैं अपने Java या Kotlin सोर्स कोड में कौनसे Java API इस्तेमाल कर सकता हूं?

Android ऐप्लिकेशन, JDK में तय किए गए कुछ एपीआई का इस्तेमाल कर सकता है. हालांकि, वह सभी एपीआई का इस्तेमाल नहीं कर सकता. Android SDK, उपलब्ध एपीआई के हिस्से के तौर पर, कई Java लाइब्रेरी फ़ंक्शन के इस्तेमाल के बारे में बताता है. compileSdk प्रॉपर्टी से यह तय होता है कि आपके Kotlin या Java सोर्स कोड को कंपाइल करते समय, Android SDK के किस वर्शन का इस्तेमाल किया जाए.

Kotlin

android {
    ...
    compileSdk = 33
}

Groovy

android {
    ...
    compileSdk 33
}

Android के हर वर्शन पर, JDK का कोई खास वर्शन और उसके उपलब्ध Java API का सबसेट काम करता है. अगर किसी ऐसे Java API का इस्तेमाल किया जाता है जो किसी ऐसे compileSdk में उपलब्ध है जो बताए गए minSdk में उपलब्ध नहीं है, तो हो सकता है कि Android के पुराने वर्शन में एपीआई का इस्तेमाल किया जा सके. इसके लिए, डीसुगरिंग नाम की प्रोसेस का इस्तेमाल किया जाता है. सपोर्ट किए गए एपीआई के लिए, डीसुगरिंग के ज़रिए उपलब्ध Java 11+ एपीआई देखें.

इस टेबल का इस्तेमाल करके यह पता लगाएं कि हर Android API के साथ Java का कौनसा वर्शन काम करता है. साथ ही, यह भी जानें कि Java के कौनसा एपीआई उपलब्ध हैं.

Android	Java	एपीआई और भाषा से जुड़ी सुविधाएं
14 (एपीआई 34)	17	कोर लाइब्रेरी
13 (एपीआई 33)	11	कोर लाइब्रेरी
12 (एपीआई 32)	11	Java API
11 और इससे कम		Android के वर्शन

मेरा Java सोर्स कोड कौनसे JDK से कंपाइल होता है?

Java टूलचेन JDK में Java कंपाइलर होता है. इसका इस्तेमाल किसी भी Java सोर्स कोड को कंपाइल करने के लिए किया जाता है. यह JDK, बिल्ड के दौरान javadoc और यूनिट टेस्ट भी चलाता है.

टूलचेन डिफ़ॉल्ट रूप से, Gradle को चलाने के लिए इस्तेमाल किए गए JDK पर सेट होती है. डिफ़ॉल्ट सेटिंग का इस्तेमाल करने पर, अगर अलग-अलग मशीनों पर बिल्ड चलाया जाता है (उदाहरण के लिए, आपकी लोकल मशीन और कोई अलग कंटीन्यूअस इंटिग्रेशन सर्वर), तो अलग-अलग JDK वर्शन इस्तेमाल करने पर, आपके बिल्ड के नतीजे अलग-अलग हो सकते हैं.

ज़्यादा भरोसेमंद बिल्ड बनाने के लिए, Java टूलचेन का वर्शन साफ़ तौर पर बताया जा सकता है. इसे तय करने पर:

• यह बिल्ड चलाने वाले सिस्टम पर, JDK का पता लगाता है.
  • अगर कोई भी JDK मौजूद नहीं है और टूलचेन रिज़ॉल्वर तय किया गया है, तो यह JDK डाउनलोड करता है.
• यह टूलचेन Java API को सोर्स कोड से कॉल करने के लिए उपलब्ध कराता है.
• यह Java भाषा के वर्शन का इस्तेमाल करके, Java सोर्स को कंपाइल करता है.
• यह sourceCompatibility और targetCompatibility के लिए डिफ़ॉल्ट वैल्यू देता है.

हमारा सुझाव है कि आप हमेशा Java टूलचेन तय करें. साथ ही, यह पक्का करें कि तय किया गया JDK इंस्टॉल हो या अपनी बिल्ड में टूलचेन रिज़ॉल्वर जोड़ें.

आपके पास टूलचेन तय करने का विकल्प होता है. इससे कोई फ़र्क़ नहीं पड़ता कि आपका सोर्स कोड Java, Kotlin या दोनों में लिखा गया है. अपने मॉड्यूल के build.gradle(.kts) फ़ाइल के टॉप लेवल पर टूलचेन तय करें.

Java टूलचेन का वर्शन इस तरह बताएं:

Kotlin

java {
    toolchain {
        languageVersion = JavaLanguageVersion.of(17)
    }
}

Groovy

java {
    toolchain {
        languageVersion = JavaLanguageVersion.of(17)
    }
}

यह सुविधा तब काम करती है, जब आपका सोर्स Kotlin, Java या दोनों का मिक्स हो.

टूलचेन JDK का वर्शन, Gradle को चलाने के लिए इस्तेमाल किए गए JDK के वर्शन के जैसा हो सकता है. हालांकि, ध्यान रखें कि इन दोनों का मकसद अलग-अलग होता है.

मैं अपने Java सोर्स कोड में, Java भाषा के सोर्स कोड की किन सुविधाओं का इस्तेमाल कर सकता हूँ?

sourceCompatibility प्रॉपर्टी यह तय करती है कि Java सोर्स को कंपाइल करते समय, Java की कौनसी भाषा की सुविधाएं उपलब्ध हैं. इससे Kotlin सोर्स पर कोई असर नहीं पड़ता.

अपने मॉड्यूल की build.gradle(.kts) फ़ाइल में sourceCompatibility को इस तरह से तय करें:

Kotlin

android {
    compileOptions {
        sourceCompatibility = JavaVersion.VERSION_17
    }
}

Groovy

android {
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_17
    }
}

अगर इस प्रॉपर्टी के लिए कोई वैल्यू नहीं दी जाती है, तो डिफ़ॉल्ट रूप से Java toolchain के वर्शन का इस्तेमाल किया जाता है. अगर Java टूलचेन का इस्तेमाल नहीं किया जा रहा है, तो यह Android Gradle प्लगिन के चुने गए वर्शन पर डिफ़ॉल्ट रूप से सेट हो जाता है. उदाहरण के लिए, Java 8 या इसके बाद का वर्शन.

ध्यान दें: Android Studio Giraffe के मुताबिक, प्रोजेक्ट इंपोर्ट करते समय, sourceCompatibility विकल्प का इस्तेमाल IDE कोड असिस्ट और लिंटिंग के लिए डिफ़ॉल्ट तौर पर भी किया जाता है. ऐसा तब होता है, जब Java सोर्स लिखा जा रहा हो. Java भाषा की कुछ सुविधाओं के लिए, लाइब्रेरी की ज़रूरत होती है. ये सुविधाएं Android पर उपलब्ध नहीं हैं. compileSdk विकल्प से यह तय होता है कि कौनसी लाइब्रेरी उपलब्ध हैं. स्विच एक्सप्रेशन जैसी अन्य सुविधाओं के लिए, सिर्फ़ Java कंपाइलर की ज़रूरत होती है. ये सुविधाएं Android पर काम करती हैं.

Kotlin या Java सोर्स को कंपाइल करते समय, Java बाइनरी की किन सुविधाओं का इस्तेमाल किया जा सकता है?

targetCompatibility और jvmTarget प्रॉपर्टी से यह तय होता है कि कंपाइल किए गए Java और Kotlin सोर्स के लिए बाइटकोड जनरेट करते समय, Java क्लास-फ़ॉर्मैट के किस वर्शन का इस्तेमाल किया जाएगा.

Java में मिलती-जुलती सुविधाएं जोड़े जाने से पहले, Kotlin में कुछ सुविधाएं मौजूद थीं. शुरुआती Kotlin कंपाइलर को, Kotlin की उन सुविधाओं को दिखाने के लिए अपना तरीका बनाना पड़ा. इनमें से कुछ सुविधाओं को बाद में Java में जोड़ा गया. बाद के jvmTarget लेवल में, Kotlin कंपाइलर सीधे तौर पर Java की सुविधा का इस्तेमाल कर सकता है. इससे परफ़ॉर्मेंस बेहतर हो सकती है.

Android के अलग-अलग वर्शन पर, Java के अलग-अलग वर्शन काम करते हैं. targetCompatibility और jvmTarget को बढ़ाकर, Java की अतिरिक्त सुविधाओं का फ़ायदा लिया जा सकता है. हालांकि, ऐसा करने पर आपको Android SDK के कम से कम वर्शन को भी बढ़ाना पड़ सकता है, ताकि यह सुविधा उपलब्ध हो.

ध्यान दें कि targetCompatibility, sourceCompatibility से ज़्यादा या इसके बराबर होना चाहिए. आम तौर पर, sourceCompatibility, targetCompatibility, और jvmTarget के लिए एक ही वैल्यू का इस्तेमाल करना चाहिए. इन्हें इस तरह सेट किया जा सकता है:

Kotlin

android {
    compileOptions {
        sourceCompatibility = JavaVersion.VERSION_17
        targetCompatibility = JavaVersion.VERSION_17
    }
    kotlinOptions {
        jvmTarget = "17"
    }
}

Groovy

android {
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_17
        targetCompatibility JavaVersion.VERSION_17
    }
    kotlinOptions {
        jvmTarget '17'
    }
}

अगर इन प्रॉपर्टी के लिए कोई वैल्यू तय नहीं की जाती है, तो डिफ़ॉल्ट रूप से Java toolchain के वर्शन का इस्तेमाल किया जाता है. अगर Java टूलचेन का इस्तेमाल नहीं किया जा रहा है, तो डिफ़ॉल्ट वैल्यू अलग-अलग हो सकती हैं. इससे बिल्ड से जुड़ी समस्याएं हो सकती हैं. इसलिए, हमारा सुझाव है कि आप हमेशा इन वैल्यू को साफ़ तौर पर बताएं या Java टूलचेन का इस्तेमाल करें.