Kotlin के वर्शन के साथ काम करने की सुविधा और माइग्रेशन

इस पेज पर, Navigation SDK के साथ काम करने वाले Kotlin वर्शन के बारे में जानकारी दी गई है. साथ ही, नए वर्शन पर माइग्रेट करने के बारे में दिशा-निर्देश दिए गए हैं.

यहां दी गई टेबल में, Kotlin के वर्शन की ज़रूरी शर्तें बताई गई हैं. साथ ही, Navigation SDK के हाल ही के वर्शन के लिए, AGP और Gradle के सुझाए गए वर्शन दिए गए हैं.

Navigation SDK का वर्शन Kotlin का वर्शन (ज़रूरी है) Android Gradle प्लग इन (AGP) और Gradle के वर्शन (सुझाया गया)
6.2+ 2.1
  • AGP 8.7.3
  • Gradle 8.10.2
6.0 - 6.2 2.0
  • AGP 8.3.0
  • Gradle 8.4
5.1 - 5.99.1 1.9 हमारा सुझाव है कि AGP 7.3+ का इस्तेमाल करें. इसमें JDK-8272564 से जुड़ी समस्या को ठीक करने का तरीका बताया गया है.

Kotlin के वर्शन के साथ काम करने की सुविधा

Kotlin 2.1, Kotlin 2.0 के साथ काम करता है. इसका मतलब है कि अगर Navigation SDK के साथ Kotlin 2.0 का इस्तेमाल किया जा रहा है, तो आपको Kotlin 2.1 पर अपग्रेड करने का विकल्प मिलेगा. इसके लिए, आपको सभी बड़े बदलावों को ठीक करने की ज़रूरत नहीं होगी. हालांकि, यह सिर्फ़ भाषा की स्टेबल सुविधाओं पर लागू होता है. अगर Kotlin भाषा में ऐल्फ़ा, बीटा या एक्सपेरिमेंट के तौर पर उपलब्ध सुविधाओं का इस्तेमाल किया जा रहा है, तो अपग्रेड करते समय आपको कुछ और बदलाव करने पड़ सकते हैं.

बदलाव को आसान बनाना: Kotlin के साथ काम करने से जुड़े फ़्लैग

Kotlin, दो फ़्लैग उपलब्ध कराता है. इनसे, एपीआई में होने वाले बड़े बदलावों को सीमित करने में मदद मिलती है: https://kotlinlang.org/docs/compatibility-modes.html

भाषा-वर्शन X.Y

यह फ़्लैग, Kotlin के पिछले वर्शन के व्यवहार में हुए बड़े बदलावों को पहले जैसा कर देता है. उदाहरण के लिए, अगर Kotlin 2.0 का इस्तेमाल किया जा रहा है, तो [ - language-version 2.0] को सेट किया जा सकता है. इसके बाद, नए बड़े बदलाव लागू नहीं होंगे:

android {
   kotlinOptions {
       languageVersion = '2.0'
   }
}

api-version X.Y

apiVersion से नए Kotlin वर्शन के किसी एपीआई का इस्तेमाल करने पर, यह फ़्लैग Gradle बिल्ड की गड़बड़ी दिखाता है.

android {
   kotlinOptions {
       apiVersion = '2.0'
   }
}

ज़्यादा सटीक रणनीति

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

Kotlin के आने वाले समय में होने वाले अपग्रेड

Kotlin, हर छह महीने में एक नया वर्शन (यानी कि भाषा का नया वर्शन) रिलीज़ करता है. Google आम तौर पर, इसके एक से दो महीने बाद, अपने प्रॉडक्ट में डिफ़ॉल्ट रूप से नया वर्शन शामिल करता है. Kotlin के पिछले वर्शन में, ऐसे बदलाव शामिल किए गए थे जिनकी वजह से Navigation SDK के ग्राहकों को नए वर्शन पर अपग्रेड करना पड़ा था. इसलिए, हमारा सुझाव है कि Navigation SDK के नए वर्शन को अपनाने के बाद, हर छह महीने में Kotlin को अपग्रेड करने का प्लान बनाएं.