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

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

  • ติดตั้งหรือปรับปรุง Android สตูดิโอ กับรุ่นใหม่ล่าสุดของ

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

    • เป้าหมาย API ระดับ 16 (Jelly Bean) หรือใหม่กว่า
    • ใช้ Gradle 4.1 หรือใหม่กว่า
    • ใช้ Jetpack (AndroidX) ซึ่งรวมถึงการประชุมความต้องการรุ่นเหล่านี้:
      • com.android.tools.build:gradle v3.2.1 หรือในภายหลัง
      • compileSdkVersion 28 หรือในภายหลัง
  • ตั้งค่าอุปกรณ์ทางกายภาพหรือใช้ โปรแกรมจำลอง การทำงานของแอป
    โปรดทราบว่า Firebase SDKs กับการพึ่งพาบริการ Google Play ของคุณ ต้องใช้อุปกรณ์หรือโปรแกรมจำลองจะมีบริการ Google Play ติดตั้ง

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

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


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

  • ตัวเลือกที่ 1 : (แนะนำ) ใช้เวิร์กโฟลว์การติดตั้ง Firebase คอนโซล
  • ตัวเลือกที่ 2 : ใช้ 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. (อุปกรณ์เสริม) ป้อนข้อมูลตรวจสอบอื่น ๆ : ชื่อเล่น App และหนังสือรับรองการลงนาม Debug SHA-1

  5. คลิกแอปสมัครสมาชิก

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

  1. เพิ่มไฟล์การกำหนดค่า Firebase Android ในแอปของคุณ:

    1. คลิกดาวน์โหลด google-services.json ที่จะได้รับไฟล์ config ของคุณ Firebase Android ( google-services.json )

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

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

    1. ในระดับรากของคุณ (ระดับโครงการ) ไฟล์ Gradle ( build.gradle ), เพิ่มกฎระเบียบที่จะรวมปลั๊กอิน Google บริการ 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.8'  // Google Services plugin
        }
      }
      
      allprojects {
        // ...
      
        repositories {
          // Check that you have the following line (if not, add it):
          google()  // Google's Maven repository
          // ...
        }
      }
      
    2. ในโมดูลของคุณ (app ระดับ) ไฟล์ Gradle (ปกติ app/build.gradle ) ใช้ปลั๊กอิน Google บริการ 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 ที่คุณต้องการใช้งานในแอปของคุณ ประกาศไว้ในโมดูลของคุณ (app ระดับ) ไฟล์ Gradle (ปกติ app/build.gradle )

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

    Java

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation platform('com.google.firebase:firebase-bom:28.3.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'
    }
    

    คอตลิน+KTX

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation platform('com.google.firebase:firebase-bom:28.3.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:28.3.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'
    }
    

    คอตลิน+KTX

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation platform('com.google.firebase:firebase-bom:28.3.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 ผู้ช่วย

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

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

    • ของ Windows / Linux: ช่วยเหลือ> ตรวจหาการปรับปรุง
    • MacOS: Android ดิโอ> ตรวจหาการปรับปรุง
  2. เปิด Firebase ผู้ช่วย: เครื่องมือ> Firebase

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

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

    2. คลิกที่ปุ่มเพื่อเพิ่มสินค้า Firebase ต้องการ (เช่นเพิ่ม Analytics เพื่อ app ของคุณ)

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

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

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

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

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



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

ส่วนนี้แสดงรายการผลิตภัณฑ์ 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 นั้น

28.3.0
AdMob com.google.android.gms:play-services-ads 20.2.0
การวิเคราะห์ com.google.firebase:firebase-analytics 19.0.0
App Check ผู้ให้บริการที่กำหนดเอง com.google.firebase:firebase-appcheck 16.0.0-beta02
ผู้ให้บริการตรวจแก้จุดบกพร่อง App Check com.google.firebase:firebase-appcheck-debug 16.0.0-beta02
ผู้ให้บริการ App Check SafetyNet com.google.firebase:firebase-appcheck-safetynet 16.0.0-beta02
ปลั๊กอินการกระจายแอป App com.google.firebase:firebase-appdistribution-gradle 2.1.3
การจัดทำดัชนีแอป com.google.firebase:firebase-appindexing 20.0.0
การตรวจสอบสิทธิ์ com.google.firebase:firebase-auth 21.0.1
Cloud Firestore com.google.firebase:firebase-firestore 23.0.3
ฟังก์ชันระบบคลาวด์สำหรับ Firebase Client SDK com.google.firebase:firebase-functions 20.0.0
การส่งข้อความบนคลาวด์ com.google.firebase:firebase-messaging 22.0.0
การจัดเก็บเมฆ com.google.firebase:firebase-storage 20.0.0
Crashlytics com.google.firebase:firebase-crashlytics 18.2.0
Crashlytics NDK com.google.firebase:firebase-crashlytics-ndk 18.2.0
ปลั๊กอิน Crashlytics com.google.firebase:firebase-crashlytics-gradle 2.7.1
รองรับโมดูลคุณสมบัติไดนามิก com.google.firebase:firebase-dynamic-module-support 16.0.0-beta01
ลิงก์แบบไดนามิก com.google.firebase:firebase-dynamic-links 20.1.1
การส่งข้อความในแอป com.google.firebase:firebase-inappmessaging 20.0.0
(ที่จำเป็น)
การแสดงข้อความในแอป com.google.firebase:firebase-inappmessaging-display 20.0.0
(ที่จำเป็น)
การติดตั้ง Firebase com.google.firebase:firebase-installations 17.0.0
Firebase ML Model Downloader API com.google.firebase:firebase-ml-modeldownloader 24.0.0
การตรวจสอบประสิทธิภาพ com.google.firebase:firebase-perf 20.0.2
ปลั๊กอินการตรวจสอบประสิทธิภาพ com.google.firebase:perf-plugin 1.4.0
ฐานข้อมูลเรียลไทม์ com.google.firebase:firebase-database 20.0.1
การกำหนดค่าระยะไกล com.google.firebase:firebase-config 21.0.0
ปลั๊กอินบริการ Google Play com.google.gms:google-services 4.3.8
ห้องสมุดที่เลิกใช้แล้ว
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

คอตลิน+KTX

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

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

28.3.0
AdMob com.google.android.gms:play-services-ads 20.2.0
การวิเคราะห์ com.google.firebase:firebase-analytics-ktx 19.0.0
App Check ผู้ให้บริการที่กำหนดเอง com.google.firebase:firebase-appcheck 16.0.0-beta02
ผู้ให้บริการตรวจแก้จุดบกพร่อง App Check com.google.firebase:firebase-appcheck-debug 16.0.0-beta02
ผู้ให้บริการ App Check SafetyNet com.google.firebase:firebase-appcheck-safetynet 16.0.0-beta02
ปลั๊กอินการกระจายแอป App com.google.firebase:firebase-appdistribution-gradle 2.1.3
การจัดทำดัชนีแอป com.google.firebase:firebase-appindexing 20.0.0
การตรวจสอบสิทธิ์ com.google.firebase:firebase-auth-ktx 21.0.1
Cloud Firestore com.google.firebase:firebase-firestore-ktx 23.0.3
ฟังก์ชันระบบคลาวด์สำหรับ Firebase Client SDK com.google.firebase:firebase-functions-ktx 20.0.0
การส่งข้อความบนคลาวด์ com.google.firebase:firebase-messaging-ktx 22.0.0
การจัดเก็บเมฆ com.google.firebase:firebase-storage-ktx 20.0.0
Crashlytics com.google.firebase:firebase-crashlytics-ktx 18.2.0
Crashlytics NDK com.google.firebase:firebase-crashlytics-ndk 18.2.0
ปลั๊กอิน Crashlytics com.google.firebase:firebase-crashlytics-gradle 2.7.1
รองรับโมดูลคุณสมบัติไดนามิก com.google.firebase:firebase-dynamic-module-support 16.0.0-beta01
ลิงก์แบบไดนามิก com.google.firebase:firebase-dynamic-links-ktx 20.1.1
การส่งข้อความในแอป com.google.firebase:firebase-inappmessaging-ktx 20.0.0
(ที่จำเป็น)
การแสดงข้อความในแอป com.google.firebase:firebase-inappmessaging-display-ktx 20.0.0
(ที่จำเป็น)
การติดตั้ง Firebase com.google.firebase:firebase-installations-ktx 17.0.0
Firebase ML Model Downloader API com.google.firebase:firebase-ml-modeldownloader-ktx 24.0.0
การตรวจสอบประสิทธิภาพ com.google.firebase:firebase-perf-ktx 20.0.2
ปลั๊กอินการตรวจสอบประสิทธิภาพ com.google.firebase:perf-plugin 1.4.0
ฐานข้อมูลเรียลไทม์ com.google.firebase:firebase-database-ktx 20.0.1
การกำหนดค่าระยะไกล com.google.firebase:firebase-config-ktx 21.0.0
ปลั๊กอินบริการ Google Play com.google.gms:google-services 4.3.8
ห้องสมุดที่เลิกใช้แล้ว
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 ในแอปของคุณ:

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