หน้านี้ได้รับการแปลโดย Cloud Translation API

ทำความเข้าใจ Firebase สำหรับ Android

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

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

ปลั๊กอิน Firebase Assistant สำหรับ Android Studio

Firebase Assistant เป็นปลั๊กอิน Android Studio ที่ลงทะเบียนแอป Android กับโปรเจ็กต์ Firebase และเพิ่มไฟล์กำหนดค่า ปลั๊กอิน และทรัพยากร Dependency ที่จำเป็นของ Firebase ลงในโปรเจ็กต์ Android ทั้งหมดนี้ทำได้จากภายใน Android Studio

ทำตามวิธีการในหน้าเริ่มต้นใช้งาน Android เพื่อใช้ Firebase Assistant ตรวจสอบว่าคุณใช้ Android Studio และ Firebase Assistant เวอร์ชันล่าสุด (ไปที่ไฟล์ > ตรวจหาการอัปเดต)

เมื่อคุณเลือกผลิตภัณฑ์ Firebase ที่เฉพาะเจาะจงเพื่อเพิ่มลงในแอป Firebase Assistant จะประกาศทรัพยากร Dependency ที่จำเป็นในไฟล์ app/build.gradle โดยอัตโนมัติ โปรดทราบว่าหากต้องการใช้ Firebase Android BoM (แนะนำ) ให้อัปเดตทรัพยากร Dependency ในไฟล์ Gradle ระดับโมดูล (ระดับแอป) (โดยปกติคือ app/build.gradle) เพื่อนำเข้าแพลตฟอร์ม BoM นอกจากนี้ คุณยังต้องนำเวอร์ชันออกจากบรรทัดการอ้างอิงไลบรารี Firebase แต่ละบรรทัดด้วย

นอกจากนี้ หากต้องการใช้ผลิตภัณฑ์ Firebase บางอย่าง คุณต้องเปิดใช้ API หรือจัดสรรทรัพยากรภายนอก Android Studio วิธีการสำหรับแต่ละผลิตภัณฑ์ในผู้ช่วย Firebase จะอธิบายการดำเนินการเพิ่มเติมที่คุณต้องทำ เช่น หากต้องการใช้ Cloud Firestore คุณต้องตั้งค่าฐานข้อมูลและกฎในคอนโซล Firebase

บริการของ Google - ปลั๊กอินและไฟล์การกำหนดค่า

ในขั้นตอนการเพิ่ม Firebase ลงในโปรเจ็กต์ Android คุณต้องเพิ่ม google-servicesปลั๊กอินและgoogle-services.jsonไฟล์กำหนดค่าลงใน โปรเจ็กต์

หากเพิ่ม Firebase ลงในโปรเจ็กต์ Android ผ่าน Firebase คอนโซล REST API การจัดการ หรือ Firebase CLI คุณต้องเพิ่มปลั๊กอินและไฟล์กำหนดค่าลงในโปรเจ็กต์ด้วยตนเอง อย่างไรก็ตาม หากคุณใช้ผู้ช่วย Firebase ระบบจะ ดําเนินการเหล่านี้ให้คุณโดยอัตโนมัติในระหว่างการตั้งค่า

ไปที่เอกสารประกอบของ Android เพื่อดูวิธีที่ปลั๊กอินบริการของ Google และไฟล์กำหนดค่าทำงานร่วมกัน

Firebase Android BoM (Bill of Materials)

Firebase Android BoM (Bill of Materials) ช่วยให้คุณจัดการไลบรารี Firebase ทุกเวอร์ชันได้โดยการระบุเพียงเวอร์ชันเดียว นั่นคือเวอร์ชันของ BoM

เมื่อคุณใช้ Firebase BoM ในแอป BoM จะดึง เวอร์ชันไลบรารีแต่ละเวอร์ชันที่แมปกับเวอร์ชันของ BoM โดยอัตโนมัติ ไลบรารีแต่ละเวอร์ชันจะใช้งานร่วมกันได้ เมื่ออัปเดตเวอร์ชันของ BoM ในแอป ไลบรารี Firebase ทั้งหมดที่คุณใช้ในแอปจะอัปเดตเป็นเวอร์ชันที่แมปกับ BoM เวอร์ชันนั้น

