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

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

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

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

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

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

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

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

การเปลี่ยนแปลงนี้ทำให้ API ส่วนขยายของ Kotlin (KTX) ในทุกโมดูลของ KTX เลิกใช้งานแล้ว เราจะเลิกเปิดตัวโมดูล KTX ตั้งแต่เดือนเมษายน 2024 เป็นต้นไป และ เราจะนำไลบรารี KTX ออกจาก Firebase Android BoM ในขณะนั้นด้วย

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

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

Firebase มุ่งมั่นที่จะ Kotlin เป็นหลัก สำหรับนักพัฒนาแอป Android การปรับแพ็กเกจให้ทันสมัยนี้มอบ ข้อดีดังต่อไปนี้

การจัดการทรัพยากร Dependency ที่ง่ายขึ้น: ตอนนี้คุณจะต้องใช้เพียงรายเดียวเท่านั้น โดยไม่จำเป็นต้องสลับไปมาระหว่างโมดูลหลักและโค้ด Kotlin ส่วนขยาย หรือขึ้นอยู่กับทั้ง 2 อย่าง
การรองรับ Kotlin ที่เพิ่มประสิทธิภาพ: Firebase SDK ทั้งหมดสำหรับ Android ให้การสนับสนุน Kotlin ได้ดีขึ้น เราจะรวมแอปใหม่สำหรับ Kotlin คุณลักษณะได้โดยตรงในโมดูลหลักของเรา

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

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

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

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

ตั้งแต่ต้นเดือนเมษายน 2024 เป็นต้นไป

เราจะหยุดเผยแพร่โมดูล KTX เวอร์ชันใหม่ และเราจะนำ โมดูล KTX จาก Firebase BoM

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

วิธีย้ายข้อมูลเพื่อใช้ KTX API จากโมดูลหลัก

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

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

ก่อน

dependencies {
  // ...

  // Import the Firebase BoM
  implementation(platform("com.google.firebase:firebase-bom:33.1.2"))

  // 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:33.1.2"))

  // 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.0.0")
  implementation("com.google.firebase:firebase-firestore-ktx:25.0.0")
}

หลัง

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:23.0.0")
  implementation("com.google.firebase:firebase-firestore:25.0.0")
}

อัปเดตโค้ดเพื่อแทนที่ KTX API ทั้งหมดด้วย 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