# Capacitor SDK 빠른 시작

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

## 사전 요구 사항

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

<TranslatedFragment id="prerequisites-plugins" />

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

SDK 저장소를 복제합니다:
```bash
git clone https://github.com/Pushwoosh/pushwoosh-capacitor-plugin.git
```

플러그인 디렉토리로 이동합니다:
```bash
cd pushwoosh-capacitor-plugin
```

## 플러그인 빌드

예제 앱을 실행하기 전에 Capacitor 플러그인을 빌드해야 합니다.\
플러그인 종속성을 설치합니다:
```bash
npm i
```

플러그인을 빌드합니다:
```bash
npm run build
```

## 예제 앱 구성

예제 앱 디렉토리로 이동합니다:

```bash
cd example
```

앱 종속성을 설치합니다:

```bash
npm i
```

웹 에셋을 빌드합니다:

```bash
npm run build
```

**src/js/example.js**를 열고 `Pushwoosh.onDeviceReady` 호출을 업데이트합니다:

```javascript
Pushwoosh.onDeviceReady({
    appid: "__YOUR_APP_CODE__"
});
```

여기서:

`__YOUR_APP_CODE__`는 Pushwoosh Control Panel의 애플리케이션 코드입니다.

### iOS

###### 1. CocoaPods 종속성 설치

iOS 플랫폼 디렉토리로 이동하여 CocoaPods 종속성을 설치합니다:
```bash
cd ios/App
pod install --repo-update
cd ../..
```

###### 2. Capacitor를 iOS에 동기화

CocoaPods를 설치한 후 Capacitor 구성을 동기화합니다:

```bash
npx cap sync ios
```

###### 3. iOS 프로젝트 열기

Xcode에서 프로젝트를 엽니다:

```bash
npx cap open ios
```

###### 3. Bundle Identifier 설정

Xcode에서 **Bundle Identifier**를 앱의 패키지 이름(예: `com.example.pushwoosh`)으로 설정합니다.

###### 5. 기능 추가

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

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

###### 6. API 토큰 설정

Xcode에서 `ios/App/App/Info.plist`를 열고 [Pushwoosh Device API Token](/ko/developer/api-reference/api-access-token/#device-api-token)으로 다음 항목을 추가합니다:

```xml title="Info.plist"
<key>Pushwoosh_API_TOKEN</key>
<string>__YOUR_PUSHWOOSH_DEVICE_API_TOKEN__</string>
```

### Android

###### 1. Capacitor를 Android에 동기화

Capacitor 구성을 Android 플랫폼에 동기화합니다:

```bash
npx cap sync android
```

###### 2. google-services.json 설정

`google-services.json` 파일을 **android/app** 디렉토리로 복사합니다.

###### 3. 패키지 이름 설정

**android/app/build.gradle**을 열고 **applicationId**를 앱의 패키지 이름(예: `com.example.pushwoosh`)으로 설정합니다.

###### 4. 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)으로 교체합니다.

###### 5. Android 프로젝트 열기

Android Studio에서 프로젝트를 엽니다:

```bash
npx cap open android
```

## 프로젝트 실행

1. 프로젝트를 빌드하고 실행합니다.
2. **"Click Me!"** 버튼을 탭합니다.
3. 푸시 알림 권한을 부여합니다. 기기가 Pushwoosh에 등록됩니다.

## 푸시 알림 보내기

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