Google आपकी पसंदीदा भाषा में कॉन्टेंट का अनुवाद करने के लिए, एआई टेक्नोलॉजी का इस्तेमाल करता है. एआई से मिले अनुवादों में गलतियां हो सकती हैं.

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

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

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

Gradle और एजीपी के साथ काम करने की सुविधा

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

Consumer SDK 3.0 और इसके बाद के वर्शन के लिए, एजीपी का कम से कम वर्शन

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