# Início rápido do SDK Capacitor

Comece a usar o SDK Capacitor da Pushwoosh com este exemplo rápido e simples

## Pré-requisitos

Para integrar o SDK Capacitor da Pushwoosh em seu aplicativo, você precisará do seguinte:

<TranslatedFragment id="prerequisites-plugins" />

## Baixe o projeto de exemplo

Clone o repositório do SDK:
```bash
git clone https://github.com/Pushwoosh/pushwoosh-capacitor-plugin.git
```

Navegue até o diretório do plugin:
```bash
cd pushwoosh-capacitor-plugin
```

## Compile o plugin

Antes de executar o aplicativo de exemplo, você precisa compilar o plugin Capacitor.\
Instale as dependências do plugin:
```bash
npm i
```

Compile o plugin:
```bash
npm run build
```

## Configure o aplicativo de exemplo

Navegue até o diretório do aplicativo de exemplo:

```bash
cd example
```

Instale as dependências do aplicativo:

```bash
npm i
```

Compile os ativos da web:

```bash
npm run build
```

Abra **src/js/example.js** e atualize a chamada `Pushwoosh.onDeviceReady`:

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

Onde:

`__YOUR_APP_CODE__` é o código do aplicativo do Painel de Controle da Pushwoosh.

### iOS

###### 1. Instale as dependências do CocoaPods

Navegue até o diretório da plataforma iOS e instale as dependências do CocoaPods:
```bash
cd ios/App
pod install --repo-update
cd ../..
```

###### 2. Sincronize o Capacitor com o iOS

Após instalar o CocoaPods, sincronize a configuração do Capacitor:

```bash
npx cap sync ios
```

###### 3. Abra o projeto iOS

Abra o projeto no Xcode:

```bash
npx cap open ios
```

###### 3. Defina o Bundle Identifier

No Xcode, defina o **Bundle Identifier** para o nome do pacote do seu aplicativo (por exemplo, `com.example.pushwoosh`).

###### 5. Adicione capacidades

Para habilitar as Notificações Push, você precisa adicionar certas capacidades.

Na seção `Signing & Capabilities`, adicione as seguintes capacidades:
- `Push Notifications`
- `Background Modes`. Após adicionar esta capacidade, marque a caixa para `Remote notifications`.

###### 6. Defina o Token da API

Abra `ios/App/App/Info.plist` no Xcode e adicione a seguinte entrada com seu [Token da API de Dispositivo da Pushwoosh](/pt/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. Sincronize o Capacitor com o Android

Sincronize a configuração do Capacitor com a plataforma Android:

```bash
npx cap sync android
```

###### 2. Configure o google-services.json

Copie seu arquivo `google-services.json` para o diretório **android/app**.

###### 3. Defina o nome do pacote

Abra **android/app/build.gradle** e defina o **applicationId** para o nome do pacote do seu aplicativo (por exemplo, `com.example.pushwoosh`).

###### 4. Defina o Token da API

Abra seu arquivo **android/app/src/main/AndroidManifest.xml** e adicione os seguintes metadados dentro da tag `<application>`:

```xml title="AndroidManifest.xml"
<meta-data android:name="com.pushwoosh.apitoken" android:value="__YOUR_PUSHWOOSH_DEVICE_API_TOKEN__" />
```
Substitua `__YOUR_PUSHWOOSH_DEVICE_API_TOKEN__` pelo seu [Token da API de Dispositivo da Pushwoosh](/pt/developer/api-reference/api-access-token/#device-api-token).

###### 5. Abra o projeto Android

Abra o projeto no Android Studio:

```bash
npx cap open android
```

## Execute o projeto

1. Compile e execute o projeto.
2. Toque no botão **"Click Me!"**.
3. Conceda permissão para notificações push. O dispositivo será registrado na Pushwoosh.

## Envie uma notificação push

Volte para o Painel de Controle da Pushwoosh e [envie uma notificação push](/pt/product/messaging-channels/push-notifications/send-push-notifications/one-time-push) para o seu dispositivo registrado.