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 Plugin (AGP) के वर्शन की कम से कम और ज़्यादा से ज़्यादा ज़रूरी शर्तें हैं. पक्का करें कि आपका प्रोजेक्ट, Kotlin 2.0 की इन ज़रूरी शर्तों को पूरा करता हो.

Consumer SDK 3.0+ के लिए AGP का कम से कम वर्शन

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

फ़ुल R8 मोड

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