เริ่มต้นใช้งาน iOS SDK 7.0+ อย่างรวดเร็ว

เริ่มต้นใช้งาน Pushwoosh iOS SDK ด้วยตัวอย่างที่ง่ายและรวดเร็วนี้

มีอะไรใหม่ใน iOS SDK 7.0+

ตั้งแต่เวอร์ชัน 7.0 เป็นต้นไป Pushwoosh iOS SDK ได้รับการออกแบบใหม่ด้วยสถาปัตยกรรมแบบโมดูลาร์เต็มรูปแบบ ตอนนี้ SDK ถูกแบ่งออกเป็นโมดูลแยกกัน: PushwooshFramework, PushwooshCore, PushwooshBridge และ PushwooshLiveActivities เป็นสิ่งจำเป็นสำหรับการผสานรวมพื้นฐาน ในขณะที่ PushwooshForegroundPush, PushwooshVoIP และ PushwooshTVOS สามารถเพิ่มได้ตามความต้องการของคุณ

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

รีลีสนี้มีการรองรับ Swift Package Manager แบบเนทีฟเพื่อการจัดการ dependency ที่ง่ายขึ้น พร้อมกับการทำงานร่วมกับ Swift ที่ดีขึ้นในทุกโมดูล เอกสารประกอบตอนนี้ถูกฝังโดยตรงใน binary frameworks ทำให้คุณสามารถเข้าถึง API reference และตัวอย่างโค้ดได้โดยตรงใน Xcode ผ่าน Quick Help และหน้าต่าง Developer Documentation ฟีเจอร์ใหม่ๆ รวมถึงการรองรับ Live Activities ของ iOS 16+ อย่างเต็มรูปแบบพร้อมการผสานรวม Dynamic Island, การแจ้งเตือนแบบ push ในเบื้องหน้า (foreground push notifications) ที่ปรับแต่งได้พร้อมแบนเนอร์แบบเคลื่อนไหวและ haptic feedback, ความสามารถ VoIP ที่ปรับปรุงแล้ว และโมดูล tvOS โดยเฉพาะสำหรับแอปพลิเคชัน Apple TV

ข้อกำหนดเบื้องต้น

ในการผสานรวม Pushwoosh iOS SDK เข้ากับแอปของคุณ คุณจะต้องมีสิ่งต่อไปนี้:

ดาวน์โหลดโปรเจกต์ตัวอย่าง

โคลนโปรเจกต์ตัวอย่างจาก GitHub:

git clone https://github.com/Pushwoosh/pushwoosh-ios-sample.git

กำหนดค่าโปรเจกต์

Open the project in Xcode.
Add https://github.com/Pushwoosh/Pushwoosh-XCFramework as Swift Package Dependency.
Set the bundle identifier for the main target (PushwooshSampleApp) to match your Pushwoosh project (e.g., com.pushwoosh.PushwooshSampleApp).
Use the same bundle identifier for the NotificationService target, appending .NotificationService (e.g., com.pushwoosh.PushwooshSampleApp.NotificationService).
In Info.plist, set the:
- Pushwoosh_APPID key to the Pushwoosh Application Code
- Pushwoosh_API_TOKEN key to the Pushwoosh Device API Token

Important: Be sure to give the token access to the right app in your Pushwoosh Control Panel. Learn more

รันโปรเจกต์

Build และ run โปรเจกต์
แอปจะมีสองแท็บ: “Actions” และ “Settings” ไปที่แท็บ Settings
แตะปุ่ม Register for Pushes
ให้สิทธิ์สำหรับการแจ้งเตือนแบบ push อุปกรณ์จะถูกลงทะเบียนกับ Pushwoosh

คุณควรจะเห็น log entry ลักษณะนี้:

Pushwoosh: Initializing application runtime
[PW] BUNDLE ID: __YOUR_BUNDLE_ID__
[PW] APP CODE: __YOUR_APP_CODE__
[PW] PUSHWOOSH SDK VERSION: 7.0.0
[PW] HWID: __YOUR_HWID__
[PW] PUSH TOKEN: (null)
[PW] [I] -[PWNotificationManagerCompatiOS10] NotificationCenter authorization granted: 1
[PW] [I] -[PWPushNotificationsManagerCommon] Registered for push notifications: __YOUR_PUSH_TOKEN__

ตอนนี้อุปกรณ์ของคุณได้ลงทะเบียนกับ Pushwoosh แล้ว

ส่งการแจ้งเตือนแบบ push

กลับไปที่ Pushwoosh Control Panel และ ส่งการแจ้งเตือนแบบ push ไปยังอุปกรณ์ที่ลงทะเบียนไว้ของคุณ

การย้ายจาก SDK 6.x

หากคุณกำลังอัปเกรดจาก SDK เวอร์ชัน 6.x การเปลี่ยนแปลงหลักคือวิธีที่คุณเข้าถึง instance ของ Pushwoosh ในเวอร์ชัน 7.0+ ให้ใช้ Pushwoosh.configure แทน Pushwoosh.sharedInstance():

ก่อนหน้า (6.x):

Pushwoosh.sharedInstance().registerForPushNotifications()
Pushwoosh.sharedInstance().delegate = self

หลังจาก (7.0+):

Pushwoosh.configure.registerForPushNotifications()
Pushwoosh.configure.delegate = self

API อื่นๆ ทั้งหมดยังคงเหมือนเดิม ดังนั้นการอัปเดตโค้ดของคุณจึงต้องการเพียงแค่แทนที่ sharedInstance() ด้วย configure ทั่วทั้งโปรเจกต์ของคุณ

ขั้นตอนถัดไป

หากต้องการเรียนรู้เพิ่มเติม โปรดดูที่ คู่มือการผสานรวมพื้นฐาน