ย้ายข้อมูลไปใช้ Kotlin Extensions (KTX) API ในโมดูลหลัก

Firebase กำลังเพิ่มความมุ่งมั่นในการสนับสนุน Kotlin และเรากำลังทำงานเพื่อปรับปรุงระบบนิเวศ Android ให้ทันสมัย เพื่อให้ Kotlin เข้าถึงได้ง่ายขึ้นและใช้งานง่ายกับ Firebase

เราจึงทำการเปลี่ยนแปลงเล็กน้อยกับ Firebase SDK สำหรับ Android เพื่อให้ทันสมัยยิ่งขึ้น หน้านี้อธิบายข้อมูลสำคัญเกี่ยวกับการเปลี่ยนแปลงนี้ ซึ่งรวมถึง

• มีอะไรเปลี่ยนแปลงบ้าง
• เหตุผลที่เราทำการเปลี่ยนแปลงนี้
• วันที่สำคัญสำหรับการเปลี่ยนแปลงนี้
• วิธีย้ายข้อมูลไปใช้ KTX API จากโมดูลหลัก

ดูวิธีย้ายข้อมูลแอป

สิ่งที่จะเปลี่ยนแปลง

เราได้เพิ่ม API ของส่วนขยาย Kotlin (KTX) ลงในโมดูลหลักที่เกี่ยวข้อง เช่น ระบบได้เพิ่ม API ทั้งหมดจาก firebase-perf-ktx ลงใน firebase-perf ภายใต้แพ็กเกจ com.google.firebase.perf

การเปลี่ยนแปลงนี้หมายความว่านักพัฒนาแอป Kotlin สามารถใช้โมดูลหลักแทนโมดูล KTX ได้แล้ว (เมื่อใช้ Firebase BoM v32.5.0 ขึ้นไปหรือเวอร์ชันโมดูลหลักที่ระบุไว้ใน BoM v32.5.0 ขึ้นไป)

ในเดือนกรกฎาคม 2025 เราได้หยุดเผยแพร่โมดูล KTX เวอร์ชันใหม่และนำไลบรารี KTX ออกจาก Firebase Android BoM (v34.0.0)

เพราะเหตุใดเราจึงทำการเปลี่ยนแปลงนี้

Firebase มุ่งมั่นที่จะสร้างระบบนิเวศแบบ Kotlin-first สำหรับนักพัฒนาแอป Android การปรับปรุงบรรจุภัณฑ์นี้มีข้อดีดังนี้

• การจัดการการขึ้นต่อกันที่ง่ายขึ้น: ตอนนี้คุณต้องขึ้นต่อกันกับโมดูลเดียวเท่านั้น จึงไม่จำเป็นต้องสลับระหว่างโมดูลหลักกับส่วนขยาย Kotlin หรือขึ้นต่อกันกับทั้ง 2 โมดูล

• การรองรับ Kotlin ที่ดียิ่งขึ้น: ตอนนี้ Firebase SDK ทั้งหมดสำหรับ Android จะรองรับ Kotlin ได้ดียิ่งขึ้น เราจะรวมฟีเจอร์ใหม่ๆ ที่รองรับ Kotlin ทั้งหมดไว้ในโมดูลหลักโดยตรง

วันที่สำคัญสำหรับการเปลี่ยนแปลงนี้

ในเดือนตุลาคม 2023

ในเดือนตุลาคม 2023 เราได้เพิ่ม API ของส่วนขยาย Kotlin (KTX) ลงในโมดูลหลักที่เกี่ยวข้อง ซึ่งหมายความว่าตอนนี้คุณสามารถใช้ API ของ KTX จากโมดูลหลักได้โดยตรงเมื่อใช้ Firebase BoM v32.5.0 ขึ้นไปหรือ โมดูลหลักเวอร์ชันที่ระบุไว้ใน BoM v32.5.0 ขึ้นไป

