# Cordova SDK 빠른 시작

이 빠르고 간단한 예제를 사용하여 Pushwoosh Cordova SDK를 시작하세요

## 사전 요구 사항

Pushwoosh Cordova SDK를 앱에 통합하려면 다음이 필요합니다:

<TranslatedFragment id="prerequisites-plugins" />

## 예제 프로젝트 다운로드

```bash
# SDK 리포지토리를 복제하고 예제 프로젝트로 이동합니다
git clone https://github.com/Pushwoosh/pushwoosh-phonegap-plugin.git

# 예제 디렉토리로 이동합니다
cd pushwoosh-phonegap-plugin/example/newdemo/
```

## 프로젝트 구성

의존성을 설치합니다:

```bash
npm i
```

Pushwoosh 플러그인을 추가합니다:
```bash
cordova plugin add ../../ --link --nofetch
```

**www/js/index.js**를 열고 `pushwoosh.onDeviceReady` 호출을 업데이트합니다:

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

`appid` 값을 **Pushwoosh 앱 코드**로 교체하세요.

### iOS

###### 1. 번들 식별자 설정

Xcode에서 **platforms/ios/newdemo.xcworkspace** 파일을 엽니다.

각 타겟에 대해 **번들 식별자**를 설정합니다:

- `newdemo`: 앱의 패키지 이름. (예: com.example.pushwoosh)

###### 2. 기능 추가

푸시 알림을 활성화하려면 특정 기능을 추가해야 합니다.

Signing & Capabilities 섹션에서 다음 기능을 추가합니다:
- `Push Notifications`
- `Background Modes`. 이 기능을 추가한 후 `Remote notifications` 확인란을 선택합니다.

###### 3. API 토큰 설정

`ios/newdemo/Info.plist`에서 `Pushwoosh_API_TOKEN` 키를 [Pushwoosh Device API Token](/ko/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 토큰 설정

**android/app/src/main/AndroidManifest.xml** 파일을 열고 `<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](/ko/developer/api-reference/api-access-token/#device-api-token)으로 교체하세요.

## 프로젝트 실행

1. 프로젝트를 빌드하고 실행합니다.
2. **Register for notifications** 스위치를 토글합니다.
3. 푸시 알림 권한을 부여합니다. 기기가 Pushwoosh에 등록됩니다.

## 푸시 알림 보내기

Pushwoosh Control Panel로 돌아가 등록된 기기로 [푸시 알림을 보냅니다](/ko/product/messaging-channels/push-notifications/send-push-notifications/one-time-push).