เพิ่ม 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

สร้างโปรเจ็กต์ Firebase

1. ใน คอนโซล Firebase คลิก เพิ่มโครงการ

   • หากต้องการเพิ่มทรัพยากร Firebase ให้กับโปรเจ็กต์ Google Cloud ที่มีอยู่ ให้ป้อนชื่อโปรเจ็กต์หรือเลือกจากเมนูแบบเลื่อนลง

   • หากต้องการสร้างโครงการใหม่ ให้ป้อนชื่อโครงการที่ต้องการ คุณยังเลือกแก้ไขรหัสโปรเจ็กต์ที่แสดงด้านล่างชื่อโปรเจ็กต์ได้อีกด้วย

2. หากได้รับแจ้ง ให้อ่านและยอมรับ ข้อกำหนดของ Firebase

3. คลิก ดำเนินการ ต่อ

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

   Firebase Crashlytics การคาดการณ์ Firebase

   การส่งข้อความบนคลาวด์ของ Firebase การส่งข้อความในแอปของ Firebase

   การกำหนดค่าระยะไกลของ Firebase การทดสอบ Firebase A/B

   เลือก บัญชี Google Analytics ที่มีอยู่หรือสร้างบัญชีใหม่

   หากคุณสร้างบัญชีใหม่ ให้เลือก ตำแหน่งการรายงาน Analytics จากนั้นยอมรับการตั้งค่าการเปิดเผยข้อมูลและข้อกำหนดของ Google Analytics สำหรับโครงการของคุณ

5. คลิก สร้างโปรเจ็ กต์ (หรือ เพิ่ม Firebase หากคุณใช้โปรเจ็กต์ Google Cloud ที่มีอยู่)

Firebase จะจัดสรรทรัพยากรสำหรับโปรเจ็กต์ Firebase ของคุณโดยอัตโนมัติ เมื่อดำเนินการเสร็จสิ้น ระบบจะนำคุณไปยังหน้าภาพรวมสำหรับโปรเจ็กต์ 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.10'  // 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:29.0.4')
   
     // 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:29.0.4')
   
     // 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:29.0.4')
   
     // 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:29.0.4')
   
     // 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 บิลด์ที่ใช้ปลั๊กอิน 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 " เพื่อเรียนรู้เพิ่มเติมเกี่ยวกับแนวทางปฏิบัติที่ดีที่สุดและข้อควรพิจารณาในการเพิ่มแอปลงในโปรเจ็กต์ 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 & คำถามที่พบบ่อย