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

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

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

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

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

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

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

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

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

R8 का फ़ुल मोड

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