คู่มือการย้ายข้อมูล Android Driver SDK 6.0

ย้ายข้อมูลไปยังอินเทอร์เฟซ DriverStatusListener

ใน Driver v5 เราได้ประกาศการเลิกใช้งานอินเทอร์เฟซ StatusListener เพื่อเปลี่ยนไปใช้ DriverStatusListener ปีนี้เราจะลบStatusListenerอินเทอร์เฟซอย่างเป็นทางการ ดูคำแนะนำในการย้ายข้อมูลไปยังอินเทอร์เฟซใหม่ได้ที่StatusListener การเลิกใช้งาน

ย้ายข้อมูลไปยัง Kotlin 2.0

หากใช้ Driver SDK สำหรับ Android 6.0 ขึ้นไป คุณต้องอัปเกรดเป็น Kotlin 2.0 หน้านี้มีคำแนะนำเพื่อช่วยให้การเปลี่ยนไปใช้ Kotlin เวอร์ชันใหม่เป็นไปอย่างราบรื่น

ความเข้ากันได้ของ Gradle และ AGP

Kotlin 2.0 มีข้อกำหนดสำหรับเวอร์ชันขั้นต่ำและสูงสุดสำหรับเวอร์ชัน Gradle และปลั๊กอิน Android Gradle (AGP) ตรวจสอบว่าโปรเจ็กต์เป็นไปตามข้อกำหนดเหล่านี้สำหรับ Kotlin 2.0

เวอร์ชันขั้นต่ำของ AGP สำหรับ Driver SDK 6.0 ขึ้นไป

เราขอแนะนำให้ใช้ AGP 7.3 ขึ้นไปกับ Driver SDK 6.0

โหมด R8 เต็มรูปแบบ

Driver SDK เวอร์ชัน 6 และต่ำกว่าไม่รองรับโหมด R8 แบบเต็ม คุณต้องปิดใช้โหมด R8 เต็มรูปแบบอย่างชัดเจนหากแอปพลิเคชันกำหนดเป้าหมายเป็น AGP 8.0 ขึ้นไป

# settings.gradle
android.enableR8.fullMode=false

ความเข้ากันได้ของเวอร์ชัน Kotlin

Kotlin รองรับความเข้ากันได้แบบย้อนหลังกับภาษา 3 เวอร์ชันก่อนหน้า ซึ่งหมายความว่าหากคุณใช้ Kotlin 1.7 ขึ้นไปกับ Driver SDK อยู่แล้ว คุณ ควรจะอัปเกรดเป็น Kotlin 2.0 ได้โดยไม่ต้องแก้ไขการเปลี่ยนแปลงที่ทำให้เกิดข้อขัดข้องทั้งหมด อย่างไรก็ตาม ความเข้ากันได้ของ Kotlin จะใช้ได้กับฟีเจอร์ภาษาที่เสถียรเท่านั้น หากคุณใช้ฟีเจอร์เวอร์ชันอัลฟ่า เบต้า หรือเวอร์ชันทดลองในภาษา Kotlin คุณอาจต้องทำการเปลี่ยนแปลงเพิ่มเติมเมื่ออัปเกรด

Flag ความเข้ากันได้ของ Kotlin

ดังที่ระบุไว้ในส่วนก่อนหน้า Kotlin รองรับภาษาเวอร์ชันก่อนหน้าสูงสุด 3 เวอร์ชันเมื่ออัปเกรด Kotlin มีแฟล็ก 2 รายการเพื่อช่วยจำกัดการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบ ดังนี้

language-version X.Y

โดยแฟล็กนี้จะเปลี่ยนการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบกลับไปเป็นลักษณะการทำงานของ Kotlin เวอร์ชันก่อนหน้า ตัวอย่างเช่น หากคุณใช้ Kotlin 1.7 คุณสามารถระบุ [ - language-version 1.7] และการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบใหม่จะไม่ส่งผลอีกต่อไป

android {
   kotlinOptions {
       languageVersion = '1.7'
   }
}
api-version X.Y

โดยแฟล็กนี้จะป้องกันไม่ให้มีการใช้ API ใหม่ก่อนที่โค้ดดาวน์สตรีมที่ขึ้นต่อกันจะพร้อมรวม Kotlin 2.0 

android {
   kotlinOptions {
       apiVersion = '1.7'
   }
}

แนวทางที่ตรงเป้าหมายมากขึ้น

นอกจากการใช้แฟล็กความเข้ากันได้ของ Kotlin แล้ว เราขอแนะนำให้อ่านบันทึกประจำรุ่นของ Kotlin และเลือกพฤติกรรมที่ต้องการคงไว้จากเวอร์ชันที่คุณอัปเกรด Kotlin มีรายการการเปลี่ยนแปลงที่ทำให้เกิดข้อขัดข้องและค่าสถานะที่ตั้งค่าเพื่อคงลักษณะการทำงานเดิมไว้ในคู่มือความเข้ากันได้สำหรับแต่ละเวอร์ชัน