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

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

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

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

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

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

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

Driver SDK 6.0 या इसके बाद के वर्शन के लिए, AGP का कम से कम वर्शन

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

R8 का फ़ुल मोड

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

# settings.gradle
android.enableR8.fullMode=false

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

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