ในขณะเดียวกัน เราได้เลิกใช้งาน Kotlin Extension (KTX) API ในโมดูล KTX (ดูบันทึกประจำรุ่นที่อธิบายการเปลี่ยนแปลงนี้) ในระยะที่เลิกใช้งาน API ที่เลิกใช้งานในโมดูล KTX จะยังคงทำงานและได้รับการบำรุงรักษาต่อไป

ในเดือนกรกฎาคม 2025

ในเดือนกรกฎาคม 2025 เราได้หยุดเผยแพร่โมดูล KTX เวอร์ชันใหม่ และนำโมดูล KTX ออกจาก Firebase BoM (เริ่มตั้งแต่ BoM v34.0.0)

KTX โมดูลหรือ BoM เวอร์ชันที่เผยแพร่ก่อนหน้านี้จะยังคง ทํางานได้ต่อไป แต่ตอนนี้อยู่ในสถานะสิ้นสุดการบํารุงรักษาแล้ว ซึ่งหมายความว่าเราจะไม่เพิ่มการแก้ไขข้อบกพร่อง การเปลี่ยนแปลงที่เข้ากันได้แบบย้อนหลัง หรือ ฟีเจอร์ใหม่ๆ ลงในโมดูล KTX แต่การพัฒนา Firebase ใน Android ทั้งหมดในอนาคตจะดำเนินการในโมดูลหลักเท่านั้น (ทั้งสำหรับ Java และ Kotlin)

วิธีย้ายข้อมูลไปใช้ KTX API จากโมดูลหลัก

หากคุณใช้ API ของส่วนขยาย Kotlin (KTX) ให้อัปเดตแอปดังนี้ เพื่อเริ่มใช้ API จากโมดูลหลักแทนโมดูล KTX

1. แก้ไขทรัพยากร Dependency ของ Gradle ให้ใช้โมดูลหลักแทนโมดูล KTX เช่น หากคุณใช้ Firebase Android BoM (แนะนำ)

   ก่อน

   dependencies {
     // ...
   
     // Import the Firebase BoM
     implementation(platform("com.google.firebase:firebase-bom:34.0.0"))
   
     // Using KTX libraries for Authentication and Cloud Firestore
     implementation("com.google.firebase:firebase-auth-ktx")
     implementation("com.google.firebase:firebase-firestore-ktx")
   }

   หลังจาก

   dependencies {
     // ...
   
     // Import the Firebase BoM as usual
     // Make sure to use Firebase BoM v32.5.0 or higher
     implementation(platform("com.google.firebase:firebase-bom:34.0.0"))
   
     // No need to use the KTX libraries; everything is now in the main module
     implementation("com.google.firebase:firebase-auth")
     implementation("com.google.firebase:firebase-firestore")
   }

   หากไม่ได้ใช้ Firebase Android BoM

   ก่อน

   dependencies {
     // ...
   
     // Using KTX libraries for Authentication and Cloud Firestore
     implementation("com.google.firebase:firebase-auth-ktx:23.2.1")
     implementation("com.google.firebase:firebase-firestore-ktx:25.1.4")
   }

   หลังจาก

   dependencies {
     // ...
   
     // No need to use the KTX libraries, everything is now in the main module
     // Make sure to use a version listed in Firebase BoM v32.5.0 or higher
     implementation("com.google.firebase:firebase-auth:24.0.0")
     implementation("com.google.firebase:firebase-firestore:26.0.0")
   }

   
   

2. อัปเดตรหัสเพื่อแทนที่ API ของ KTX ทั้งหมดด้วย API ที่ย้ายตำแหน่งในโมดูลหลักภายใต้แพ็กเกจ com.google.firebase

   ก่อน

   import com.google.firebase.auth.ktx.auth
   import com.google.firebase.firestore.ktx.firestore
   import com.google.firebase.firestore.ktx.toObject
   import com.google.firebase.ktx.Firebase

   หลังจาก

   import com.google.firebase.auth.auth
   import com.google.firebase.firestore.firestore
   import com.google.firebase.firestore.toObject
   import com.google.firebase.Firebase