1. ก่อนที่คุณจะเริ่ม
ใน Codelab นี้ คุณจะได้เรียนรู้วิธีเพิ่มความสามารถในการมีส่วนร่วมกับผู้ใช้ ไม่ว่าพวกเขาจะใช้แอปของคุณในเบื้องหน้าหรือแอปของคุณอยู่เบื้องหลัง
ข้อกำหนดเบื้องต้น
ไม่มี
สิ่งที่คุณจะได้เรียนรู้
- เพิ่ม Firebase ให้กับแอพ Android ของคุณ
- เพิ่มการพึ่งพา FCM และ FIAM
- ส่งข้อความทดสอบ FCM ไปยังแอปของคุณ
- ส่งข้อความทดสอบ FIAM ไปยังแอปของคุณ
สิ่งที่คุณต้องการ
- Android Studio 4.1
- อุปกรณ์ Android หรือโปรแกรมจำลอง
2. เริ่มต้น
รับโค้ดตัวอย่าง
โคลนที่เก็บ GitHub จากบรรทัดคำสั่ง:
นำเข้าแอพเริ่มต้น
จาก Android Studio ให้เลือก codelab-fcm-and-fiam
( ). มันจะเป็นอันที่โคลนในขั้นตอนก่อนหน้า ( File > Open > .../codelab-fcm-and-fiam)
ตอนนี้คุณควรจะเปิดโปรเจ็กต์ FcmAndFiam ใน Android Studio หากคุณเห็นคำเตือนเกี่ยวกับไฟล์ google-services.json ที่หายไป ไม่ต้องกังวล มันจะถูกเพิ่มในขั้นตอนต่อไป
3. สร้างโปรเจ็กต์คอนโซล Firebase
เพิ่ม Firebase ให้กับโปรเจ็กต์
- ไปที่ คอนโซล Firebase
- เลือก เพิ่มโครงการ
- เลือกหรือป้อนชื่อโครงการ
- ทำตามขั้นตอนการตั้งค่าที่เหลือในคอนโซล Firebase จากนั้นคลิก สร้างโปรเจ็ กต์ (หรือเพิ่ม Firebase หากคุณใช้โปรเจ็กต์ Google ที่มีอยู่)
- จากหน้าจอภาพรวมของโปรเจ็กต์ใหม่ของคุณ ให้คลิกไอคอน Android เพื่อเปิดเวิร์กโฟลว์การตั้งค่า
- ป้อนชื่อแพ็คเกจของ codelab:
com.google.firebase.codelab.fcmandfiam
เพิ่มไฟล์ google-services.json ในแอปของคุณ
หลังจากเพิ่มชื่อแพ็คเกจแล้ว ให้คลิก ลงทะเบียนแอป จากนั้นดาวน์โหลด google-services.json เพื่อรับไฟล์กำหนดค่า Firebase Android ของคุณ จากนั้นคัดลอกไฟล์ google-services.json ลงในไดเรกทอรี app
ในโครงการของคุณ หลังจากดาวน์โหลดไฟล์แล้ว คุณสามารถคลิก ข้าม เพื่อไปยังขั้นตอนถัดไปที่แสดงในคอนโซล (ซึ่งได้ทำไปแล้วในโปรเจ็กต์ build-android-start)
เพิ่มปลั๊กอินบริการของ Google ในแอปของคุณ
ปลั๊กอิน google-services ใช้ไฟล์ google-services.json เพื่อกำหนดค่าแอปพลิเคชันของคุณให้ใช้ Firebase ควรเพิ่มการพึ่งพาปลั๊กอิน google-services และปลั๊กอินเองในไฟล์บิลด์ระดับโปรเจ็กต์และแอปตามลำดับ ยืนยันรายการต่อไปนี้:
build.gradle
buildscript {
...
dependencies {
...
classpath 'com.google.gms:google-services:4.3.8'
}
}
app/build.gradle
plugins {
...
id: 'com.google.gms.google-services'
}
เพิ่มการพึ่งพา
FCM และ FIAM ต้องการการพึ่งพาต่อไปนี้ ควรเพิ่มการพึ่งพาเหล่านี้ในไฟล์บิลด์ระดับแอปแล้ว ยืนยันว่ามีการเพิ่มการพึ่งพาต่อไปนี้:
app/build.gradle
dependencies {
...
implementation platform('com.google.firebase:firebase-bom:28.4.2')
implementation 'com.google.firebase:firebase-analytics'
implementation 'com.google.firebase:firebase-messaging'
implementation 'com.google.firebase:firebase-inappmessaging-display'
}
ซิงค์โปรเจ็กต์ของคุณกับไฟล์ gradle
เพื่อให้แน่ใจว่าการพึ่งพาทั้งหมดพร้อมใช้งานสำหรับแอปของคุณ คุณควรซิงค์โปรเจ็กต์ของคุณกับไฟล์ gradle ณ จุดนี้ เลือก ไฟล์ > ซิงค์โปรเจ็กต์ด้วย Gradle Files จากแถบเครื่องมือ Android Studio
4. ตัวระบุบันทึก
Firebase Cloud Messaging และ Firebase In App Messaging ทั้งคู่ใช้ตัวระบุเพื่อส่งข้อความไปยังแอพ FCM ใช้โทเค็นการลงทะเบียนและ FIAM ใช้ ID การติดตั้ง
- ใน
MainActivity.kt
ให้แทนที่ TODO ด้วยรหัสด้านล่างเพื่อบันทึกตัวระบุที่จำเป็นในการส่งข้อความ:
FirebaseMessaging.getInstance().token.addOnCompleteListener { regTokenTask ->
if (regTokenTask.isSuccessful) {
Log.d(TAG, "FCM registration token: ${regTokenTask.result}")
} else {
Log.e(TAG, "Unable to retrieve registration token",
regTokenTask.exception)
}
}
FirebaseInstallations.getInstance().id.addOnCompleteListener { installationIdTask ->
if (installationIdTask.isSuccessful) {
Log.d(TAG, "Firebase Installations ID: ${installationIdTask.result}")
} else {
Log.e(TAG, "Unable to retrieve installations ID",
installationIdTask.exception)
}
}
- เชื่อมต่ออุปกรณ์ Android ของคุณแล้วคลิก เรียกใช้ (
) ในแถบเครื่องมือ Android Studio การแตะที่ปุ่ม ตัวระบุ บันทึกจะบันทึกโทเค็นการลงทะเบียน FCM และ ID การติดตั้ง Firebase ไปยัง logcat ผลลัพธ์ควรมีลักษณะดังนี้:
D/FcmAndFiam: Firebase Installations ID: emMc5...AsJfb
FCM registration token: emMc5LART6GV7...r0Q
5. ส่งข้อความทดสอบ FCM
ข้อความ FCM สามารถส่งได้ทั้งจากคอนโซล Firebase และจาก FCM REST API ใน Codelab นี้ เราจะเขียนข้อความแจ้งเตือน FCM และส่งไปยังอุปกรณ์ของเรา ข้อความแจ้งเตือนคือข้อความที่แสดงในพื้นที่แจ้งเตือนของระบบ ส่งข้อความทดสอบ FCM โดย:
- ตรวจสอบให้แน่ใจว่าแอปอยู่ในพื้นหลัง (ไปที่หน้าจอหลัก)
- ไปที่คอนโซล Firebase และเลือก Cloud Messaging ในการนำทางด้านซ้าย
- เลือก ส่งข้อความแรกของคุณ
- เพิ่มชื่อและเนื้อหาของข้อความ จากนั้นคลิก ส่งข้อความทดสอบ
- เพิ่มโทเค็นการลงทะเบียน FCM จากนั้นคลิก ทดสอบ
- สังเกตการแสดงการแจ้งเตือนบนอุปกรณ์
- การแตะที่การแจ้งเตือนจะเปิดแอป
6. ส่งข้อความทดสอบ FIAM
Firebase In App Messaging สามารถเรียกใช้งานได้จากเหตุการณ์ต่างๆ ของผู้ใช้ ข้อความทดสอบใช้เหตุการณ์เปิดแอปเพื่อทริกเกอร์ข้อความในแอป ส่งข้อความทดสอบ FIAM โดย:
- ตรวจสอบให้แน่ใจว่าแอปอยู่ในพื้นหลัง (ไปที่หน้าจอหลัก)
- ไปที่คอนโซล Firebase และเลือกการส่งข้อความในแอปในการนำทางด้านซ้าย
- เลือก สร้างแคมเปญแรกของคุณ
- เลือกแคมเปญแบนเนอร์ด้านบนและป้อนชื่อและเนื้อหาของข้อความ
- คลิก ทดสอบบนอุปกรณ์
- เพิ่ม ID การติดตั้งแล้วคลิก ทดสอบ
- เปิดแอปอีกครั้ง
- สังเกตในข้อความแอพ
7. ขอแสดงความยินดี
ขอแสดงความยินดี คุณส่งข้อความทั้ง FCM และ FIAM สำเร็จแล้ว ตอนนี้คุณรู้วิธีมีส่วนร่วมกับผู้ใช้ของคุณแล้ว ไม่ว่าพวกเขาจะใช้แอปของคุณในเบื้องหน้าหรือแอปของคุณอยู่ในเบื้องหลัง
อ่านเพิ่มเติม
อะไรต่อไป
- ส่งข้อความถึงผู้ใช้ในแอป Android ของคุณเอง