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

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

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

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

अगर Android 6.0 और उसके बाद के वर्शन के लिए Driver SDK टूल का इस्तेमाल किया जा रहा है, तो आपको 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 या इसके बाद के वर्शन को टारगेट करता है, तो आपको साफ़ तौर पर Full R8 मोड को बंद करना होगा.

# settings.gradle
android.enableR8.fullMode=false

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

Kotlin, भाषा के पिछले तीन वर्शन के साथ काम करता है. इसका मतलब है कि अगर Driver SDK के साथ Kotlin 1.7 या इसके बाद के वर्शन का इस्तेमाल किया जा रहा है, तो आपको Kotlin 2.0 पर अपग्रेड करने के लिए, सभी बदलावों को ठीक करने की ज़रूरत नहीं होगी. हालांकि, Kotlin के साथ काम करने की सुविधा, सिर्फ़ भाषा की उन सुविधाओं पर लागू होती है जो पूरी तरह से काम करती हैं. अगर Kotlin भाषा में, alpha, beta या एक्सपेरिमेंट के तौर पर उपलब्ध सुविधाओं का इस्तेमाल किया जा रहा है, तो हो सकता है कि अपग्रेड करते समय आपको कुछ और बदलाव करने पड़ें.

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 के साथ काम करने की गाइड में दिए गए हैं: