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 v3 और इससे पहले के वर्शन में, R8 के फ़ुल मोड का इस्तेमाल नहीं किया जा सकता. अगर आपका ऐप्लिकेशन AGP 8.0+ को टारगेट करता है, तो आपको फुल R8 मोड को साफ़ तौर पर बंद करना होगा.

# settings.gradle
android.enableR8.fullMode=false

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

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

Kotlin के साथ काम करने से जुड़ी समस्याओं के फ़्लैग

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

भाषा-वर्शन 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, हर वर्शन के लिए कंपैटिबिलिटी गाइड में, बड़े बदलावों की सूची और उन फ़्लैग के बारे में जानकारी देता है जिन्हें सेट करके, ओरिजनल वर्शन के व्यवहार को बनाए रखा जा सकता है: