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

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

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

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

    • เป้าหมาย API ระดับ 19 (KitKat) หรือสูงกว่า
    • ใช้ Android 4.4 หรือสูงกว่า
    • ใช้ Jetpack (AndroidX) ซึ่งมีคุณสมบัติตรงตามข้อกำหนดเวอร์ชันเหล่านี้:
      • com.android.tools.build:gradle v3.2.1 หรือใหม่กว่า
      • 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 ในแอปของคุณ:

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

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

  2. หากต้องการเปิดใช้งานผลิตภัณฑ์ Firebase ในแอปของคุณ ให้เพิ่ม ปลั๊กอิน google-services ลงในไฟล์ Gradle ของคุณ

    1. ในไฟล์ Gradle ระดับราก (ระดับโปรเจ็กต์) ของคุณ ( build.gradle ) ให้เพิ่มกฎเพื่อรวมปลั๊กอิน Google Services Gradle ตรวจสอบว่าคุณมีที่เก็บ Maven ของ Google ด้วย

      buildscript {
      
        repositories {
          // Check that you have the following line (if not, add it):
          google()  // Google's Maven repository
        }
      
        dependencies {
          // ...
      
          // Add the following line:
          classpath 'com.google.gms:google-services:4.3.12'  // Google Services plugin
        }
      }
      
      allprojects {
        // ...
      
        repositories {
          // Check that you have the following line (if not, add it):
          google()  // Google's Maven repository
          // ...
        }
      }
      
    2. ในไฟล์ Gradle ของโมดูล (ระดับแอป) (โดยปกติคือ app/build.gradle ) ใช้ปลั๊กอิน Google Services Gradle:

      apply plugin: 'com.android.application'
      // Add the following line:
      apply plugin: 'com.google.gms.google-services'  // Google Services plugin
      
      android {
        // ...
      }
      

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

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

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

    Java

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation platform('com.google.firebase:firebase-bom:30.1.0')
    
      // When using the BoM, you don't specify versions in Firebase library dependencies
    
      // Declare the dependency for the Firebase SDK for Google Analytics
      implementation 'com.google.firebase:firebase-analytics'
    
      // Declare the dependencies for any other desired Firebase products
      // For example, declare the dependencies for Firebase Authentication and Cloud Firestore
      implementation 'com.google.firebase:firebase-auth'
      implementation 'com.google.firebase:firebase-firestore'
    }
    

    Kotlin+KTX

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation platform('com.google.firebase:firebase-bom:30.1.0')
    
      // When using the BoM, you don't specify versions in Firebase library dependencies
    
      // Declare the dependency for the Firebase SDK for Google Analytics
      implementation 'com.google.firebase:firebase-analytics-ktx'
    
      // Declare the dependencies for any other desired Firebase products
      // For example, declare the dependencies for Firebase Authentication and Cloud Firestore
      implementation 'com.google.firebase:firebase-auth-ktx'
      implementation 'com.google.firebase:firebase-firestore-ktx'
    }
    

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

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

    Java

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation platform('com.google.firebase:firebase-bom:30.1.0')
    
      // When using the BoM, you don't specify versions in Firebase library dependencies
    
      // Declare the dependencies for the desired Firebase products
      // For example, declare the dependencies for Firebase Authentication and Cloud Firestore
      implementation 'com.google.firebase:firebase-auth'
      implementation 'com.google.firebase:firebase-firestore'
    }
    

    Kotlin+KTX

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation platform('com.google.firebase:firebase-bom:30.1.0')
    
      // When using the BoM, you don't specify versions in Firebase library dependencies
    
      // Declare the dependencies for the desired Firebase products
      // For example, declare the dependencies for Firebase Authentication and Cloud Firestore
      implementation 'com.google.firebase:firebase-auth-ktx'
      implementation 'com.google.firebase:firebase-firestore-ktx'
    }
    

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

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

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

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



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

Firebase Assistant ลงทะเบียนแอปของคุณกับโปรเจ็กต์ 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 ใน build.gradle

Java

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

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