หากต้องการทราบว่าไลบรารี Firebase เวอร์ชันใดที่แมปกับBoMเวอร์ชันใด ให้ดูบันทึกประจำรุ่นของBoMเวอร์ชันนั้น หากต้องการเปรียบเทียบเวอร์ชันไลบรารีที่แมปกับเวอร์ชันหนึ่ง BoMกับอีกเวอร์ชันหนึ่งBoM ให้ใช้วิดเจ็ตการเปรียบเทียบด้านล่าง

ดูข้อมูลเพิ่มเติมเกี่ยวกับการรองรับแพลตฟอร์ม BoM ของ Gradle

วิธีใช้ Firebase Android BoM เพื่อประกาศทรัพยากร Dependency ในไฟล์ Gradle ของโมดูล (ระดับแอป) (โดยปกติคือ app/build.gradle) เมื่อใช้ BoM คุณไม่ต้องระบุเวอร์ชันของไลบรารีแต่ละรายการในบรรทัดทรัพยากร Dependency

dependencies {
  // Import the BoM for the Firebase platform
  implementation platform('com.google.firebase:firebase-bom:34.0.0')

  // Declare the dependencies for the desired Firebase products without specifying versions
  // For example, declare the dependencies for Firebase Authentication and Cloud Firestore
  implementation 'com.google.firebase:firebase-auth'
  implementation 'com.google.firebase:firebase-firestore'
}

คำถามที่พบบ่อยเกี่ยวกับการใช้ Firebase Android BoM มีดังนี้

ฉันจะใช้ไลบรารีเวอร์ชันที่แตกต่างจากที่ระบุไว้ใน BoM ได้อย่างไร

วิธีลบล้างเวอร์ชันไลบรารีที่กำหนดไว้ใน BoM มีดังนี้

คงบรรทัดไว้เพื่อนำเข้าแพลตฟอร์ม BoM

ในบรรทัดการอ้างอิงของไลบรารี ให้ระบุเวอร์ชันไลบรารีที่ต้องการ ตัวอย่างเช่น วิธีประกาศการขึ้นต่อกันหากต้องการใช้ v18.0.0 ของ App Indexing ไม่ว่าเวอร์ชันใดจะกำหนดไว้ใน BoM แต่คุณต้องการใช้เวอร์ชันของ BoM สำหรับ Authentication และ Cloud Firestore

dependencies {
  // Import the BoM for the Firebase platform
  implementation platform('com.google.firebase:firebase-bom:34.0.0')

  // Declare the dependency for the App Indexing library and specify a version
  // This specified library version overrides the version designated in the BoM.
  implementation 'com.google.firebase:firebase-appindexing:18.0.0'

  // Declare the dependencies for the other Firebase libraries without specifying versions
  // These libraries will use the versions designated in the BoM.
  implementation 'com.google.firebase:firebase-auth'
  implementation 'com.google.firebase:firebase-firestore'
}

BoM จะเพิ่มไลบรารี Firebase ทั้งหมดลงในแอปของฉันโดยอัตโนมัติไหม

ไม่ได้ หากต้องการเพิ่มและใช้ไลบรารี Firebase ในแอปจริง คุณต้องประกาศ แต่ละไลบรารีเป็นบรรทัดทรัพยากร Dependency แยกต่างหากในไฟล์ Gradle ของโมดูล (ระดับแอป) (โดยปกติคือ app/build.gradle)

การใช้ BoM จะช่วยให้มั่นใจได้ว่าเวอร์ชันของไลบรารี Firebase ใดๆ ในแอปของคุณจะเข้ากันได้ แต่ BoM ไม่ได้เพิ่มไลบรารี Firebase เหล่านั้นลงในแอปของคุณจริงๆ

