ข้ามไปยังเนื้อหา
คู่มือผู้ใช้การสนับสนุน ขอสาธิต เข้าสู่ระบบ
Pushwoosh.com

เริ่มต้นใช้งาน iOS SDK 7.0+ ฉบับย่อ

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

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

Anchor link to

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

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

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

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

Anchor link to

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

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

Anchor link to

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

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

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

Anchor link to

  1. เปิดโปรเจกต์ใน Xcode

  2. เพิ่ม https://github.com/Pushwoosh/Pushwoosh-XCFramework เป็น Swift Package Dependency

  3. ตั้งค่า bundle identifier สำหรับ target หลัก (PushwooshSampleApp) ให้ตรงกับโปรเจกต์ Pushwoosh ของคุณ (เช่น com.pushwoosh.PushwooshSampleApp)

  4. ใช้ bundle identifier เดียวกันสำหรับ target NotificationService โดยต่อท้ายด้วย .NotificationService (เช่น com.pushwoosh.PushwooshSampleApp.NotificationService)

  5. ใน Info.plist ให้ตั้งค่า:

    • คีย์ Pushwoosh_APPID เป็น Pushwoosh Application Code
    • คีย์ Pushwoosh_API_TOKEN เป็น Pushwoosh Device API Token

สำคัญ: ตรวจสอบให้แน่ใจว่าได้ให้สิทธิ์ token ในการเข้าถึงแอปที่ถูกต้องใน Pushwoosh Control Panel ของคุณ เรียนรู้เพิ่มเติม

รันโปรเจกต์

Anchor link to
  1. Build และรันโปรเจกต์
  2. แอปจะมีสองแท็บคือ “Actions” และ “Settings” ไปที่แท็บ Settings
  3. แตะปุ่ม Register for Pushes
  4. ให้สิทธิ์สำหรับการแจ้งเตือนแบบพุช อุปกรณ์จะถูกลงทะเบียนกับ Pushwoosh

คุณควรจะเห็นรายการบันทึก (log) ดังนี้:

Terminal window
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 แล้ว

ส่งการแจ้งเตือนแบบพุช

Anchor link to

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

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

Anchor link to

หากคุณกำลังอัปเกรดจาก SDK เวอร์ชัน 6.x การเปลี่ยนแปลงหลักคือวิธีที่คุณเข้าถึงอินสแตนซ์ของ 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 ทั่วทั้งโปรเจกต์ของคุณ

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

Anchor link to

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