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

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

अगर Consumer SDK for Android 3.0 या इसके बाद के वर्शन का इस्तेमाल किया जा रहा है, तो आपको 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, बड़े बदलावों को सीमित करने में मदद करने के लिए दो फ़्लैग उपलब्ध कराता है:

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