# Démarrage rapide du SDK Capacitor

Démarrez avec le SDK Capacitor de Pushwoosh en utilisant cet exemple simple et rapide.

## Prérequis

Pour intégrer le SDK Capacitor de Pushwoosh dans votre application, vous aurez besoin des éléments suivants :

<TranslatedFragment id="prerequisites-plugins" />

## Télécharger le projet d'exemple

Clonez le dépôt du SDK :
```bash
git clone https://github.com/Pushwoosh/pushwoosh-capacitor-plugin.git
```

Accédez au répertoire du plugin :
```bash
cd pushwoosh-capacitor-plugin
```

## Compiler le plugin

Avant d'exécuter l'application d'exemple, vous devez compiler le plugin Capacitor.
Installez les dépendances du plugin :
```bash
npm i
```

Compilez le plugin :
```bash
npm run build
```

## Configurer l'application d'exemple

Accédez au répertoire de l'application d'exemple :

```bash
cd example
```

Installez les dépendances de l'application :

```bash
npm i
```

Compilez les assets web :

```bash
npm run build
```

Ouvrez **src/js/example.js** et mettez à jour l'appel `Pushwoosh.onDeviceReady` :

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

Où :

`__YOUR_APP_CODE__` est le code d'application du Control Panel de Pushwoosh.

### iOS

###### 1. Installer les dépendances CocoaPods

Accédez au répertoire de la plateforme iOS et installez les dépendances CocoaPods :
```bash
cd ios/App
pod install --repo-update
cd ../..
```

###### 2. Synchroniser Capacitor avec iOS

Après avoir installé CocoaPods, synchronisez la configuration de Capacitor :

```bash
npx cap sync ios
```

###### 3. Ouvrir le projet iOS

Ouvrez le projet dans Xcode :

```bash
npx cap open ios
```

###### 3. Définir le Bundle Identifier

Dans Xcode, définissez le **Bundle Identifier** sur le nom de package de votre application (par ex., `com.example.pushwoosh`).

###### 5. Ajouter des capacités

Pour activer les notifications Push, vous devez ajouter certaines capacités.

Dans la section `Signing & Capabilities`, ajoutez les capacités suivantes :
- `Push Notifications`
- `Background Modes`. Après avoir ajouté cette capacité, cochez la case `Remote notifications`.

###### 6. Définir le jeton d'API

Ouvrez `ios/App/App/Info.plist` dans Xcode et ajoutez l'entrée suivante avec votre [jeton d'API de l'appareil Pushwoosh](/fr/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. Synchroniser Capacitor avec Android

Synchronisez la configuration de Capacitor avec la plateforme Android :

```bash
npx cap sync android
```

###### 2. Configurer google-services.json

Copiez votre fichier `google-services.json` dans le répertoire **android/app**.

###### 3. Définir le nom du package

Ouvrez **android/app/build.gradle** et définissez l'**applicationId** sur le nom de package de votre application (par ex., `com.example.pushwoosh`).

###### 4. Définir le jeton d'API

Ouvrez votre fichier **android/app/src/main/AndroidManifest.xml** et ajoutez les métadonnées suivantes à l'intérieur de la balise `<application>` :

```xml title="AndroidManifest.xml"
<meta-data android:name="com.pushwoosh.apitoken" android:value="__YOUR_PUSHWOOSH_DEVICE_API_TOKEN__" />
```
Remplacez `__YOUR_PUSHWOOSH_DEVICE_API_TOKEN__` par votre [jeton d'API de l'appareil Pushwoosh](/fr/developer/api-reference/api-access-token/#device-api-token).

###### 5. Ouvrir le projet Android

Ouvrez le projet dans Android Studio :

```bash
npx cap open android
```

## Exécuter le projet

1. Compilez et exécutez le projet.
2. Appuyez sur le bouton **« Click Me! »**.
3. Accordez l'autorisation pour les notifications Push. L'appareil sera enregistré auprès de Pushwoosh.

## Envoyer une notification Push

Retournez au Control Panel de Pushwoosh et [envoyez une notification Push](/fr/product/messaging-channels/push-notifications/send-push-notifications/one-time-push) à votre appareil enregistré.