BoM รองรับไลบรารีส่วนขยาย Kotlin (KTX) ของ Firebase ไหม

ในเดือนกรกฎาคม 2025 (BoM v34.0.0) เราได้นำไลบรารีส่วนขยาย Kotlin (KTX) ของ Firebase ออกจาก BoM หากคุณใช้ BoM เวอร์ชันเก่ากว่า v34.0.0 คุณจะใช้ไลบรารี KTX ในแอปต่อไปได้

อย่างไรก็ตาม เราขอแนะนำให้คุณย้ายข้อมูลแอปไปใช้ KTX API จากโมดูลหลัก มิฉะนั้น คุณจะอัปเดตเป็น BoM เวอร์ชันใหม่กว่าไม่ได้ และ ดังนั้นจึงจะใช้ไลบรารีผลิตภัณฑ์ Firebase เวอร์ชันใหม่กว่าไม่ได้ด้วย โปรดดูรายละเอียดในคำถามที่พบบ่อยเกี่ยวกับโครงการนี้

ฉันใช้ BoM เพื่อเพิ่มไลบรารี Android ที่ไม่ได้มาจาก Firebase ได้ไหม

ไม่ได้ Firebase Android BoM จะจัดการเวอร์ชันไลบรารีสำหรับไลบรารี Firebase เท่านั้น

เหตุใด BoM จึงเป็นวิธีที่แนะนำในการจัดการเวอร์ชันของไลบรารี Firebase

แม้ว่าไลบรารี Firebase แต่ละรายการจะมีเวอร์ชันแยกกัน แต่เราก็สร้างไลบรารีเหล่านี้ร่วมกันเพื่อให้มั่นใจว่าไลบรารีแต่ละรายการเวอร์ชันล่าสุดจะใช้งานร่วมกับไลบรารีอื่นๆ ได้

การใช้ BoM เพื่อจัดการเวอร์ชันไลบรารี Firebase ของแอปจะช่วยให้คุณไม่ต้อง ติดตามว่าไลบรารี Firebase เวอร์ชันใดที่เข้ากันได้กับไลบรารี Firebase อื่น

แม้ว่าตอนนี้คุณจะใช้ไลบรารี Firebase เพียงรายการเดียวในแอป แต่เรายังคง แนะนําให้ใช้ BoM เนื่องจากคุณไม่รู้ว่าเมื่อใดที่อาจต้องการใช้ ไลบรารี Firebase อื่น

แอปของฉันใช้ Gradle เวอร์ชันเก่ากว่า 5.0 ฉันจะยังใช้ BoM ได้ไหม

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

เพิ่ม enableFeaturePreview('IMPROVED_POM_SUPPORT')ลงในไฟล์ settings.gradle

ในไฟล์ Gradle ของโมดูล (ระดับแอป) (โดยปกติคือ app/build.gradle) ให้นำเข้า BoM เหมือนคลังปกติ (ไม่มีตัวแก้ไข platform) ดังนี้

dependencies {
  // Import the Firebase BoM
  implementation 'com.google.firebase:firebase-bom:34.0.0'

  // Declare the dependencies for the desired Firebase products, without specifying versions
  // For example, declare the dependencies for Firebase Authentication and Cloud Firestore
  implementation 'com.google.firebase:firebase-auth'
  implementation 'com.google.firebase:firebase-firestore'
}

ฉันจะรายงานปัญหาหรือแสดงความคิดเห็นเกี่ยวกับ BoM ได้อย่างไร

ไปที่ที่เก็บ Firebase Android SDK บน GitHub

เปรียบเทียบเวอร์ชัน Firebase BoM

โมดูลไลบรารีส่วนขยาย Kotlin (KTX)

เราได้เพิ่ม 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)

หากคุณใช้ KTX API จากโมดูล KTX ที่เผยแพร่ก่อนหน้านี้ เราขอแนะนำให้ย้ายข้อมูลแอปไปใช้ KTX API จากโมดูลหลักแทน ดูรายละเอียดได้ที่ คำถามที่พบบ่อยเกี่ยวกับโครงการนี้

