Android Consumer SDK 3.0 पर माइग्रेट करने से जुड़ी गाइड

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

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

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

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

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

Consumer SDK 3.0 के लिए, AGP 7.3 या इसके बाद के वर्शन का इस्तेमाल करना ज़रूरी है.

R8 का पूरा मोड

Consumer SDK टूल का वर्शन 3 और उससे पहले के वर्शन, फ़ुल R8 मोड के साथ काम नहीं करते. अगर आपका ऐप्लिकेशन AGP 8.0 और उसके बाद के वर्शन को टारगेट करता है, तो आपको साफ़ तौर पर Full R8 मोड को बंद करना होगा.

# settings.gradle
android.enableR8.fullMode=false

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

Kotlin, भाषा के पिछले तीन वर्शन के साथ काम करता है. इसका मतलब है कि अगर Consumer SDK के साथ Kotlin 1.7 या इसके बाद के वर्शन का इस्तेमाल किया जा रहा है, तो आपको Kotlin 2.0 पर अपग्रेड करने के लिए, सभी बदलावों को ठीक करने की ज़रूरत नहीं होगी. हालांकि, Kotlin के साथ काम करने की सुविधा, सिर्फ़ भाषा की उन सुविधाओं पर लागू होती है जो पूरी तरह से काम करती हैं. अगर 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 के साथ काम करने की गाइड में दिए गए हैं: