Hướng dẫn bắt đầu nhanh này sẽ hướng dẫn bạn cách thiết lập Firebase In-App Messaging và gửi tin nhắn đầ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 của bạ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 của bạn đang mở, hãy chuyển đến 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 mục Cờ trình liên kết khác trong chế độ 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 xuống các phần phụ thuộc trong 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
của bạn hoặcUIApplicationDelegate
, nếu bạn chưa:Swift
import Firebase
Objective-C
@import Firebase;
- Đồng thời định cấu hình
FirebaseApp
thực thể dùng chung, thường là trong trình khởi chạy củaApp
hoặc trong thực thể uỷ quyền ứng dụng của bạnapplication(_:didFinishLaunchingWithOptions:)
, 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 tin nhắn từ máy chủ một lần mỗi ngày. Điều này có thể gây khó khăn cho việc thử nghiệm, vì vậy Bảng điều khiển Firebase cho phép bạn chỉ định một thiết bị thử nghiệm có hiển thị thông báo theo yêu cầu.
Thiết bị kiểm thử đó được xác định theo mã cài đặt Firebase do
Firebase dịch vụ lắp đặt. Để 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 của bạn đang mở, hãy chọn Sản phẩm > Lược đồ > Chỉnh sửa lược đồ... từ 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 của bạn.
Sau khi ứng dụng của bạn 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 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 vào trường Thêm mã cài đặt.
- Nhấp vào Kiểm thử để gửi tin nhắn.
Firebase In-App Messaging gửi thông báo thử nghiệm của bạn ngay khi bạn nhấp vào Kiểm tra. Để xem , bạn cần đóng, sau đó 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 những thông tin sau thông điệp nhật ký:
[Firebase/InAppMessaging][I-IAM180017] Seeing test message in fetch response. Turn the current instance into a testing instance.