# Быстрый старт с 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.

### 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. Добавьте capabilities

Чтобы включить Push-уведомления, необходимо добавить определенные capabilities.

В разделе `Signing & Capabilities` добавьте следующие capabilities:
- `Push Notifications`
- `Background Modes`. После добавления этой capability отметьте флажок `Remote notifications`.

###### 6. Установите API Token

Откройте `ios/App/App/Info.plist` в Xcode и добавьте следующую запись с вашим [Pushwoosh Device API Token](/ru/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 Token

Откройте ваш файл **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](/ru/developer/api-reference/api-access-token/#device-api-token).

###### 5. Откройте проект Android

Откройте проект в Android Studio:

```bash
npx cap open android
```

## Запустите проект

1. Соберите и запустите проект.
2. Нажмите кнопку **"Click Me!"**.
3. Предоставьте разрешение на получение push-уведомлений. Устройство будет зарегистрировано в Pushwoosh.

## Отправьте push-уведомление

Вернитесь в Панель управления Pushwoosh и [отправьте push-уведомление](/ru/product/messaging-channels/push-notifications/send-push-notifications/one-time-push) на ваше зарегистрированное устройство.