Início rápido do SDK Cordova

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

Pré-requisitos

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

Uma conta Pushwoosh.
Um projeto Pushwoosh configurado na sua conta.
Para integração com iOS:
- Uma plataforma iOS configurada para enviar notificações push. Recomendamos usar a configuração de Autenticação Baseada em Token como a abordagem mais simples.
- Durante a configuração, defina o Gateway como Sandbox para enviar pushes para um simulador.
Para integração com Android:
- Uma plataforma Android configurada
- O project number (também conhecido como Sender ID), o arquivo google-services.json e o package name do seu projeto Firebase.
- Um projeto Firebase conectado ao seu aplicativo Android. Siga o guia de configuração do Firebase se necessário.
Seu Pushwoosh Application Code e Token da API de Dispositivo Pushwoosh do Painel de Controle Pushwoosh para seu aplicativo.

Baixe o projeto de exemplo

# Clone o repositório do SDK e navegue para o projeto de exemplo
git clone https://github.com/Pushwoosh/pushwoosh-phonegap-plugin.git

# Navegue para o diretório de exemplo
cd pushwoosh-phonegap-plugin/example/newdemo/

Configure o projeto

Instale as dependências:

npm i

Adicione o plugin Pushwoosh:

cordova plugin add ../../ --link --nofetch

Abra www/js/index.js e atualize a chamada pushwoosh.onDeviceReady:

pushwoosh.onDeviceReady({
    appid: "XXXXX-XXXXX",
    projectid: "XXXXXXXXXXXXXXX"
});

Substitua os valores de appid e projectid pelo seu Código de Aplicativo Pushwoosh e Número do Projeto Firebase.

iOS

1. Defina o Bundle Identifier

Abra o arquivo platforms/ios/newdemo.xcworkspace no Xcode.

Defina o Bundle Identifier para cada alvo (target):

newdemo: o nome do pacote do seu aplicativo. (ex. com.example.pushwoosh)

2. Adicione capabilities (capacidades)

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

Na seção Signing & Capabilities, adicione as seguintes capabilities:

Push Notifications
Background Modes. Após adicionar esta capability, marque a caixa para Remote notifications.

3. Defina o Token da API

No seu arquivo ios/newdemo/Info.plist, defina a chave Pushwoosh_API_TOKEN para o Token da API de Dispositivo Pushwoosh

Android

1. Configure o google-services.json

Copie seu arquivo google-services.json para o diretório raiz do projeto.

2. Defina o nome do pacote

Abra android/app/build.gradle e defina o applicationId para o nome do pacote do seu aplicativo. (ex. com.example.pushwoosh)

3. Defina o Token da API

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

<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 Pushwoosh.

Execute o projeto

Compile e execute o projeto.
Ative o interruptor Register for notifications (Registrar para notificações).
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 para o seu dispositivo registrado.