# Capacitor SDK Schnellstart

Starten Sie mit dem Pushwoosh Capacitor SDK mit diesem schnellen und einfachen Beispiel

## Voraussetzungen

Um das Pushwoosh Capacitor SDK in Ihre App zu integrieren, benötigen Sie Folgendes:

<TranslatedFragment id="prerequisites-plugins" />

## Das Beispielprojekt herunterladen

Klonen Sie das SDK-Repository:
```bash
git clone https://github.com/Pushwoosh/pushwoosh-capacitor-plugin.git
```

Navigieren Sie zum Plugin-Verzeichnis:
```bash
cd pushwoosh-capacitor-plugin
```

## Das Plugin erstellen

Bevor Sie die Beispiel-App ausführen, müssen Sie das Capacitor-Plugin erstellen.\
Installieren Sie die Plugin-Abhängigkeiten:
```bash
npm i
```

Erstellen Sie das Plugin:
```bash
npm run build
```

## Die Beispiel-App konfigurieren

Navigieren Sie zum Verzeichnis der Beispiel-App:

```bash
cd example
```

Installieren Sie die App-Abhängigkeiten:

```bash
npm i
```

Erstellen Sie die Web-Assets:

```bash
npm run build
```

Öffnen Sie **src/js/example.js** und aktualisieren Sie den `Pushwoosh.onDeviceReady`-Aufruf:

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

Wobei:

`__YOUR_APP_CODE__` ist der Anwendungscode aus dem Pushwoosh Control Panel.

### iOS

###### 1. CocoaPods-Abhängigkeiten installieren

Navigieren Sie zum iOS-Plattformverzeichnis und installieren Sie die CocoaPods-Abhängigkeiten:
```bash
cd ios/App
pod install --repo-update
cd ../..
```

###### 2. Capacitor mit iOS synchronisieren

Nach der Installation von CocoaPods synchronisieren Sie die Capacitor-Konfiguration:

```bash
npx cap sync ios
```

###### 3. Das iOS-Projekt öffnen

Öffnen Sie das Projekt in Xcode:

```bash
npx cap open ios
```

###### 3. Den Bundle Identifier festlegen

Legen Sie in Xcode den **Bundle Identifier** auf den Paketnamen Ihrer App fest (z. B. `com.example.pushwoosh`).

###### 5. Capabilities hinzufügen

Um Push-Benachrichtigungen zu aktivieren, müssen Sie bestimmte Capabilities hinzufügen.

Fügen Sie im Abschnitt `Signing & Capabilities` die folgenden Capabilities hinzu:
- `Push Notifications`
- `Background Modes`. Nachdem Sie diese Capability hinzugefügt haben, aktivieren Sie das Kontrollkästchen für `Remote notifications`.

###### 6. Den API-Token festlegen

Öffnen Sie `ios/App/App/Info.plist` in Xcode und fügen Sie den folgenden Eintrag mit Ihrem [Pushwoosh Device API Token](/de/developer/api-reference/api-access-token/#device-api-token) hinzu:

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

### Android

###### 1. Capacitor mit Android synchronisieren

Synchronisieren Sie die Capacitor-Konfiguration mit der Android-Plattform:

```bash
npx cap sync android
```

###### 2. google-services.json einrichten

Kopieren Sie Ihre `google-services.json`-Datei in das **android/app**-Verzeichnis.

###### 3. Den Paketnamen festlegen

Öffnen Sie **android/app/build.gradle** und legen Sie die **applicationId** auf den Paketnamen Ihrer App fest (z. B. `com.example.pushwoosh`).

###### 4. Den API-Token festlegen

Öffnen Sie Ihre **android/app/src/main/AndroidManifest.xml**-Datei und fügen Sie die folgenden Metadaten innerhalb des `<application>`-Tags hinzu:

```xml title="AndroidManifest.xml"
<meta-data android:name="com.pushwoosh.apitoken" android:value="__YOUR_PUSHWOOSH_DEVICE_API_TOKEN__" />
```
Ersetzen Sie `__YOUR_PUSHWOOSH_DEVICE_API_TOKEN__` durch Ihren [Pushwoosh Device API Token](/de/developer/api-reference/api-access-token/#device-api-token).

###### 5. Das Android-Projekt öffnen

Öffnen Sie das Projekt in Android Studio:

```bash
npx cap open android
```

## Das Projekt ausführen

1. Erstellen Sie das Projekt und führen Sie es aus.
2. Tippen Sie auf die Schaltfläche **„Click Me!“**.
3. Erteilen Sie die Erlaubnis für Push-Benachrichtigungen. Das Gerät wird bei Pushwoosh registriert.

## Eine Push-Benachrichtigung senden

Gehen Sie zurück zum Pushwoosh Control Panel und [senden Sie eine Push-Benachrichtigung](/de/product/messaging-channels/push-notifications/send-push-notifications/one-time-push) an Ihr registriertes Gerät.