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

DriverStatusListener इंटरफ़ेस पर माइग्रेट करना

Driver v5 में, हमने DriverStatusListener के पक्ष में StatusListener इंटरफ़ेस को बंद करने का एलान किया था. इस साल, हम आधिकारिक तौर पर StatusListener इंटरफ़ेस को मिटा रहे हैं. नए इंटरफ़ेस पर माइग्रेट करने से जुड़ी गाइड के लिए, StatusListener बंद होना सेक्शन देखें.

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

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

Gradle और AGP के साथ काम करने की सुविधा

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

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

हमारा सुझाव है कि Driver SDK 6.0 के साथ AGP 7.3+ का इस्तेमाल करें.

फ़ुल R8 मोड

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

# settings.gradle
android.enableR8.fullMode=false

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

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