โมดูลฟีเจอร์และการนำส่งฟีเจอร์ Play

ตั้งแต่เดือนพฤษภาคม 2021 (Firebase BoM v28.0.0) เป็นต้นมา คุณสามารถใช้ Firebase Android SDK ในโมดูลฟีเจอร์แบบไดนามิกซึ่งติดตั้งแยกต่างหากจากโมดูลแอปพลิเคชันฐานได้

หากต้องการเปิดใช้การรองรับโมดูลฟีเจอร์แบบไดนามิก ให้เพิ่มการขึ้นต่อกันต่อไปนี้ ลงในไฟล์ build.gradle ของโมดูลฐาน

dependencies {
  implementation 'com.google.firebase:firebase-dynamic-module-support:16.0.0-beta04'
}

ตอนนี้คุณได้เพิ่มการรองรับโมดูลแบบไดนามิกแล้ว คุณสามารถเพิ่มการอ้างอิง Firebase SDK (มีหรือไม่มี Firebase BoM) ลงในโมดูลฟีเจอร์ของ แอป และใช้ได้ตามปกติ

เช่น หากแอปพลิเคชันของคุณใช้ Realtime Database เพื่อขับเคลื่อนฟีเจอร์เรียลไทม์ที่เฉพาะเจาะจง คุณสามารถเพิ่มการอ้างอิง firebase-database ไปยัง build.gradle ของโมดูลฟีเจอร์แทนที่จะเป็นโมดูลฐานได้ ซึ่งจะช่วยลดขนาดการดาวน์โหลด สำหรับผู้ใช้ส่วนใหญ่

โปรดทราบข้อควรระวังต่อไปนี้เมื่อใช้ Firebase SDK ในโมดูลฟีเจอร์

ผลิตภัณฑ์ เช่น Dynamic Links หรือ Firebase In-App Messaging ซึ่งอาศัยเหตุการณ์ Analytics first_open อาจพลาดเหตุการณ์นี้เมื่อใช้ในโมดูลฟีเจอร์แบบไดนามิก
เมื่อใช้ Cloud Firestore และ Authentication ร่วมกัน คุณควรใส่ทั้ง 2 อย่างไว้ในโมดูลเดียวกันเสมอ หากทำไม่ได้ ให้ตรวจสอบว่าได้โหลด Authentication ก่อน Cloud Firestore แล้ว ไม่เช่นนั้นการดำเนินการ Cloud Firestore บางอย่างอาจมีสถานะการตรวจสอบสิทธิ์ที่ไม่ถูกต้อง
เมื่อใช้ firebase-crashlytics-ndk เป็นการขึ้นต่อกันของโมดูลฟีเจอร์แบบไดนามิก คุณต้องตั้งค่าพร็อพเพอร์ตี้ unstrippedNativeLibsDir ในไฟล์ build.gradle ของแอปตามที่อธิบายไว้ในเอกสารประกอบเกี่ยวกับ Crashlytics NDK

ดูข้อมูลเพิ่มเติมเกี่ยวกับโมดูลฟีเจอร์และการนำส่งฟีเจอร์ Play ได้ที่ภาพรวมของการนำส่งฟีเจอร์ Play

ปลั๊กอิน Gradle ของบริการ Google เทียบกับบริการ Google Play เทียบกับ Google Play Store

ระบบนิเวศของ Google, Firebase และ Android หลายส่วนมี รูปแบบการตั้งชื่อที่คล้ายกัน คำอธิบายสั้นๆ สำหรับแต่ละรายการมีดังนี้

