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

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

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

ในการผสาน Pushwoosh React Native 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 สำหรับแอปพลิเคชันของคุณ

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

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

# ไปที่ไดเรกทอรี example
cd pushwoosh-react-native-plugin/example/demoapp/

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

ติดตั้ง dependencies:

npm install

เปิด Settings.js และอัปเดตการเรียก Pushwoosh.init:

Pushwoosh.init({ "pw_appid" : "__YOUR_APP_ID__", "project_number":"__YOUR_FCM_SENDER_ID__"});

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

iOS

1. ติดตั้ง dependencies

ไปที่ไดเรกทอรี ios และติดตั้ง dependencies:

cd ios && pod install --repo-update

2. ตั้งค่า Bundle Identifier

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

ตั้งค่า Bundle Identifier สำหรับแต่ละ target:

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

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. ตั้งค่า package name

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

3. ตั้งค่า API Token

เปิดไฟล์ android/app/src/main/AndroidManifest.xml ของคุณและเพิ่ม metadata ต่อไปนี้ภายในแท็ก <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 Push Notifications
4. ให้สิทธิ์สำหรับการแจ้งเตือนแบบพุช อุปกรณ์จะถูกลงทะเบียนกับ Pushwoosh

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

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