เริ่มต้นใช้งานการรับส่งข้อความในแอปของ Firebase

การเริ่มต้นอย่างรวดเร็วนี้จะแสดงวิธีตั้งค่าการรับส่งข้อความในแอปของ Firebase และส่งข้อความแรก

iOS+ Android Flutter

ก่อนเริ่มต้น

ก่อนเริ่มต้น ให้ตรวจสอบว่าได้เพิ่ม Firebase ไปยังโปรเจ็กต์ Apple แล้ว

เพิ่ม Firebase In-App Messaging SDK ลงในโปรเจ็กต์

ใช้ Swift Package Manager เพื่อติดตั้งและจัดการทรัพยากร Dependency ของ Firebase

ไปที่คู่มือการติดตั้งของเราเพื่อดูข้อมูลเกี่ยวกับวิธีต่างๆ ในการเพิ่ม Firebase SDK ลงในโปรเจ็กต์ Apple รวมถึงการนําเข้าเฟรมเวิร์กโดยตรงและการใช้ CocoaPods

1. เปิดโปรเจ็กต์แอปใน Xcode แล้วไปที่ไฟล์ > เพิ่มแพ็กเกจ
2. เมื่อได้รับข้อความแจ้ง ให้เพิ่มที่เก็บ SDK สำหรับแพลตฟอร์ม Firebase ของ Apple ดังนี้

  https://github.com/firebase/firebase-ios-sdk.git

หมายเหตุ: โปรเจ็กต์ใหม่ควรใช้ SDK เวอร์ชันเริ่มต้น (ล่าสุด) แต่คุณเลือกเวอร์ชันเก่าได้หากจำเป็น
3. เลือกไลบรารีการรับส่งข้อความในแอป
4. เพิ่มแฟล็ก -ObjC ลงในส่วนแฟล็ก Linker อื่นๆ ของการตั้งค่าบิลด์ของเป้าหมาย
5. หากต้องการใช้การรับส่งข้อความในแอป คุณต้องเปิดใช้ Google Analytics ในโปรเจ็กต์ Firebase และเพิ่ม Firebase SDK สำหรับ Google Analytics ลงในแอป โดยคุณจะเลือกไลบรารีที่ไม่มีการรวบรวม IDFA หรือการเก็บรวบรวม IDFA ก็ได้
6. เมื่อเสร็จสิ้นแล้ว Xcode จะเริ่มแก้ปัญหาและดาวน์โหลดทรัพยากร Dependency ในเบื้องหลังโดยอัตโนมัติ

ต่อไป ให้เริ่มต้น SDK ในแอป ดังนี้

1. นำเข้าโมดูล Firebase ในโครงสร้าง App หรือ UIApplicationDelegate หากยังไม่ได้ทำ

   Swift

   import Firebase

   Objective-C

   @import Firebase;

2. นอกจากนี้ ให้กำหนดค่าอินสแตนซ์ที่แชร์ของ FirebaseApp ซึ่งโดยทั่วไปจะอยู่ในโปรแกรมเริ่มต้น App หรือเมธอด application(_:didFinishLaunchingWithOptions:) ของตัวแทนแอป หากยังไม่ได้ดำเนินการ

   Swift

   FirebaseApp.configure()

   Objective-C

   [FIRApp configure];

3. คอมไพล์และเรียกใช้แอป

หมายเหตุ: การรับส่งข้อความในแอปของ Firebase ต้องใช้ Firebase เวอร์ชัน 5.6.0 ขึ้นไป หากพบปัญหาในการคอมไพล์แอป ให้ลองเรียกใช้ pod update ในไดเรกทอรีโปรเจ็กต์ของแอป อย่างไรก็ตาม โปรดทราบว่าคำสั่งนี้จะอัปเดตทรัพยากร Dependency ทั้งหมดของแอป ไม่ใช่แค่ทรัพยากรใน Firebase

ส่งข้อความทดสอบ

รับรหัสการติดตั้งแอป

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

อุปกรณ์ทดสอบดังกล่าวจะกำหนดโดยรหัสการติดตั้ง Firebase ที่ให้ไว้โดยบริการติดตั้ง Firebase หากต้องการค้นหารหัสการติดตั้งแอปทดสอบ ให้เรียกใช้แอปด้วยอาร์กิวเมนต์คำสั่งรันไทม์ -FIRDebugEnabled ดังนี้

1. เมื่อโปรเจ็กต์ Xcode เปิดอยู่ ให้เลือก Product > Scheme > Edit Scheme... จากแถบเมนูด้านบน
2. เปิดแท็บอาร์กิวเมนต์ของกล่องโต้ตอบที่ปรากฏขึ้น
3. คลิก + เพิ่มรายการใต้อาร์กิวเมนต์ที่ผ่านเมื่อเปิดตัว
4. ป้อน "-FIRDebugEnabled" ในช่องที่สร้างขึ้นใหม่
5. คลิกปิด แล้วเรียกใช้แอป

เมื่อแอปของคุณเริ่มทำงาน ให้มองหาบรรทัดต่อไปนี้ในบันทึกของคอนโซล Xcode

[Firebase/InAppMessaging][I-IAM180017] Starting InAppMessaging runtime with Firebase Installation ID YOUR_INSTALLATION_ID

ส่งข้อความไปยังอุปกรณ์ทดสอบ

เมื่อเปิดตัวแอปในอุปกรณ์ทดสอบและมีรหัสการติดตั้ง Firebase (FID) แล้ว คุณจะลองใช้การตั้งค่าการรับส่งข้อความในแอปของ Firebase ได้โดยส่งข้อความทดสอบดังนี้

1. เปิดหน้าการรับส่งข้อความในคอนโซล Firebase
2. หากเป็นแคมเปญแรกของคุณ ให้คลิกสร้างแคมเปญแรกของคุณ
   1. เลือกข้อความในแอป Firebase แล้วคลิกสร้าง
3. หรือคลิกแคมเปญใหม่ในแท็บแคมเปญ
   1. เลือกการรับส่งข้อความในแอป
4. ป้อนชื่อสำหรับข้อความแรก
5. คลิกทดสอบในอุปกรณ์
6. ป้อนรหัสการติดตั้ง Firebase ของแอปในช่องเพิ่มรหัสการติดตั้ง
7. คลิกทดสอบเพื่อส่งข้อความ

การรับส่งข้อความในแอปของ Firebase จะส่งข้อความทดสอบทันทีที่คุณคลิกทดสอบ หากต้องการดูข้อความ คุณต้องปิดแล้วเปิดแอปอีกครั้งในอุปกรณ์ทดสอบ

หากต้องการยืนยันว่าอุปกรณ์ของคุณเป็นอุปกรณ์ทดสอบหรือไม่ ให้มองหาข้อความบันทึกต่อไปนี้

[Firebase/InAppMessaging][I-IAM180017] Seeing test message in fetch response. Turn the current instance into a testing instance.