เพิ่ม 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
• ตัวเลือกที่ 2 : ใช้ Android Studio Firebase Assistant (อาจต้องมีการกำหนดค่าเพิ่มเติม)

ตัวเลือกที่ 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 ( plat_android ) หรือ เพิ่มแอป เพื่อเริ่มเวิร์กโฟลว์การตั้งค่า

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

   ชื่อแพ็คเกจคืออะไรและจะหาได้จากที่ไหน?

   • ชื่อแพ็กเกจ จะระบุแอปของคุณบนอุปกรณ์และใน Google Play Store โดยไม่ซ้ำกัน

   • ชื่อแพ็คเกจ มักถูกเรียกว่า ID แอปพลิเคชัน

   • ค้นหาชื่อแพ็คเกจของแอปของคุณในไฟล์ Gradle ของโมดูล (ระดับแอป) ซึ่งมักจะเป็น app/build.gradle (ชื่อแพ็คเกจตัวอย่าง: com.yourcompany.yourproject )

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

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

   ชื่อเล่นของแอป และ ใบรับรองการลงนามดีบัก SHA-1 ใช้อย่างไรใน Firebase

   • ชื่อเล่นของแอป : ตัวระบุความสะดวกภายในที่มีคุณเท่านั้นที่เห็นในคอนโซล Firebase

   • ดีบักใบรับรองการลงชื่อ SHA-1 : ต้องมี แฮช SHA-1 โดย Firebase Authentication (เมื่อใช้ Google Sign In หรือ หมายเลขโทรศัพท์ลงชื่อเข้าใช้ ) และ Firebase Dynamic Links

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

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

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

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

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

   สิ่งที่คุณต้องรู้เกี่ยวกับไฟล์ปรับแต่งนี้

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

   • คุณดาวน์โหลด ไฟล์กำหนดค่า Firebase อีกครั้งได้ทุกเมื่อ

   • ตรวจสอบให้แน่ใจว่าชื่อไฟล์ปรับแต่งไม่ได้ต่อท้ายด้วยอักขระเพิ่มเติม เช่น (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.13'  // 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.3.1')
   
     // 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.3.1')
   
     // 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.3.1')
   
     // 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.3.1')
   
     // 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. ซิงค์แอปของคุณเพื่อให้แน่ใจว่าการขึ้นต่อกันทั้งหมดมีเวอร์ชันที่จำเป็น

   รับความล้มเหลวของบิลด์เกี่ยวกับการเรียกใช้การสนับสนุนแบบกำหนดเองและการเปิดใช้งาน desugaring หรือไม่ นี่คือวิธีการแก้ไข

   Gradle builds ที่ใช้ปลั๊กอิน Android Gradle (AGP) v4.2 หรือเก่ากว่านั้นจำเป็นต้องเปิดใช้งานการรองรับ Java 8 มิฉะนั้น โปรเจ็กต์ Android เหล่านี้จะเกิดความล้มเหลวในการสร้างเมื่อเพิ่ม Firebase SDK

   ในการแก้ไขความล้มเหลวของบิลด์นี้ คุณสามารถทำตามหนึ่งในสองตัวเลือก:

   • เพิ่ม compileOptions ที่อยู่ในรายการจากข้อความแสดงข้อผิดพลาดไปยังไฟล์ build.gradle ระดับแอป ของคุณ
   • เพิ่ม minSdkVersion สำหรับโครงการ Android ของคุณเป็น 26 หรือสูงกว่า

   เรียนรู้เพิ่มเติมเกี่ยวกับความล้มเหลวในการสร้าง นี้ในคำถามที่พบบ่อย นี้

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

หากคุณประสบปัญหาในการตั้งค่า โปรดไปที่ การ แก้ไขปัญหาและคำถามที่พบบ่อย ของ 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

      เวิร์กโฟลว์นี้ทำอะไร?

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

        เคล็ดลับบางประการเกี่ยวกับการตั้งค่าโปรเจ็กต์ Firebase มีดังนี้

        • ดู แนวทางปฏิบัติที่ดีที่สุด ของเราในการเพิ่มแอปลงในโปรเจ็กต์ Firebase รวมถึงวิธีจัดการกับตัวแปรต่างๆ

        • หากคุณสร้างโปรเจ็กต์ใหม่ เราขอแนะนำให้คุณตั้งค่า Google Analytics สำหรับโปรเจ็กต์ของคุณ ซึ่งจะทำให้คุณได้รับประสบการณ์ที่ดีที่สุดโดยใช้ผลิตภัณฑ์ Firebase มากมาย

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

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

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

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

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

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

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

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

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

• เอกสารอ้างอิง ( Java | Kotlin+KTX )

• Firebase Android SDK GitHub repo

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

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

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

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

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

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

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

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

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

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

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

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

• ไป ที่เรียนรู้เพิ่มเติมเกี่ยวกับ Android และ Firebase หากคุณมีคำถามเกี่ยวกับแนวคิดที่ไม่คุ้นเคยหรือเฉพาะเจาะจงสำหรับการพัฒนา Firebase และ Android

• สำรวจ ตัวอย่างแอป Firebase

• รับประสบการณ์ตรงกับ Firebase Android Codelab

• เรียนรู้เพิ่มเติมด้วย Firebase ในหลักสูตรวันหยุดสุดสัปดาห์

• เตรียมเปิดแอปของคุณ:

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

• มีปัญหากับ Firebase และโปรเจ็กต์ Android ของคุณหรือไม่ ไปที่การ แก้ไขปัญหา Android & คำถามที่พบบ่อย