Join us for Firebase Summit on November 10, 2021. Tune in to learn how Firebase can help you accelerate app development, release with confidence, and scale with ease. Register

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

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

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

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

    • เป้าหมาย API ระดับ 16 (Jelly Bean) หรือสูงกว่า
    • ใช้ Android 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.10'  // 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.4.2')
    
      // 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.4.2')
    
      // 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.4.2')
    
      // 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.4.2')
    
      // 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



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

ส่วนนี้แสดงรายการผลิตภัณฑ์ 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.4.2
AdMob com.google.android.gms:play-services-ads 20.4.0
การวิเคราะห์ com.google.firebase:firebase-analytics 19.0.2
App Check ผู้ให้บริการที่กำหนดเอง com.google.firebase:firebase-appcheck 16.0.0-beta03
ผู้ให้บริการตรวจแก้จุดบกพร่อง App Check com.google.firebase:firebase-appcheck-debug 16.0.0-beta03
ผู้ให้บริการ App Check SafetyNet com.google.firebase:firebase-appcheck-safetynet 16.0.0-beta03
ปลั๊กอินการกระจายแอป com.google.firebase:firebase-appdistribution-gradle 2.2.0
การจัดทำดัชนีแอป 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.4
ฟังก์ชันระบบคลาวด์สำหรับ Firebase Client SDK com.google.firebase:firebase-functions 20.0.1
การส่งข้อความบนคลาวด์ com.google.firebase:firebase-messaging 22.0.0
การจัดเก็บเมฆ com.google.firebase:firebase-storage 20.0.0
Crashlytics com.google.firebase:firebase-crashlytics 18.2.3
Crashlytics NDK com.google.firebase:firebase-crashlytics-ndk 18.2.3
ปลั๊กอิน 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.1.0
(ที่จำเป็น)
การแสดงข้อความในแอป com.google.firebase:firebase-inappmessaging-display 20.1.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.3
ปลั๊กอินการตรวจสอบประสิทธิภาพ com.google.firebase:perf-plugin 1.4.0
ฐานข้อมูลเรียลไทม์ com.google.firebase:firebase-database 20.0.2
การกำหนดค่าระยะไกล com.google.firebase:firebase-config 21.0.1
ปลั๊กอินบริการ Google Play com.google.gms:google-services 4.3.10
ห้องสมุดที่เลิกใช้แล้ว
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.4.2
AdMob com.google.android.gms:play-services-ads 20.4.0
การวิเคราะห์ com.google.firebase:firebase-analytics-ktx 19.0.2
App Check ผู้ให้บริการที่กำหนดเอง com.google.firebase:firebase-appcheck 16.0.0-beta03
ผู้ให้บริการตรวจแก้จุดบกพร่อง App Check com.google.firebase:firebase-appcheck-debug 16.0.0-beta03
ผู้ให้บริการ App Check SafetyNet com.google.firebase:firebase-appcheck-safetynet 16.0.0-beta03
ปลั๊กอินการกระจายแอป com.google.firebase:firebase-appdistribution-gradle 2.2.0
การจัดทำดัชนีแอป 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.4
ฟังก์ชันระบบคลาวด์สำหรับ Firebase Client SDK com.google.firebase:firebase-functions-ktx 20.0.1
การส่งข้อความบนคลาวด์ 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.3
Crashlytics NDK com.google.firebase:firebase-crashlytics-ndk 18.2.3
ปลั๊กอิน 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.1.0
(ที่จำเป็น)
การแสดงข้อความในแอป com.google.firebase:firebase-inappmessaging-display-ktx 20.1.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.3
ปลั๊กอินการตรวจสอบประสิทธิภาพ com.google.firebase:perf-plugin 1.4.0
ฐานข้อมูลเรียลไทม์ com.google.firebase:firebase-database-ktx 20.0.2
การกำหนดค่าระยะไกล com.google.firebase:firebase-config-ktx 21.0.1
ปลั๊กอินบริการ Google Play com.google.gms:google-services 4.3.10
ห้องสมุดที่เลิกใช้แล้ว
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: