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

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

1. ใน Firebase คอนโซล คลิกเพิ่มโครงการแล้วเลือกหรือป้อนชื่อโครงการ

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

2. (อุปกรณ์เสริม) ถ้าคุณกำลังสร้างโครงการใหม่คุณสามารถแก้ไขรหัสโครงการ

   Firebase จะกำหนด ID ที่ไม่ซ้ำให้กับโปรเจ็กต์ Firebase ของคุณโดยอัตโนมัติ เยี่ยมชม เข้าใจโครงการ Firebase ที่จะเรียนรู้เกี่ยวกับวิธีการใช้รหัส 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 สโตร์

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

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

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

4. (อุปกรณ์เสริม) ป้อนข้อมูลตรวจสอบอื่น ๆ : ชื่อเล่น App และหนังสือรับรองการลงนาม Debug SHA-1

   วิธีนี้เป็นชื่อเล่น App และลงนามหนังสือรับรองการตรวจแก้จุดบกพร่อง SHA-1 ใช้ภายใน Firebase?

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

   • ใบรับรองการลงนาม Debug SHA-ที่ 1: SHA-1 กัญชา เป็นสิ่งจำเป็นโดย Firebase รับรองความถูกต้อง (เมื่อใช้ Google เข้าสู่ระบบ หรือ โทรศัพท์หมายเลขลงทะเบียนใน ) และ Firebase แบบไดนามิกลิงค์

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

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

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

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

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

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

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

   • คุณสามารถดาวน์โหลดของ ไฟล์ config Firebase อีกครั้งในเวลาใดก็ได้

   • ตรวจสอบให้แน่ใจว่าชื่อไฟล์ config ไม่ได้ผนวกเข้ากับตัวละครเพิ่มเติมเช่น (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.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'
   }
   

   คอตลิน+KTX

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

   คอตลิน+KTX

   dependencies {
     // ...
   
     // Import the Firebase BoM
     implementation platform('com.google.firebase:firebase-bom:28.4.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 จากข้อผิดพลาดเพื่อ app ระดับ build.gradle ไฟล์
   • เพิ่ม minSdkVersion สำหรับโครงการ Android ของคุณถึง 26 หรือสูงกว่า

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

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

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

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

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

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

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

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

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

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

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

• ตั้งค่าการไหลของการตรวจสอบผู้ใช้ที่มี การตรวจสอบสิทธิ์

• จัดเก็บข้อมูลเช่นข้อมูลของผู้ใช้กับ ระบบคลาวด์ FireStore หรือ เรียลไทม์ฐานข้อมูล

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

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

• ส่งการแจ้งเตือนกับ Cloud Messaging

• หาเวลาและทำไมแอปของคุณล้มเหลวกับ Crashlytics

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

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

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

• สำรวจ ปพลิเคชัน Firebase ตัวอย่าง

• ได้รับประสบการณ์กับ Firebase Android Codelab

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

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

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

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