30.1.0
AdMob com.google.android.gms:play-services-ads 21.0.0
การวิเคราะห์ com.google.firebase:firebase-analytics 21.0.0
App Check ผู้ให้บริการที่กำหนดเอง com.google.firebase:firebase-appcheck 16.0.0
App Check ผู้ให้บริการดีบัก com.google.firebase:firebase-appcheck-debug 16.0.0
App Check Play Integrity ผู้ให้บริการ com.google.firebase:firebase-appcheck-playintegrity 16.0.0
ผู้ให้บริการ App Check SafetyNet com.google.firebase:firebase-appcheck-safetynet 16.0.0
การกระจายแอพ com.google.firebase:firebase-appdistribution 16.0.0-beta03
API การกระจายแอป com.google.firebase:firebase-appdistribution-api 16.0.0-beta03
ปลั๊กอินการกระจายแอป com.google.firebase:firebase-appdistribution-gradle 3.0.2
การตรวจสอบสิทธิ์ com.google.firebase:firebase-auth 21.0.6
Cloud Firestore com.google.firebase:firebase-firestore 24.2.0
ฟังก์ชันระบบคลาวด์สำหรับ Firebase Client SDK com.google.firebase:firebase-functions 20.1.0
การส่งข้อความบนคลาวด์ com.google.firebase:firebase-messaging 23.0.6
การจัดเก็บเมฆ com.google.firebase:firebase-storage 20.0.1
Crashlytics com.google.firebase:firebase-crashlytics 18.2.11
Crashlytics NDK com.google.firebase:firebase-crashlytics-ndk 18.2.11
ปลั๊กอิน Crashlytics com.google.firebase:firebase-crashlytics-gradle 2.9.1
รองรับโมดูลคุณสมบัติไดนามิก com.google.firebase:firebase-dynamic-module-support 16.0.0-beta01
ลิงก์แบบไดนามิก com.google.firebase:firebase-dynamic-links 21.0.1
การส่งข้อความในแอป com.google.firebase:firebase-inappmessaging 20.1.2
(ที่จำเป็น)
การแสดงข้อความในแอป com.google.firebase:firebase-inappmessaging-display 20.1.2
(ที่จำเป็น)
การติดตั้ง Firebase com.google.firebase:firebase-installations 17.0.1
Firebase ML Model Downloader API com.google.firebase:firebase-ml-modeldownloader 24.0.3
การตรวจสอบประสิทธิภาพ com.google.firebase:firebase-perf 20.1.0
ปลั๊กอินการตรวจสอบประสิทธิภาพ com.google.firebase:perf-plugin 1.4.1
ฐานข้อมูลเรียลไทม์ com.google.firebase:firebase-database 20.0.5
การกำหนดค่าระยะไกล com.google.firebase:firebase-config 21.1.0
ปลั๊กอินบริการ Google Play com.google.gms:google-services 4.3.12
ห้องสมุดที่เลิกใช้แล้ว
การจัดทำดัชนีแอป com.google.firebase:firebase-appindexing 20.0.0
Firebase ML Custom Model APIs com.google.firebase:firebase-ml-model-interpreter 22.0.4
Firebase ML Vision APIs 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-natural-language 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

Kotlin+KTX

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

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

30.1.0
AdMob com.google.android.gms:play-services-ads 21.0.0
การวิเคราะห์ com.google.firebase:firebase-analytics-ktx 21.0.0
App Check ผู้ให้บริการที่กำหนดเอง com.google.firebase:firebase-appcheck 16.0.0
App Check ผู้ให้บริการดีบัก com.google.firebase:firebase-appcheck-debug 16.0.0
ผู้ให้บริการ App Check SafetyNet com.google.firebase:firebase-appcheck-safetynet 16.0.0
API การกระจายแอป com.google.firebase:firebase-appdistribution-api-ktx 16.0.0-beta03
ปลั๊กอินการกระจายแอป com.google.firebase:firebase-appdistribution-gradle 3.0.2
การตรวจสอบสิทธิ์ com.google.firebase:firebase-auth-ktx 21.0.6
Cloud Firestore com.google.firebase:firebase-firestore-ktx 24.2.0
ฟังก์ชันระบบคลาวด์สำหรับ Firebase Client SDK com.google.firebase:firebase-functions-ktx 20.1.0
การส่งข้อความบนคลาวด์ com.google.firebase:firebase-messaging-ktx 23.0.6
การจัดเก็บเมฆ com.google.firebase:firebase-storage-ktx 20.0.1
Crashlytics com.google.firebase:firebase-crashlytics-ktx 18.2.11
Crashlytics NDK com.google.firebase:firebase-crashlytics-ndk 18.2.11
ปลั๊กอิน Crashlytics com.google.firebase:firebase-crashlytics-gradle 2.9.1
รองรับโมดูลคุณสมบัติไดนามิก com.google.firebase:firebase-dynamic-module-support 16.0.0-beta01
ลิงก์แบบไดนามิก com.google.firebase:firebase-dynamic-links-ktx 21.0.1
การส่งข้อความในแอป com.google.firebase:firebase-inappmessaging-ktx 20.1.2
(ที่จำเป็น)
การแสดงข้อความในแอป com.google.firebase:firebase-inappmessaging-display-ktx 20.1.2
(ที่จำเป็น)
การติดตั้ง Firebase com.google.firebase:firebase-installations-ktx 17.0.1
Firebase ML Model Downloader API com.google.firebase:firebase-ml-modeldownloader-ktx 24.0.3
การตรวจสอบประสิทธิภาพ com.google.firebase:firebase-perf-ktx 20.1.0
ปลั๊กอินการตรวจสอบประสิทธิภาพ com.google.firebase:perf-plugin 1.4.1
ฐานข้อมูลเรียลไทม์ com.google.firebase:firebase-database-ktx 20.0.5
การกำหนดค่าระยะไกล com.google.firebase:firebase-config-ktx 21.1.0
ปลั๊กอินบริการ Google Play com.google.gms:google-services 4.3.12
ห้องสมุดที่เลิกใช้แล้ว
การจัดทำดัชนีแอป com.google.firebase:firebase-appindexing 20.0.0
Firebase ML Custom Model APIs com.google.firebase:firebase-ml-model-interpreter 22.0.4
Firebase ML Vision APIs 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-natural-language 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

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

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

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

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

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

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

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