iOS

Hướng dẫn tích hợp mobile push cho iOS app.

1. Nếu bạn chưa có tài khoản, hãy đăng ký tại pushdy.com

1. Truy cập Dashboard 2. Tạo 1 ứng dụng nếu bạn chưa có

2. Thiết lập Mobile Push cho ứng dụng của bạn

1. Truy cập vào trang Settings. 2. Chọn Apple iOS để bắt đầu thiết lập.

3. Cấu hình Mobile Push cho iOS

  • APNS Environment: Lựa chọn môi trường Push Notification phù hợp với Apple Push Certificate của bạn

  • PEM file: Tải lên tệp tin Apple Push Certificate ở định dạng PEM.

  • Submit để lưu cấu hình.

Chú ý: Cách tạo tệp tin Certificate ở định dạng PEM được hướng dẫn chi tiết tại đây.

3. Cài đặt SDK cho iOS app

Bạn có thể tích hợp Pushdy cho iOS App sử dụng iOS Native SDK (hỗ trợ ngôn ngữ Objective-C và Swift) hoặc React Native SDK (ngôn ngữ lập trình Javascript).

Điều kiện: Project của bạn phải có Swift phiên bản từ 4.2 trở lên. Nếu bạn dùng React Native SDK thì bạn cần nâng cấp lên phiên bản react-native@0.60.x hoặc mới hơn. Và bạn cần phải thêm cờ use_frameworks! ở trong Podfile của project như hình dưới:

Cài đặt SDK: Đóng Xcode project và mở Terminal, đi tới thư mục gốc Xcode project của bạn và chạy các lệnh sau:

iOS Native SDK
React Native SDK
iOS Native SDK
pod 'PushdySDK'
React Native SDK
npm install react-native-pushdy --save
pod install --project-directory=ios

Sử dụng: Khai báo sử dụng Pushdy SDK như sau:

Objective-C
Swift
React Native: Objective-C
Objective-C
#import <PushdySDK/PushdySDK-Swift.h>
Swift
import PushdySDK
React Native: Objective-C
#import <react_native_pushdy/react_native_pushdy-Swift.h>

Mở file AppDelegate trong Xcode project của bạn và tìm tới hàm didFinishLaunchingWithOptions và thêm dòng code dưới đây, đừng quên thay YOUR_CLIENT_KEY bằng Client Key của trong App của bạn. Bạn có thể xem cách lấy trong phần Tạo ứng dụng.

Objective-C
Swift
React Native: Objective-C
Objective-C
NSString *clientKey = @"YOUR_CLIENT_KEY";
[Pushdy initWithClientKey:clientKey delegate:self launchOptions:launchOptions];
Swift
let clientKey = "YOUR_CLIENT_KEY"
Pushdy.initWith(clientKey: clientKey, delegate: self, launchOptions: launchOptions)
React Native: Objective-C
NSString *clientKey = @"YOUR_CLIENT_KEY";
[RNPushdy registerSdk:clientKey delegate:self launchOptions:launchOptions];

Bây giờ, bạn có thể gọi hàm để hiển thị cửa sổ xin quyền Push Notification theo logic của bạn. Chúng tôi khuyến nghị nên thiết kế 1 màn hình giải thích lý do và lợi ích nếu người dùng đồng ý bật Push Notification trước khi bạn gọi đoạn code này.

Objective-C
Swift
React Native: Javascript
Objective-C
[Pushdy registerForPushNotifications];
Swift
Pushdy.registerForPushNotifications()
React Native: Javascript
await Pushdy.initPushdy({
deviceId: 'YOUR DEVICE ID'
});

Sau khi bạn gọi đoạn code trên, trên App của bạn sẽ hiển thị như sau:

4. Bật tính năng Push Notification cho project của bạn sử dụng Xcode.

Mở project của bạn trên Xcode. Sau đó vào tab Capabilities và bật tính năng Push Notification như hình bên dưới.