ปลั๊กอิน Gradle ของบริการของ Google: ปลั๊กอิน Gradle (com.google.gms.google-services) ที่ทำงานในเวลาบิลด์เพื่อ ตรวจสอบว่าแอปมีการกำหนดค่าที่ถูกต้องในการเข้าถึง Firebase และ Google APIs; แม้ว่าชื่อจะคล้ายกัน แต่ปลั๊กอินนี้ไม่มีความเกี่ยวข้องกับบริการ Google Play (ดู รายการถัดไป) และไม่มีผลต่อความสามารถของแอปในขณะรันไทม์; ปลั๊กอินนี้ยังประมวลผลไฟล์ google-services.json ที่คุณเพิ่มลงใน แอปของคุณด้วย ซึ่งเป็นส่วนหนึ่งของการตั้งค่า Firebase ดูข้อมูลเพิ่มเติมเกี่ยวกับปลั๊กอิน Gradle ของบริการ Google
บริการ Google Play: บริการเบื้องหลังที่มองไม่เห็นซึ่งทำงานในอุปกรณ์ Android และมี API ทั่วไปของ Google หลายรายการ (เช่น Google Maps และ Google Sign In) ให้กับแอปใน อุปกรณ์; การรวม API ทั่วไปเหล่านี้ไว้ในบริการเดียวจะช่วยลดขนาด ของแอปอื่นๆ และช่วยให้อุปกรณ์ได้รับการอัปเดตความปลอดภัยอัตโนมัติและ การปรับปรุงฟีเจอร์โดยไม่ต้องอัปเดตระบบปฏิบัติการ ดูข้อมูลเพิ่มเติมเกี่ยวกับบริการ Google Play
Google Play Store: ร้านค้าสำหรับดาวน์โหลดแอป ภาพยนตร์ หนังสือ และอื่นๆ ในอุปกรณ์ Android; ในฐานะนักพัฒนาแอป คุณจะจัดการการจัดจำหน่าย รุ่น ฯลฯ สำหรับแอปผ่าน Google Play Console หากอุปกรณ์มี Google Play Store แสดงว่าอุปกรณ์นั้น ใช้บริการ Google Play ด้วย (ดูรายการก่อนหน้า) ดูข้อมูลเพิ่มเติมเกี่ยวกับ Google Play Store สำหรับนักพัฒนาแอป
บริการเกมของ Google Play: ชุด API สำหรับนักพัฒนาเกมบนอุปกรณ์เคลื่อนที่; ดูข้อมูลเพิ่มเติมเกี่ยวกับ บริการเกมของ Google Play และวิธี ผสานรวม Firebase กับโปรเจ็กต์บริการเกมของ Google Play

แหล่งข้อมูลโอเพนซอร์สสำหรับ Firebase Android SDK

Firebase สนับสนุนการพัฒนาแบบโอเพนซอร์ส และเราขอแนะนำให้ชุมชน ร่วมให้ข้อมูลและแสดงความคิดเห็น

Firebase Android SDK

เราพัฒนา Firebase Android SDK ส่วนใหญ่เป็นไลบรารีโอเพนซอร์สในที่เก็บ GitHub ของ Firebase แบบสาธารณะ เรากำลังดำเนินการอย่างต่อเนื่องเพื่อย้ายไลบรารี Firebase ที่เหลือซึ่งพัฒนาขึ้นแบบส่วนตัวไปยัง GitHub สาธารณะของเราในเร็วๆ นี้

ตัวอย่างการเริ่มต้นอย่างรวดเร็ว

Firebase มีชุดตัวอย่างการเริ่มต้นใช้งานอย่างรวดเร็วสำหรับ Firebase API ส่วนใหญ่ใน Android ดูการเริ่มต้นใช้งานอย่างรวดเร็วเหล่านี้ได้ในที่เก็บการเริ่มต้นใช้งานอย่างรวดเร็วของ Firebase บน GitHub แบบสาธารณะ

คุณสามารถเปิดแต่ละคู่มือเริ่มต้นเป็นโปรเจ็กต์ Android Studio แล้วเรียกใช้ใน อุปกรณ์เคลื่อนที่หรืออุปกรณ์เสมือน (AVD) หรือจะใช้คู่มือเริ่มต้นฉบับย่อเหล่านี้เป็น โค้ดตัวอย่างสำหรับการใช้ Firebase SDK ก็ได้