Kotlin 2.0 पर माइग्रेट करना

अगर Android 6.0 और उसके बाद के वर्शन के लिए Navigation SDK टूल का इस्तेमाल किया जा रहा है, तो आपको Kotlin 2.0 पर अपग्रेड करना होगा. इस पेज पर, Kotlin के नए वर्शन पर आसानी से ट्रांज़िशन करने के बारे में बताया गया है.

Gradle और AGP के साथ काम करना

Kotlin 2.0 में, Gradle और Android Gradle प्लग इन (AGP) के कम से कम और ज़्यादा से ज़्यादा वर्शन के लिए ज़रूरी शर्तें हैं. पक्का करें कि आपका प्रोजेक्ट, Kotlin 2.0 के लिए इन ज़रूरी शर्तों को पूरा करता हो.

Navigation SDK 6.0 और उसके बाद के वर्शन के लिए, AGP का कम से कम वर्शन

हमारा सुझाव है कि नेविगेशन SDK 6.0 के साथ AGP 7.3+ का इस्तेमाल करें. हमने AGP 8.3 और Gradle 8.4 के साथ SDK टूल की पुष्टि कर ली है. साथ ही, यह SDK टूल R8 के फ़ुल मोड के साथ काम करता है.

Kotlin वर्शन के साथ काम करता है

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

आसानी से ट्रांज़िशन करना: Kotlin के साथ काम करने की सुविधा के फ़्लैग

जैसा कि पिछले सेक्शन में बताया गया है, अपग्रेड करते समय Kotlin में भाषा के पिछले तीन तक ही वर्शन काम करते हैं. Kotlin ब्रेकिंग बदलावों को सीमित करने में मदद के लिए, दो फ़्लैग लागू करता है:

language-version X.Y

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

android {
   kotlinOptions {
       languageVersion = '1.7'
   }
}

api-version X.Y

यह फ़्लैग, Kotlin 2.0 को शामिल करने के लिए, डिपेंडेंट डाउनस्ट्रीम कोड के तैयार होने से पहले, नए एपीआई के इस्तेमाल पर रोक लगाता है.

android {
   kotlinOptions {
       apiVersion = '1.7'
   }
}

टारगेट करने का ज़्यादा सटीक तरीका

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