Phần bắt đầu nhanh này hướng dẫn bạn cách thiết lập Firebase In-App Messaging và gửi thông báo đầu tiên.
Trước khi bắt đầu
Trước khi bắt đầu, hãy nhớ thêm Firebase vào dự án Apple.
Thêm SDK Firebase In-App Messaging vào dự án
Sử dụng Trình quản lý gói Swift để cài đặt và quản lý các phần phụ thuộc Firebase.
- Trong Xcode, khi dự án ứng dụng đang mở, hãy chuyển đến File > Add Packages (Tệp > Thêm gói).
- Khi được nhắc, hãy thêm kho lưu trữ SDK của các nền tảng Apple Firebase:
- Chọn thư viện In-App Messaging.
- Thêm cờ
-ObjC
vào phần Other Linker Flags (Cờ trình liên kết khác) trong phần cài đặt bản dựng của mục tiêu. - Để sử dụng In-App Messaging, bạn phải bật Google Analytics trong dự án Firebase và thêm SDK Firebase cho Google Analytics vào ứng dụng. Bạn có thể chọn thư viện không có tính năng thu thập IDFA hoặc có tính năng thu thập IDFA.
- Khi hoàn tất, Xcode sẽ tự động bắt đầu phân giải và tải các phần phụ thuộc xuống ở chế độ nền.
https://github.com/firebase/firebase-ios-sdk.git
Bây giờ, hãy khởi chạy SDK trong ứng dụng:
- Nhập mô-đun Firebase trong cấu trúc
App
hoặcUIApplicationDelegate
nếu bạn chưa nhập:Swift
import Firebase
Objective-C
@import Firebase;
- Ngoài ra, hãy định cấu hình một thực thể dùng chung
FirebaseApp
, thường là trong trình khởi chạy củaApp
hoặc phương thứcapplication(_:didFinishLaunchingWithOptions:)
của uỷ quyền ứng dụng, nếu bạn chưa thực hiện:Swift
FirebaseApp.configure()
Objective-C
[FIRApp configure];
- Biên dịch và chạy ứng dụng của bạn.
Gửi tin nhắn thử nghiệm
Lấy mã cài đặt của ứng dụng
Để tiết kiệm pin, Firebase In-App Messaging chỉ truy xuất thư từ máy chủ một lần mỗi ngày. Điều đó có thể gây khó khăn cho việc kiểm thử, vì vậy, bảng điều khiển Firebase cho phép bạn chỉ định một thiết bị kiểm thử hiển thị thông báo theo yêu cầu.
Thiết bị thử nghiệm đó được xác định bằng mã cài đặt Firebase do dịch vụ cài đặt Firebase cung cấp. Để tìm mã cài đặt của ứng dụng kiểm thử, hãy chạy ứng dụng bằng đối số lệnh thời gian chạy -FIRDebugEnabled
:
- Khi dự án Xcode đang mở, hãy chọn Product > Scheme > Edit scheme... (Sản phẩm > Lược đồ > Chỉnh sửa lược đồ…) trên thanh trình đơn trên cùng.
- Mở thẻ Arguments (Đối số) của hộp thoại bật lên.
- Nhấp vào + Thêm mục trong phần Arguments Passed On Launch (Đối số được truyền khi khởi chạy).
- Nhập "-FIRDebugEnabled" vào trường mới tạo.
- Nhấp vào Close (Đóng), sau đó chạy ứng dụng.
Khi ứng dụng bắt đầu chạy, hãy tìm dòng sau trong nhật ký của bảng điều khiển Xcode:
[Firebase/InAppMessaging][I-IAM180017] Starting InAppMessaging runtime with Firebase Installation ID YOUR_INSTALLATION_ID
Gửi tin nhắn đến thiết bị thử nghiệm
Sau khi chạy ứng dụng trên thiết bị thử nghiệm và có mã cài đặt Firebase (FID), bạn có thể thử thiết lập Firebase In-App Messaging bằng cách gửi một thông báo kiểm thử:
- Trong bảng điều khiển Firebase, hãy mở trang Messaging (Nhắn tin).
- Nếu đây là chiến dịch đầu tiên của bạn, hãy nhấp vào Tạo chiến dịch đầu tiên.
- Chọn Thông báo trong ứng dụng Firebase rồi nhấp vào Tạo.
- Nếu không, trên thẻ Chiến dịch, hãy nhấp vào Chiến dịch mới.
- Chọn Nhắn tin trong ứng dụng.
- Nhập Tiêu đề cho thư đầu tiên.
- Nhấp vào Kiểm thử trên thiết bị
- Nhập mã cài đặt Firebase của ứng dụng trong trường Thêm mã cài đặt.
- Nhấp vào Kiểm thử để gửi tin nhắn.
Firebase In-App Messaging sẽ gửi tin nhắn thử nghiệm ngay khi bạn nhấp vào Kiểm thử. Để xem thông báo, bạn cần đóng rồi mở lại ứng dụng trên thiết bị thử nghiệm.
Để xác nhận xem thiết bị của bạn có phải là thiết bị thử nghiệm hay không, hãy tìm thông báo nhật ký sau:
[Firebase/InAppMessaging][I-IAM180017] Seeing test message in fetch response. Turn the current instance into a testing instance.