ข้อกำหนดเบื้องต้น
ติดตั้งหรืออัปเดต Android Studio เป็นเวอร์ชันล่าสุด
ตรวจสอบให้แน่ใจว่าโครงการของคุณตรงตามข้อกำหนดเหล่านี้:
- กำหนดเป้าหมาย API ระดับ 16 (Jelly Bean) หรือใหม่กว่า
- ใช้ Gradle 4.1 หรือใหม่กว่า
- ใช้ 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 การลงทะเบียนแอปของคุณมักเรียกว่า "การเพิ่ม" แอปของคุณในโครงการของคุณ
ไปที่ คอนโซล Firebase
ตรงกลางหน้าภาพรวมโครงการให้คลิกไอคอน Android (
) หรือ เพิ่มแอป เพื่อเปิดขั้นตอนการตั้งค่าป้อนชื่อแพ็กเกจของแอปในช่อง ชื่อแพ็กเกจ Android
ชื่อแพ็กเกจจะ ระบุแอปของคุณโดยไม่ซ้ำกันบนอุปกรณ์และใน Google Play Store
ชื่อแพ็กเกจ มักเรียกว่า ID แอปพลิเคชัน
ค้นหาชื่อแพ็กเกจของแอปของคุณในไฟล์ Gradle ของโมดูล (ระดับแอป) โดยปกติจะเป็น
app/build.gradle
(ชื่อแพ็กเกจตัวอย่าง:com.yourcompany.yourproject
)โปรดทราบว่าค่าชื่อแพ็กเกจเป็นแบบตรงตามตัวพิมพ์เล็กและตัวพิมพ์ใหญ่และไม่สามารถเปลี่ยนแปลงสำหรับแอป Firebase สำหรับ Android นี้หลังจากที่ลงทะเบียนกับโครงการ Firebase ของคุณแล้ว
(ไม่บังคับ) ป้อนข้อมูลแอปอื่น ๆ : ชื่อเล่นแอป และ ใบรับรองการลงนามการแก้ไขข้อบกพร่อง SHA-1
ชื่อเล่นแอป : ตัวระบุความสะดวกภายในที่มองเห็นได้เฉพาะคุณในคอนโซล Firebase
แก้ไขข้อบกพร่องใบรับรองการลงนาม SHA-1 : การตรวจสอบสิทธิ์ของ Firebase จำเป็นต้องใช้ แฮช SHA-1 (เมื่อใช้ Google Sign In หรือการ ลงชื่อเข้าใช้หมายเลขโทรศัพท์ ) และ ลิงก์แบบไดนามิกของ Firebase
คลิก ลงทะเบียนแอป
ขั้นตอนที่ 3 : เพิ่มไฟล์การกำหนดค่า Firebase
เพิ่มไฟล์การกำหนดค่า Firebase Android ลงในแอปของคุณ:
คลิก ดาวน์โหลด google-services.json เพื่อรับไฟล์กำหนดค่า Firebase Android (
)google-services.json ย้ายไฟล์กำหนดค่าของคุณไปยังไดเร็กทอรีโมดูล (ระดับแอพ) ของแอพของคุณ
ไฟล์กำหนดค่า Firebase มีตัวระบุที่ไม่ซ้ำกัน แต่ไม่เป็นความลับสำหรับโครงการของคุณ หากต้องการเรียนรู้เพิ่มเติมเกี่ยวกับไฟล์การกำหนดค่านี้โปรดไปที่ ทำความเข้าใจกับโครงการ Firebase
คุณสามารถดาวน์โหลด ไฟล์กำหนดค่า Firebase อีกครั้งได้ทุกเมื่อ
ตรวจสอบว่าชื่อไฟล์กำหนดค่าไม่ได้ต่อท้ายด้วยอักขระเพิ่มเติมเช่น
(2)
หากต้องการเปิดใช้งานผลิตภัณฑ์ Firebase ในแอปของคุณให้เพิ่ม ปลั๊กอินบริการ ของ Google ลงในไฟล์ Gradle ของคุณ
ในไฟล์
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.4' // Google Services plugin } } allprojects { // ... repositories { // Check that you have the following line (if not, add it): google() // Google's Maven repository // ... } }
ในโมดูลของคุณ (ระดับแอป) ไฟล์ 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 ลงในแอปของคุณ
ใช้ Firebase Android BoM ประกาศการอ้างอิงสำหรับ ผลิตภัณฑ์ Firebase ที่คุณต้องการใช้ในแอปของคุณ ประกาศใน โมดูล ของคุณ (ระดับแอป) ไฟล์ Gradle (โดยทั่วไปคือ
app/build.gradle
)เปิดใช้งานการวิเคราะห์
Java
dependencies { // ... // Import the Firebase BoM implementation platform('com.google.firebase:firebase-bom:26.3.0') // 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:26.3.0') // 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:26.3.0') // 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:26.3.0') // 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 : เพิ่ม Firebase โดยใช้ Firebase Assistant
Firebase Assistant จะ ลงทะเบียนแอปของคุณกับโปรเจ็กต์ Firebase และเพิ่มไฟล์ Firebase ปลั๊กอินและการอ้างอิงที่จำเป็นไปยังโปรเจ็กต์ Android ของคุณทั้งหมดนี้ทำได้จากภายใน Android Studio!
เปิดโครงการ Android ของคุณใน Android Studio และเข้าถึง Firebase Assistant:
ไปที่ ไฟล์> ตรวจสอบการอัปเดต เพื่อให้แน่ใจว่าคุณใช้ Android Studio และ Firebase Assistant เวอร์ชันล่าสุด
ไปที่ เครื่องมือ> Firebase เพื่อเปิดบานหน้าต่าง ผู้ช่วย
เลือกผลิตภัณฑ์ Firebase เพื่อเพิ่มลงในแอปของคุณ ขยายส่วนจากนั้นคลิกลิงก์บทแนะนำ (ตัวอย่างเช่น
Analytics> บันทึกเหตุการณ์ Analytics )คลิก เชื่อมต่อกับ Firebase เพื่อเชื่อมต่อโครงการ Android ของคุณกับ Firebase
เวิร์กโฟลว์นี้จะสร้างแอป Firebase สำหรับ Android ใหม่โดยอัตโนมัติโดยใช้ ชื่อแพ็กเกจ ของแอป คุณสามารถสร้างแอป Firebase สำหรับ Android ใหม่นี้ได้ทั้งในโครงการ Firebase ที่มีอยู่หรือโครงการใหม่
เคล็ดลับบางประการเกี่ยวกับการตั้งค่าโครงการ Firebase ของคุณมีดังนี้
ไปที่ ทำความเข้าใจกับโครงการ Firebase เพื่อเรียนรู้เพิ่มเติมเกี่ยวกับแนวทางปฏิบัติที่ดีที่สุดและข้อควรพิจารณาในการเพิ่มแอปในโครงการ Firebase รวมถึงวิธีจัดการรูปแบบบิวด์หลายรายการ
หากคุณสร้างโครงการใหม่เราขอแนะนำอย่างยิ่งให้คุณตั้งค่า Google Analytics สำหรับโครงการของคุณซึ่งจะช่วยให้คุณได้รับประสบการณ์ที่ดีที่สุดในการใช้ผลิตภัณฑ์ Firebase จำนวนมาก
เวิร์กโฟลว์นี้ยังเพิ่มไฟล์การกำหนดค่า Android ของโครงการ Firebase (
) ไปยังไดเร็กทอรีโมดูล (ระดับแอป) ของแอปของคุณgoogle-services.json
คลิกปุ่มเพื่อเพิ่มผลิตภัณฑ์ Firebase ที่ต้องการ (ตัวอย่างเช่น
เพิ่ม Analytics ในแอปของคุณ )
ซิงค์แอปของคุณเพื่อให้แน่ใจว่าการอ้างอิงทั้งหมดมีเวอร์ชันที่จำเป็น
ในบานหน้าต่างผู้ช่วย Firebase ให้ทำตามคำแนะนำการตั้งค่าที่เหลือสำหรับผลิตภัณฑ์ Firebase ที่คุณเลือก
เพิ่มผลิตภัณฑ์ Firebase อื่น ๆ ได้มากเท่าที่คุณต้องการผ่าน Firebase Assistant!
แค่นั้นแหละ! อย่าลืมตรวจสอบ ขั้นตอนต่อไปที่ แนะนำ
ห้องสมุดที่มีอยู่
ส่วนนี้จะแสดงรายการผลิตภัณฑ์ Firebase ที่รองรับ Android และการอ้างอิง Gradle เรียนรู้เพิ่มเติมเกี่ยวกับไลบรารี Firebase Android เหล่านี้:
เอกสารอ้างอิง ( Java | Kotlin + KTX )
Firebase Android SDK GitHub repo
โปรดทราบว่าเมื่อใช้ Firebase Android BoM คุณจะไม่ระบุไลบรารีแต่ละเวอร์ชันเมื่อคุณประกาศการอ้างอิงไลบรารี Firebase ใน build.gradle
Java
บริการหรือสินค้า | การพึ่งพา Gradle | ล่าสุด รุ่น | เพิ่ม Analytics ไหม |
---|---|---|---|
Firebase Android BoM (รายการวัสดุ) | com.google.firebase: firebase-bom Firebase BoM เวอร์ชันล่าสุดประกอบด้วยไลบรารี Firebase Android เวอร์ชันล่าสุด หากต้องการเรียนรู้ว่าเวอร์ชันไลบรารีใดที่ถูกจับคู่กับเวอร์ชัน BoM ที่ระบุให้ตรวจสอบบันทึกประจำรุ่นสำหรับเวอร์ชัน BoM นั้น | 26.3.0 | |
AdMob | com.google.android.gms: play-services-ads | 19.7.0 | |
การวิเคราะห์ | com.google.firebase: firebase-analytics | 18.0.1 | |
การจัดทำดัชนีแอป | com.google.firebase: firebase-appindexing | 19.1.0 | |
การรับรองความถูกต้อง | com.google.firebase: firebase-auth | 20.0.2 | |
Cloud Firestore | com.google.firebase: firebase-firestore | 22.0.1 | |
Cloud Functions สำหรับ Firebase Client SDK | com.google.firebase: firebase-functions | 19.2.0 | |
การส่งข้อความบนคลาวด์ | com.google.firebase: firebase-messaging | 21.0.1 | |
การจัดเก็บเมฆ | com.google.firebase: firebase-storage | 19.2.1 | |
Crashlytics | com.google.firebase: firebase-crashlytics | 17.3.0 | |
ลิงก์แบบไดนามิก | com.google.firebase: firebase-dynamic-links | 19.1.1 | |
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.3 | (จำเป็น) |
การแสดงข้อความในแอพ | com.google.firebase: firebase-abuse-display.conf | 19.1.3 | (จำเป็น) |
การตรวจสอบประสิทธิภาพ | com.google.firebase: firebase-perf | 19.1.0 | |
ฐานข้อมูลเรียลไทม์ | com.google.firebase: firebase-database | 19.6.0 | |
การกำหนดค่าระยะไกล | com.google.firebase: firebase-config | 20.0.2 | |
ปลั๊กอินบริการ Google Play | com.google.gms: google-services | 4.3.4 | |
เลิกใช้ไลบรารี | |||
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 ไหม |
---|---|---|---|
Firebase Android BoM (รายการวัสดุ) | com.google.firebase: firebase-bom Firebase BoM เวอร์ชันล่าสุดประกอบด้วยไลบรารี Firebase Android เวอร์ชันล่าสุด หากต้องการเรียนรู้ว่าเวอร์ชันไลบรารีใดที่ถูกจับคู่กับเวอร์ชัน BoM ที่ระบุให้ตรวจสอบบันทึกประจำรุ่นสำหรับเวอร์ชัน BoM นั้น | 26.3.0 | |
AdMob | com.google.android.gms: play-services-ads | 19.7.0 | |
การวิเคราะห์ | com.google.firebase: firebase-analytics-ktx | 18.0.1 | |
การจัดทำดัชนีแอป | com.google.firebase: firebase-appindexing | 19.1.0 | |
การรับรองความถูกต้อง | com.google.firebase: firebase-auth-ktx | 20.0.2 | |
Cloud Firestore | com.google.firebase: firebase-firestore-ktx | 22.0.1 | |
Cloud Functions สำหรับ Firebase Client SDK | com.google.firebase: firebase-functions-ktx | 19.2.0 | |
การส่งข้อความบนคลาวด์ | com.google.firebase: firebase-messaging-ktx | 21.0.1 | |
การจัดเก็บเมฆ | com.google.firebase: firebase-storage-ktx | 19.2.1 | |
Crashlytics | com.google.firebase: firebase-crashlytics-ktx | 17.3.0 | |
ลิงก์แบบไดนามิก | com.google.firebase: firebase-dynamic-links-ktx | 19.1.1 | |
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.3 | (จำเป็น) |
การแสดงข้อความในแอป | com.google.firebase: firebase-abuse-display-ktx | 19.1.3 | (จำเป็น) |
การตรวจสอบประสิทธิภาพ | com.google.firebase: firebase-perf-ktx | 19.1.0 | |
ฐานข้อมูลเรียลไทม์ | com.google.firebase: firebase-database-ktx | 19.6.0 | |
การกำหนดค่าระยะไกล | com.google.firebase: firebase-config-ktx | 20.0.2 | |
ปลั๊กอินบริการ Google Play | com.google.gms: google-services | 4.3.4 | |
เลิกใช้ไลบรารี | |||
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 ในแอปของคุณ:
รับข้อมูลเชิงลึกเกี่ยวกับพฤติกรรมของผู้ใช้ด้วย 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