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

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

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

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

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

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

1. ดาวน์โหลดแล้วเพิ่มไฟล์การกำหนดค่า Firebase Android ( google-services.json ) ลงในแอปของคุณ:

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

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

   คุณต้องรู้อะไรบ้างเกี่ยวกับไฟล์กำหนดค่านี้

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

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

   • ตรวจสอบให้แน่ใจว่าชื่อไฟล์กำหนดค่าไม่ได้ต่อท้ายด้วยอักขระเพิ่มเติม เช่น (2)

2. หากต้องการให้ค่าในไฟล์กำหนด google-services.json เข้าถึง Firebase SDK ได้ คุณต้องมี ปลั๊กอิน Gradle บริการของ Google ( google-services )

   1. ในไฟล์ Gradle ระดับราก (ระดับโครงการ) ( <project>/build.gradle.kts หรือ <project>/build.gradle ) ให้เพิ่มปลั๊กอินบริการของ Google เป็นการพึ่งพา:

      Kotlin

      plugins {
        id("com.android.application") version "7.2.0" apply false
        // ...
      
        // Add the dependency for the Google services Gradle plugin
        id("com.google.gms.google-services") version "4.3.15" apply false
      }
      

      Groovy

      plugins {
        id 'com.android.application' version '7.2.0' apply false
        // ...
      
        // Add the dependency for the Google services Gradle plugin
        id 'com.google.gms.google-services' version '4.3.15' apply false
      }
      

   2. ในไฟล์ Gradle ของ โมดูล (ระดับแอป) (โดยปกติคือ <project>/<app-module>/build.gradle.kts หรือ <project>/<app-module>/build.gradle ) ให้เพิ่มปลั๊กอินบริการของ Google:

      Kotlin

      plugins {
        id("com.android.application")
      
        // Add the Google services Gradle plugin
        id("com.google.gms.google-services")
        // ...
      }
      

      Groovy

      plugins {
        id 'com.android.application'
      
        // Add the Google services Gradle plugin
        id 'com.google.gms.google-services'
        // ...
      }
      

ขั้นตอนที่ 4 : เพิ่ม Firebase SDK ลงในแอปของคุณ

1. ใน ไฟล์ Gradle ของโมดูล (ระดับแอป) (โดยปกติคือ <project>/build.gradle.kts หรือ <project>/build.gradle ) ให้เพิ่มการขึ้นต่อกันสำหรับ ผลิตภัณฑ์ Firebase ที่คุณต้องการใช้ในแอปของคุณ เราขอแนะนำให้ใช้ Firebase Android BoM เพื่อควบคุมเวอร์ชันไลบรารี

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

   Kotlin+KTX

   dependencies {
     // ...
   
     // Import the Firebase BoM
     implementation(platform("com.google.firebase:firebase-bom:32.3.1"))
   
     // When using the BoM, you don't specify versions in Firebase library dependencies
   
     // Add the dependency for the Firebase SDK for Google Analytics
     implementation("com.google.firebase:firebase-analytics-ktx")
   
     // TODO: Add the dependencies for any other Firebase products you want to use
     // See https://firebase.google.com/docs/android/setup#available-libraries
     // For example, add the dependencies for Firebase Authentication and Cloud Firestore
     implementation("com.google.firebase:firebase-auth-ktx")
     implementation("com.google.firebase:firebase-firestore-ktx")
   }
   

   Java

   dependencies {
     // ...
   
     // Import the Firebase BoM
     implementation(platform("com.google.firebase:firebase-bom:32.3.1"))
   
     // When using the BoM, you don't specify versions in Firebase library dependencies
   
     // Add the dependency for the Firebase SDK for Google Analytics
     implementation("com.google.firebase:firebase-analytics")
   
     // TODO: Add the dependencies for any other Firebase products you want to use
     // See https://firebase.google.com/docs/android/setup#available-libraries
     // For example, add the dependencies for Firebase Authentication and Cloud Firestore
     implementation("com.google.firebase:firebase-auth")
     implementation("com.google.firebase:firebase-firestore")
   }
   

   เมื่อใช้ Firebase Android BoM แอปของคุณจะใช้ไลบรารี Firebase Android เวอร์ชันที่เข้ากันได้เสมอ

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

   Kotlin+KTX

   dependencies {
     // ...
   
     // Import the Firebase BoM
     implementation(platform("com.google.firebase:firebase-bom:32.3.1"))
   
     // When using the BoM, you don't specify versions in Firebase library dependencies
   
     // TODO: Add the dependencies for Firebase products you want to use
     // See https://firebase.google.com/docs/android/setup#available-libraries
     // For example, add the dependencies for Firebase Authentication and Cloud Firestore
     implementation("com.google.firebase:firebase-auth-ktx")
     implementation("com.google.firebase:firebase-firestore-ktx")
   }
   

   Java

   dependencies {
     // ...
   
     // Import the Firebase BoM
     implementation(platform("com.google.firebase:firebase-bom:32.3.1"))
   
     // When using the BoM, you don't specify versions in Firebase library dependencies
   
     // TODO: Add the dependencies for Firebase products you want to use
     // See https://firebase.google.com/docs/android/setup#available-libraries
     // For example, add the dependencies for Firebase Authentication and Cloud Firestore
     implementation("com.google.firebase:firebase-auth")
     implementation("com.google.firebase:firebase-firestore")
   }
   

   เมื่อใช้ Firebase Android BoM แอปของคุณจะใช้ไลบรารี Firebase Android เวอร์ชันที่เข้ากันได้เสมอ

2. หลังจากเพิ่มการขึ้นต่อกันของผลิตภัณฑ์ที่คุณต้องการใช้แล้ว ให้ซิงค์โปรเจ็กต์ Android ของคุณกับไฟล์ Gradle

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

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

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

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

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

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

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

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

ผู้ช่วย Firebase จะลงทะเบียนแอปของคุณกับโปรเจ็กต์ 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 เหล่านี้:

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

• ที่เก็บถาวร Firebase Android SDK GitHub

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

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

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

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

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

• จัดเก็บข้อมูล เช่น ข้อมูลผู้ใช้ ด้วย 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