अगर Android 6.0 और उसके बाद के वर्शन के लिए, नेविगेशन SDK टूल का इस्तेमाल किया जा रहा है, तो आपको Kotlin 2.0 पर अपग्रेड करना होगा. इस पेज पर, Kotlin के नए वर्शन पर आसानी से ट्रांज़िशन करने के बारे में बताया गया है.
Gradle और AGP के साथ काम करना
Kotlin 2.0 में, Gradle और Android Gradle प्लग इन (AGP) के कम से कम और ज़्यादा से ज़्यादा वर्शन के लिए ज़रूरी शर्तें हैं. पक्का करें कि आपका प्रोजेक्ट, Kotlin 2.0 के लिए इन ज़रूरी शर्तों को पूरा करता हो.
Navigation SDK 6.0 और उसके बाद के वर्शन के लिए, AGP टूल का कम से कम वर्शन
हमारा सुझाव है कि आप Navigation SDK 6.0 के साथ AGP 8.3 का इस्तेमाल करें. हमने AGP 8.3 और Gradle 8.4 के साथ SDK टूल की पुष्टि कर ली है. साथ ही, यह SDK टूल R8 के फ़ुल मोड के साथ काम करता है.
Kotlin के वर्शन के साथ काम करने की सुविधा
Kotlin, भाषा के पिछले तीन वर्शन के साथ काम करता है. इसका मतलब है कि अगर आपने पहले से ही Navigation SDK के साथ Kotlin 1.7 या इसके बाद के वर्शन का इस्तेमाल शुरू कर दिया है, तो आपको Kotlin 2.0 पर अपग्रेड करने के लिए, उन सभी बदलावों को ठीक करने की ज़रूरत नहीं होगी जो ऐप्लिकेशन के काम करने के तरीके में बदलाव करते हैं. हालांकि, यह सिर्फ़ भाषा की उन सुविधाओं पर लागू होता है जो पूरी तरह से काम करती हैं. अगर Kotlin भाषा में, alpha, beta या एक्सपेरिमेंट के तौर पर उपलब्ध सुविधाओं का इस्तेमाल किया जा रहा है, तो हो सकता है कि अपग्रेड करते समय आपको कुछ और बदलाव करने पड़ें.
आसानी से ट्रांज़िशन करना: 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 के साथ काम करने की गाइड में दिए गए हैं: