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

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

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

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

<TranslatedFragment id="prerequisites-plugins" />

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

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

# ไปที่ไดเรกทอรีตัวอย่าง
cd pushwoosh-phonegap-plugin/example/newdemo/
```

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

ติดตั้ง dependencies:

```bash
npm i
```

เพิ่มปลั๊กอิน Pushwoosh:
```bash
cordova plugin add ../../ --link --nofetch
```

เปิด **www/js/index.js** และอัปเดตการเรียก `pushwoosh.onDeviceReady`:

```javascript
pushwoosh.onDeviceReady({
    appid: "XXXXX-XXXXX"
});
```

แทนที่ค่า `appid` ด้วย **Pushwoosh App Code** ของคุณ

### iOS

###### 1. ตั้งค่า Bundle Identifier

เปิดไฟล์ **platforms/ios/newdemo.xcworkspace** ใน Xcode

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

- `newdemo`: ชื่อแพ็กเกจของแอปของคุณ (เช่น com.example.pushwoosh)

###### 2. เพิ่ม capabilities

ในการเปิดใช้งาน Push Notifications คุณต้องเพิ่ม capabilities บางอย่าง

ในส่วน Signing & Capabilities ให้เพิ่ม capabilities ต่อไปนี้:
- `Push Notifications`
- `Background Modes` หลังจากเพิ่ม capability นี้แล้ว ให้เลือกช่องสำหรับ `Remote notifications`

###### 3. ตั้งค่า API Token

ในไฟล์ `ios/newdemo/Info.plist` ของคุณ ให้ตั้งค่าคีย์ `Pushwoosh_API_TOKEN` เป็น [Pushwoosh Device API Token](/th/developer/api-reference/api-access-token/#device-api-token)

### Android

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

คัดลอกไฟล์ `google-services.json` ของคุณไปยังไดเรกทอรีรากของโปรเจกต์

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

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

###### 3. ตั้งค่า API Token

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

```xml title="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](/th/developer/api-reference/api-access-token/#device-api-token) ของคุณ

## รันโปรเจกต์

1. บิวด์และรันโปรเจกต์
2. สลับสวิตช์ **Register for notifications**
3. ให้สิทธิ์สำหรับการแจ้งเตือนแบบพุช อุปกรณ์จะถูกลงทะเบียนกับ Pushwoosh

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

กลับไปที่ Pushwoosh Control Panel และ [ส่งการแจ้งเตือนแบบพุช](/th/product/messaging-channels/push-notifications/send-push-notifications/one-time-push) ไปยังอุปกรณ์ที่ลงทะเบียนของคุณ