# Démarrage rapide du SDK Cordova

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

## Prérequis

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

<TranslatedFragment id="prerequisites-plugins" />

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

```bash
# Clonez le dépôt du SDK et naviguez jusqu'au projet d'exemple
git clone https://github.com/Pushwoosh/pushwoosh-phonegap-plugin.git

# Naviguez jusqu'au répertoire de l'exemple
cd pushwoosh-phonegap-plugin/example/newdemo/
```

## Configurer le projet

Installez les dépendances :

```bash
npm i
```

Ajoutez le plugin Pushwoosh :
```bash
cordova plugin add ../../ --link --nofetch
```

Ouvrez **www/js/index.js** et mettez à jour l'appel `pushwoosh.onDeviceReady` :

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

Remplacez la valeur `appid` par votre **Code d'application Pushwoosh**.

### iOS

###### 1. Définir l'identifiant de l'ensemble (Bundle Identifier)

Ouvrez le fichier **platforms/ios/newdemo.xcworkspace** dans Xcode.

Définissez le **Bundle Identifier** pour chaque cible :

- `newdemo` : le nom du package de votre application. (par ex. com.example.pushwoosh)

###### 2. 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`.

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

Dans votre `ios/newdemo/Info.plist`, définissez la clé `Pushwoosh_API_TOKEN` sur le [Jeton d'API de l'appareil Pushwoosh](/fr/developer/api-reference/api-access-token/#device-api-token).

### Android

###### 1. Configurer google-services.json

Copiez votre fichier `google-services.json` dans le répertoire racine du projet.

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

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

###### 3. 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).

## Exécuter le projet

1. Compilez et exécutez le projet.
2. Basculez l'interrupteur **Register for notifications**.
3. Accordez l'autorisation pour les notifications push. L'appareil sera enregistré auprès de Pushwoosh.

## Envoyer une notification push

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