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

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

#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

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

[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.