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

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

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

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

ข้อกำหนด

• บัญชี Pushwoosh
• โปรเจกต์ Pushwoosh ที่ตั้งค่าไว้ในบัญชีของคุณ
• สำหรับการผสานรวม iOS:
  • แพลตฟอร์ม iOS ที่กำหนดค่าให้ส่ง push notifications เราขอแนะนำให้ใช้ การกำหนดค่าการยืนยันตัวตนโดยใช้โทเค็น (Token-Based Authentication) เนื่องจากเป็นวิธีที่ง่ายที่สุด
  • ในระหว่างการตั้งค่า ให้ตั้งค่า Gateway เป็น Sandbox เพื่อส่ง push ไปยัง simulator
• สำหรับการผสานรวม Android:
  • แพลตฟอร์ม Android ที่กำหนดค่าแล้ว
  • project number (หรือที่เรียกว่า Sender ID), ไฟล์ google-services.json และ package name จากโปรเจกต์ Firebase ของคุณ
  • โปรเจกต์ Firebase ที่เชื่อมต่อกับแอปพลิเคชัน Android ของคุณ ทำตาม คู่มือการตั้งค่า Firebase หากจำเป็น
• Pushwoosh Application Code และ Pushwoosh Device API Token ของคุณจาก Pushwoosh Control Panel สำหรับแอปพลิเคชันของคุณ

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

# โคลนที่เก็บ SDK และไปยังโปรเจกต์ตัวอย่าง
git clone https://github.com/Pushwoosh/pushwoosh-flutter

# ไปยังไดเรกทอรีตัวอย่าง
cd pushwoosh-flutter/Source/pushwoosh/example

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

ติดตั้งส่วนประกอบที่จำเป็น:

flutter pub get

เปิด lib/main.dart และอัปเดตการเรียกใช้ Pushwoosh.initialize:

Pushwoosh.initialize({"app_id": "XXXXX-XXXXX", "sender_id": "XXXXXXXXXXXX"});

แทนที่ค่า app_id และ sender_id ด้วย Pushwoosh App Code และ Firebase Project Number ของคุณ

iOS

1. ติดตั้งส่วนประกอบที่จำเป็น

ไปยังไดเรกทอรี ios และติดตั้งส่วนประกอบที่จำเป็น:

cd ios && pod install --repo-update

2. ตั้งค่า Bundle Identifier

เปิดไฟล์ ios/Runner.xcworkspace ใน Xcode

ตั้งค่า Bundle Identifier สำหรับแต่ละเป้าหมาย:

• Runner: ชื่อแพ็กเกจของแอปของคุณ (เช่น com.example.pushwoosh)
• NotificationService: ชื่อแพ็กเกจของแอปของคุณพร้อม .NotificationServiceExtension (เช่น com.example.pushwoosh.NotificationServiceExtension)
• StopwatchWidgetExtension: ชื่อแพ็กเกจของแอปของคุณพร้อม .StopwatchWidget (เช่น com.example.pushwoosh.StopwatchWidget)

3. ตั้งค่า API Token

ใน ios/Runner/Info.plist ของคุณ ให้ตั้งค่าคีย์ Pushwoosh_API_TOKEN เป็น Pushwoosh Device API Token

Android

1. ตั้งค่า google-services.json

คัดลอกไฟล์ google-services.json ของคุณไปยังไดเรกทอรี android/app

2. ตั้งค่าชื่อแพ็กเกจ

เปิด android/app/build.gradle และตั้งค่า applicationId เป็นชื่อแพ็กเกจของแอปของคุณ (เช่น com.example.pushwoosh)

3. ตั้งค่า API Token

เปิดไฟล์ android/app/src/main/AndroidManifest.xml ของคุณและเพิ่มเมตาดาตาต่อไปนี้ภายในแท็ก <application>:

AndroidManifest.xml

<meta-data android:name="com.pushwoosh.apitoken" android:value="__YOUR_PUSHWOOSH_DEVICE_API_TOKEN__" />

แทนที่ __YOUR_PUSHWOOSH_DEVICE_API_TOKEN__ ด้วย Pushwoosh Device API Token ของคุณ

รันโปรเจกต์

1. สร้างและรันโปรเจกต์
2. แอปจะมีสองแท็บ: “Actions” และ “Settings” ไปยังแท็บ Settings
3. แตะปุ่ม Register for Pushes
4. อนุญาตการแจ้งเตือนแบบ push อุปกรณ์จะถูกลงทะเบียนกับ Pushwoosh

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

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