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

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

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

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

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

    • กำหนดเป้าหมาย API ระดับ 16 (Jelly Bean) หรือใหม่กว่า
    • ใช้ Gradle 4.1 หรือใหม่กว่า
    • ใช้ Jetpack (AndroidX) ซึ่งมีคุณสมบัติตรงตามข้อกำหนดของเวอร์ชันเหล่านี้:
      • com.android.tools.build:gradle v3.2.1 หรือใหม่กว่า
      • compileSdkVersion 28 หรือใหม่กว่า
  • ตั้งค่าอุปกรณ์จริงหรือใช้โปรแกรมจำลองเพื่อเรียกใช้แอปของคุณ
    ผู้เลียนแบบ ต้องใช้ภาพจำลองกับ 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 เพื่อเรียนรู้เพิ่มเติมเกี่ยวกับแนวทางปฏิบัติที่ดีที่สุดและข้อควรพิจารณาในการเพิ่มแอปในโครงการ Firebase รวมถึงวิธีจัดการรูปแบบบิวด์หลายรายการ

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

  2. ตรงกลางหน้าภาพรวมโครงการคลิกไอคอน Android ( ) เพื่อเปิดเวิร์กโฟลว์การตั้งค่า

    หากคุณได้เพิ่มแอปลงในโครงการ Firebase แล้วให้คลิก เพิ่มแอป เพื่อแสดงตัวเลือกแพลตฟอร์ม

  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. ในไฟล์ build.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.3'  // 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. ในโมดูลของคุณ (ระดับแอป) ไฟล์ Gradle (โดยทั่วไปคือ app/build.gradle ) ให้เพิ่มการอ้างอิงสำหรับ ผลิตภัณฑ์ Firebase ที่คุณต้องการใช้ในแอปของคุณ

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

    Java

    dependencies {
      // ...
    
      // Add the dependency for the Firebase SDK for Google Analytics
      implementation 'com.google.firebase:firebase-analytics:17.5.0'
    
      // Add the dependencies for any other desired Firebase products
      // For example, to use Firebase Authentication and Cloud Firestore
      implementation 'com.google.firebase:firebase-auth:19.4.0'
      implementation 'com.google.firebase:firebase-firestore:21.6.0'
    }
    
    // Getting a "Could not find" error? Make sure that you've added
    // Google's Maven repository to your project-level build.gradle file
    

    โคตรลิน + KTX

    dependencies {
      // ...
    
      // Add the dependency for the Firebase SDK for Google Analytics
      implementation 'com.google.firebase:firebase-analytics-ktx:17.5.0'
    
      // Add the dependencies for any other desired Firebase products
      // For example, to use Firebase Authentication and Cloud Firestore
      implementation 'com.google.firebase:firebase-auth-ktx:19.4.0'
      implementation 'com.google.firebase:firebase-firestore-ktx:21.6.0'
    }
    
    // Getting a "Could not find" error? Make sure that you've added
    // Google's Maven repository to your project-level build.gradle file
    

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

    Java

    dependencies {
      // ...
    
      // Add the dependencies for the desired Firebase products
      // For example, to use Firebase Authentication and Cloud Firestore
      implementation 'com.google.firebase:firebase-auth:19.4.0'
      implementation 'com.google.firebase:firebase-firestore:21.6.0'
    }
    
    // Getting a "Could not find" error? Make sure that you've added
    // Google's Maven repository to your project-level build.gradle file
    

    โคตรลิน + KTX

    dependencies {
      // ...
    
      // Add the dependencies for the desired Firebase products
      // For example, to use Firebase Authentication and Cloud Firestore
      implementation 'com.google.firebase:firebase-auth-ktx:19.4.0'
      implementation 'com.google.firebase:firebase-firestore-ktx:21.6.0'
    }
    
    // Getting a "Could not find" error? Make sure that you've added
    // Google's Maven repository to your project-level build.gradle file
    
  2. ซิงค์แอปของคุณเพื่อให้แน่ใจว่าการอ้างอิงทั้งหมดมีเวอร์ชันที่จำเป็น

แค่นั้นแหละ! คุณสามารถข้ามไปยัง ขั้นตอนถัดไป ได้

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

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

โปรดทราบว่าตัวเลือกที่แนะนำในการเชื่อมต่อแอปของคุณกับ Firebase คือการใช้ เวิร์กโฟลว์การตั้งค่าคอนโซล Firebase

  1. เปิดโปรเจ็กต์ Android ของคุณใน Android Studio

  2. เลือก เครื่องมือ> Firebase เพื่อเปิดบานหน้าต่าง ผู้ช่วย

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

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

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

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

  7. หากคุณเพิ่ม Analytics ให้ เรียกใช้แอปของคุณเพื่อส่งการยืนยันไปยัง Firebase ว่าคุณได้รวม Firebase เรียบร้อยแล้ว มิฉะนั้นคุณสามารถข้ามขั้นตอนการยืนยันนี้ได้

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

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

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

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

