เพิ่ม Firebase ให้กับโปรเจ็กต์ Android ของคุณ

ข้อกำหนดเบื้องต้น

  • ติดตั้งหรืออัปเดต Android Studio เป็นเวอร์ชันล่าสุด

  • ตรวจสอบให้แน่ใจว่าโครงการของคุณตรงตามข้อกำหนดเหล่านี้:

    • กำหนดเป้าหมาย API ระดับ 19 (KitKat) หรือสูงกว่า
    • ใช้ Android 4.4 หรือสูงกว่า
    • ใช้ Jetpack (AndroidX) ซึ่งรวมถึงการปฏิบัติตามข้อกำหนดเวอร์ชันเหล่านี้:
      • com.android.tools.build:gradle v7.3.0 หรือใหม่กว่า
      • compileSdkVersion 28 หรือใหม่กว่า
  • ตั้งค่าอุปกรณ์ทางกายภาพหรือใช้ โปรแกรมจำลอง เพื่อเรียกใช้แอปของคุณ
    โปรดทราบว่า Firebase SDK ที่ต้องพึ่งพาบริการ Google Play จำเป็นต้องมีอุปกรณ์หรือโปรแกรมจำลองติดตั้งบริการ Google Play

  • ลงชื่อเข้าใช้ Firebase โดยใช้บัญชี Google ของคุณ

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


คุณสามารถเชื่อมต่อแอป Android กับ Firebase ได้โดยใช้ตัวเลือกใดตัวเลือกหนึ่งต่อไปนี้



ตัวเลือกที่ 1 : เพิ่ม Firebase โดยใช้คอนโซล Firebase

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

ขั้นตอนที่ 1 : สร้างโครงการ Firebase

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

ขั้นตอนที่ 2 : ลงทะเบียนแอปของคุณกับ Firebase

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

  1. ไปที่ คอนโซล Firebase

  2. ที่กึ่งกลางของหน้าภาพรวมโครงการ ให้คลิกไอคอน Android ( ) หรือ เพิ่มแอป เพื่อเปิดขั้นตอนการตั้งค่า

  3. ป้อนชื่อแพ็กเกจของแอปในช่อง ชื่อแพ็กเกจ Android

  4. (ไม่บังคับ) ป้อนข้อมูลแอปอื่นๆ: ชื่อเล่นแอป และ ใบรับรองการลงนามการแก้ไขข้อบกพร่อง SHA-1

  5. คลิก ลงทะเบียนแอป

ขั้นตอนที่ 3 : เพิ่มไฟล์การกำหนดค่า Firebase

  1. ดาวน์โหลดแล้วเพิ่มไฟล์การกำหนดค่า Firebase Android ( google-services.json ) ลงในแอปของคุณ:

    1. คลิก ดาวน์โหลด google-services.json เพื่อรับไฟล์กำหนดค่า Firebase Android

    2. ย้ายไฟล์กำหนดค่าของคุณไปยังไดเร็กทอรีรากของ โมดูล (ระดับแอป) ของแอปของคุณ

  2. หากต้องการให้ค่าในไฟล์กำหนด google-services.json เข้าถึง Firebase SDK ได้ คุณต้องมี ปลั๊กอิน Gradle บริการของ Google ( google-services )

    1. ในไฟล์ Gradle ระดับราก (ระดับโครงการ) ( <project>/build.gradle.kts หรือ <project>/build.gradle ) ให้เพิ่มปลั๊กอินบริการของ Google เป็นการพึ่งพา:

      Kotlin

      plugins {
        id("com.android.application") version "7.3.0" apply false
        // ...
      
        // Add the dependency for the Google services Gradle plugin
        id("com.google.gms.google-services") version "4.4.0" apply false
      }
      

      Groovy

      plugins {
        id 'com.android.application' version '7.3.0' apply false
        // ...
      
        // Add the dependency for the Google services Gradle plugin
        id 'com.google.gms.google-services' version '4.4.0' apply false
      }
      
    2. ในไฟล์ Gradle ของ โมดูล (ระดับแอป) (โดยปกติคือ <project>/<app-module>/build.gradle.kts หรือ <project>/<app-module>/build.gradle ) ให้เพิ่มปลั๊กอินบริการของ Google:

      Kotlin

      plugins {
        id("com.android.application")
      
        // Add the Google services Gradle plugin
        id("com.google.gms.google-services")
        // ...
      }
      

      Groovy

      plugins {
        id 'com.android.application'
      
        // Add the Google services Gradle plugin
        id 'com.google.gms.google-services'
        // ...
      }
      

ขั้นตอนที่ 4 : เพิ่ม Firebase SDK ลงในแอปของคุณ

  1. ใน ไฟล์ Gradle ของโมดูล (ระดับแอป) (โดยปกติคือ <project>/<app-module>/build.gradle.kts หรือ <project>/<app-module>/build.gradle ) ให้เพิ่มการพึ่งพาสำหรับ ผลิตภัณฑ์ Firebase ที่คุณต้องการใช้ในแอปของคุณ เราขอแนะนำให้ใช้ Firebase Android BoM เพื่อควบคุมเวอร์ชันไลบรารี

    เปิดใช้งานการวิเคราะห์แล้ว

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation(platform("com.google.firebase:firebase-bom:32.6.0"))
    
      // When using the BoM, you don't specify versions in Firebase library dependencies
    
      // Add the dependency for the Firebase SDK for Google Analytics
      implementation("com.google.firebase:firebase-analytics")
    
      // TODO: Add the dependencies for any other Firebase products you want to use
      // See https://firebase.google.com/docs/android/setup#available-libraries
      // For example, add the dependencies for Firebase Authentication and Cloud Firestore
      implementation("com.google.firebase:firebase-auth")
      implementation("com.google.firebase:firebase-firestore")
    }
    

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

    กำลังมองหาโมดูลไลบรารีเฉพาะของ Kotlin อยู่ใช่ไหม? เริ่มตั้งแต่ เดือนตุลาคม 2023 (Firebase BoM 32.5.0) ทั้งนักพัฒนา Kotlin และ Java สามารถพึ่งพาโมดูลไลบรารีหลักได้ (สำหรับรายละเอียด โปรดดู คำถามที่พบบ่อยเกี่ยวกับโครงการริเริ่มนี้ )

    ไม่ได้เปิดใช้งานการวิเคราะห์

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation(platform("com.google.firebase:firebase-bom:32.6.0"))
    
      // When using the BoM, you don't specify versions in Firebase library dependencies
    
      // TODO: Add the dependencies for Firebase products you want to use
      // See https://firebase.google.com/docs/android/setup#available-libraries
      // For example, add the dependencies for Firebase Authentication and Cloud Firestore
      implementation("com.google.firebase:firebase-auth")
      implementation("com.google.firebase:firebase-firestore")
    }
    

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

    กำลังมองหาโมดูลไลบรารีเฉพาะของ Kotlin อยู่ใช่ไหม? เริ่มตั้งแต่ เดือนตุลาคม 2023 (Firebase BoM 32.5.0) ทั้งนักพัฒนา Kotlin และ Java สามารถพึ่งพาโมดูลไลบรารีหลักได้ (สำหรับรายละเอียด โปรดดู คำถามที่พบบ่อยเกี่ยวกับโครงการริเริ่มนี้ )

  2. หลังจากเพิ่มการขึ้นต่อกันของผลิตภัณฑ์ที่คุณต้องการใช้แล้ว ให้ซิงค์โปรเจ็กต์ Android ของคุณกับไฟล์ Gradle

แค่นั้นแหละ! คุณสามารถข้ามไปข้างหน้าเพื่อดู ขั้นตอนถัดไป ที่แนะนำได้

หากคุณมีปัญหาในการตั้งค่า โปรดไปที่ การแก้ไขปัญหาและคำถามที่พบบ่อยของ Android



ตัวเลือกที่ 2 : เพิ่ม Firebase โดยใช้ Firebase Assistant

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

  1. เปิดโปรเจ็กต์ Android ของคุณใน Android Studio จากนั้นตรวจสอบให้แน่ใจว่าคุณใช้ Android Studio และ Firebase Assistant เวอร์ชันล่าสุด:

    • Windows / Linux: วิธีใช้ > ตรวจสอบการอัปเดต
    • macOS: Android Studio > ตรวจสอบการอัปเดต
  2. เปิดผู้ช่วย Firebase: เครื่องมือ > Firebase

  3. ในบานหน้าต่าง ผู้ช่วย ให้ เลือกผลิตภัณฑ์ Firebase ที่จะเพิ่มลงในแอปของคุณ ขยายส่วน จากนั้นคลิกลิงก์บทช่วยสอน (เช่น Analytics > บันทึกเหตุการณ์ Analytics )

    1. คลิก เชื่อมต่อกับ Firebase เพื่อเชื่อมต่อโปรเจ็กต์ Android ของคุณกับ Firebase

    2. คลิกปุ่มเพื่อเพิ่มผลิตภัณฑ์ Firebase ที่ต้องการ (เช่น เพิ่ม Analytics ให้กับแอปของคุณ )

  4. ซิงค์แอปของคุณเพื่อให้แน่ใจว่าการอ้างอิงทั้งหมดมีเวอร์ชันที่จำเป็น

  5. ในแผง ผู้ช่วย ให้ ทำตามคำแนะนำการตั้งค่าที่เหลือสำหรับผลิตภัณฑ์ Firebase ที่คุณเลือก

  6. เพิ่มผลิตภัณฑ์ Firebase อื่นๆ ได้มากเท่าที่คุณต้องการผ่าน Firebase Assistant!