ควบคุมการสร้างเวอร์ชันไลบรารีด้วย Firebase Bill of Materials (BoM)

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

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

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

Java

บริการหรือสินค้า การพึ่งพา Gradle เพิ่ม Analytics ไหม
AdMob com.google.android.gms: play-services-ads: 19.4.0
การวิเคราะห์ com.google.firebase: firebase-analytics: 17.5.0
การจัดทำดัชนีแอป com.google.firebase: firebase-appindexing: 19.1.0
การรับรองความถูกต้อง com.google.firebase: firebase-auth: 19.4.0
Cloud Firestore com.google.firebase: firebase-firestore: 21.6.0
Cloud Functions สำหรับ Firebase Client SDK com.google.firebase: firebase-functions: 19.1.0
การส่งข้อความบนคลาวด์ com.google.firebase: firebase-messaging: 20.2.4
การจัดเก็บเมฆ com.google.firebase: firebase-storage: 19.2.0
Crashlytics com.google.firebase: firebase-crashlytics: 17.2.1
ลิงก์แบบไดนามิก com.google.firebase: firebase-dynamic-links: 19.1.0
Firebase ML Vision API com.google.firebase: firebase-ml-vision: 24.1.0
API โมเดลที่กำหนดเองของ Firebase ML com.google.firebase: firebase-ml-model-interpreter: 22.0.4
การส่งข้อความในแอป com.google.firebase: firebase-busymessaging: 19.1.1
(จำเป็น)
การแสดงข้อความในแอพ com.google.firebase: firebase-abuse-display: 19.1.1
(จำเป็น)
การตรวจสอบประสิทธิภาพ com.google.firebase: firebase-perf: 19.0.8
ฐานข้อมูลเรียลไทม์ com.google.firebase: firebase-database: 19.4.0
การกำหนดค่าระยะไกล com.google.firebase: firebase-config: 19.2.0
รายการวัสดุ Firebase (BoM) com.google.firebase: firebase-bom: 25.10.0

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

ปลั๊กอินบริการ Google Play com.google.gms: google-services: 4.3.3
เลิกใช้ไลบรารี
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 เพิ่ม Analytics ไหม
AdMob com.google.android.gms: play-services-ads: 19.4.0
การวิเคราะห์ com.google.firebase: firebase-analytics-ktx: 17.5.0
การจัดทำดัชนีแอป com.google.firebase: firebase-appindexing: 19.1.0
การรับรองความถูกต้อง com.google.firebase: firebase-auth-ktx: 19.4.0
Cloud Firestore com.google.firebase: firebase-firestore-ktx: 21.6.0
Cloud Functions สำหรับ Firebase Client SDK com.google.firebase: firebase-functions-ktx: 19.1.0
การส่งข้อความบนคลาวด์ com.google.firebase: firebase-messaging: 20.2.4
การจัดเก็บเมฆ com.google.firebase: firebase-storage-ktx: 19.2.0
Crashlytics com.google.firebase: firebase-crashlytics-ktx: 17.2.1
ลิงก์แบบไดนามิก com.google.firebase: firebase-dynamic-links-ktx: 19.1.0
Firebase ML Vision API com.google.firebase: firebase-ml-vision: 24.1.0
API โมเดลที่กำหนดเองของ Firebase ML com.google.firebase: firebase-ml-model-interpreter: 22.0.4
การส่งข้อความในแอป com.google.firebase: firebase-abuse-ktx: 19.1.1
(จำเป็น)
การแสดงข้อความในแอพ com.google.firebase: firebase-abuse-display-ktx: 19.1.1
(จำเป็น)
การตรวจสอบประสิทธิภาพ com.google.firebase: firebase-perf: 19.0.8
ฐานข้อมูลเรียลไทม์ com.google.firebase: firebase-database-ktx: 19.4.0
การกำหนดค่าระยะไกล com.google.firebase: firebase-config-ktx: 19.2.0
รายการวัสดุของ Firebase (BoM) com.google.firebase: firebase-bom: 25.10.0

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

ปลั๊กอินบริการ Google Play com.google.gms: google-services: 4.3.3
เลิกใช้ไลบรารี
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 ในแอปของคุณ:

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

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

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

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

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

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

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