แค่นั้นแหละ! อย่าลืมตรวจสอบ ขั้นตอนถัดไป ที่แนะนำ

หากคุณมีปัญหาในการตั้งค่า โปรดไปที่ การแก้ไขปัญหาและคำถามที่พบบ่อยของ Android



ห้องสมุดที่มีอยู่

ส่วนนี้แสดงรายการผลิตภัณฑ์ Firebase ที่รองรับสำหรับ Android และการขึ้นต่อกันของ Gradle เรียนรู้เพิ่มเติมเกี่ยวกับไลบรารี Firebase Android เหล่านี้:

โปรดทราบว่าเมื่อใช้ Firebase Android BoM คุณไม่ต้องระบุเวอร์ชันไลบรารีแต่ละรายการเมื่อคุณประกาศการพึ่งพาไลบรารี Firebase ในไฟล์การกำหนดค่า Gradle build ของคุณ

บริการหรือผลิตภัณฑ์ การพึ่งพา Gradle ล่าสุด
รุ่น
เพิ่มการวิเคราะห์?
Firebase Android BoM
(รายการวัสดุ)
com.google.firebase:firebase-bom

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

32.6.0
แอดโมบ com.google.android.gms:play-services-ads 22.5.0
การวิเคราะห์ com.google.firebase:firebase-analytics 21.5.0
ผู้ให้บริการที่กำหนดเองของ App Check com.google.firebase:firebase-appcheck 17.1.1
ผู้ให้บริการแก้ไขข้อบกพร่อง App Check com.google.firebase:firebase-appcheck-debug 17.1.1
ตรวจสอบแอป ผู้ให้บริการความสมบูรณ์ของ Play com.google.firebase:firebase-appcheck-playintegrity 17.1.1
การเผยแพร่แอป com.google.firebase:firebase-appdistribution 16.0.0-เบต้า11
API การกระจายแอป com.google.firebase:firebase-appdistribution-api 16.0.0-เบต้า11
ปลั๊กอินการเผยแพร่แอป com.google.firebase:firebase-appdistribution-gradle 4.0.1
การรับรองความถูกต้อง com.google.firebase:firebase-auth 22.3.0
คลาวด์ไฟร์สโตร์ com.google.firebase:firebase-firestore 24.9.1
ฟังก์ชั่นคลาวด์สำหรับ Firebase Client SDK com.google.firebase:firebase-ฟังก์ชั่น 20.4.0
การส่งข้อความบนคลาวด์ com.google.firebase:ข้อความ firebase 23.3.1
การจัดเก็บเมฆ com.google.firebase:firebase-storage 20.3.0
Crashlytics com.google.firebase:firebase-crashlytics 18.6.0
Crashlytics NDK com.google.firebase:firebase-crashlytics-ndk 18.6.0
ปลั๊กอิน Crashlytics com.google.firebase:firebase-crashlytics-gradle 2.9.9
การสนับสนุนโมดูลคุณลักษณะแบบไดนามิก com.google.firebase:firebase-dynamic-module-support 16.0.0-เบต้า03
ลิงค์แบบไดนามิก com.google.firebase:firebase-dynamic-ลิงก์ 21.2.0
การส่งข้อความในแอป com.google.firebase:firebase-inappข้อความ 20.4.0
(ที่จำเป็น)
การแสดงข้อความในแอป com.google.firebase:firebase-inappmessaging-display 20.4.0
(ที่จำเป็น)
การติดตั้ง Firebase com.google.firebase:firebase-การติดตั้ง 17.2.0
API ตัวดาวน์โหลดโมเดล Firebase ML com.google.firebase:firebase-ml-modeldownloader 24.2.1
การตรวจสอบประสิทธิภาพ com.google.firebase:firebase-perf 20.5.1
ปลั๊กอินตรวจสอบประสิทธิภาพ com.google.firebase:perf-ปลั๊กอิน 1.4.2
ฐานข้อมูลเรียลไทม์ com.google.firebase:firebase-ฐานข้อมูล 20.3.0
การกำหนดค่าระยะไกล com.google.firebase:firebase-config 21.6.0
ปลั๊กอินบริการ Google Play com.google.gms:google-services 4.4.0
ไลบรารีที่เลิกใช้แล้ว
ผู้ให้บริการ App Check SafetyNet com.google.firebase:firebase-appcheck-safetynet 16.1.2
การจัดทำดัชนีแอป com.google.firebase:firebase-appindexing 20.0.0

โมดูล Firebase KTX

การวิเคราะห์ com.google.firebase:firebase-analytics-ktx 21.5.0
ผู้ให้บริการที่กำหนดเองของ App Check com.google.firebase:firebase-appcheck-ktx 17.1.1
API การกระจายแอป com.google.firebase:firebase-appdistribution-api-ktx 16.0.0-เบต้า11
การรับรองความถูกต้อง com.google.firebase:firebase-auth-ktx 22.3.0
คลาวด์ไฟร์สโตร์ com.google.firebase:firebase-firestore-ktx 24.9.1
ฟังก์ชั่นคลาวด์สำหรับ Firebase Client SDK com.google.firebase:firebase-functions-ktx 20.4.0
การส่งข้อความบนคลาวด์ com.google.firebase:firebase-messaging-ktx 23.3.1
การจัดเก็บเมฆ com.google.firebase:firebase-storage-ktx 20.3.0
Crashlytics com.google.firebase:firebase-crashlytics-ktx 18.6.0
ลิงค์แบบไดนามิก com.google.firebase:firebase-dynamic-links-ktx 21.2.0
การส่งข้อความในแอป com.google.firebase:firebase-inappmessaging-ktx 20.4.0
(ที่จำเป็น)
การแสดงข้อความในแอป com.google.firebase:firebase-inappmessaging-display-ktx 20.4.0
(ที่จำเป็น)
การติดตั้ง Firebase com.google.firebase:firebase-installations-ktx 17.2.0
API ตัวดาวน์โหลดโมเดล Firebase ML com.google.firebase:firebase-ml-modeldownloader-ktx 24.2.1
การตรวจสอบประสิทธิภาพ com.google.firebase:firebase-perf-ktx 20.5.1
ฐานข้อมูลเรียลไทม์ com.google.firebase:firebase-database-ktx 20.3.0
การกำหนดค่าระยะไกล com.google.firebase:firebase-config-ktx 21.6.0

ไลบรารี Firebase ML Kit

API โมเดลที่กำหนดเองของ Firebase ML com.google.firebase:firebase-ml-model-ล่าม 22.0.4
Firebase ML Vision API com.google.firebase:firebase-ml-vision 24.1.0
Firebase ML: โมเดลการติดป้ายกำกับรูปภาพ com.google.firebase:firebase-ml-vision-image-label-model 20.0.2
Firebase ML: โมเดลการตรวจจับและติดตามวัตถุ com.google.firebase:firebase-ml-vision-object-detection-model 19.0.6
Firebase ML: โมเดลการตรวจจับใบหน้า com.google.firebase:firebase-ml-vision-face-model 20.0.2
Firebase ML: โมเดลการสแกนบาร์โค้ด com.google.firebase:firebase-ml-vision-barcode-model 16.1.2
Firebase ML: AutoML Vision Edge API com.google.firebase:firebase-ml-vision-automl 18.0.6
Firebase ML: API ภาษาธรรมชาติ com.google.firebase:firebase-ml-ภาษาธรรมชาติ 22.0.1
Firebase ML: โมเดลการระบุภาษา com.google.firebase:firebase-ml-natural-Language-Language-id-model 20.0.8
Firebase ML: โมเดลการแปล com.google.firebase:firebase-ml-natural-language-translate-model 20.0.9
Firebase ML: โมเดลการตอบกลับอัจฉริยะ com.google.firebase:firebase-ml-natural- language-smart-reply-model 20.0.8



ขั้นตอนถัดไป

เพิ่มบริการ Firebase ให้กับแอปของคุณ:

  • รับข้อมูลเชิงลึกเกี่ยวกับพฤติกรรมผู้ใช้ด้วย Analytics

  • ตั้งค่าขั้นตอนการตรวจสอบสิทธิ์ผู้ใช้ด้วย Authentication

  • จัดเก็บข้อมูล เช่น ข้อมูลผู้ใช้ ด้วย Cloud Firestore หรือ Realtime Database

  • จัดเก็บไฟล์ เช่น รูปภาพและวิดีโอด้วย Cloud Storage

  • ทริกเกอร์โค้ดแบ็กเอนด์ที่ทำงานในสภาพแวดล้อมที่ปลอดภัยด้วย Cloud Functions

  • ส่งการแจ้งเตือนด้วย Cloud Messaging

  • ค้นหาว่าแอปของคุณขัดข้องเมื่อใดและเพราะเหตุใดด้วย Crashlytics

เรียนรู้เกี่ยวกับ Firebase: