Inicio rápido del SDK de Cordova

Comience con el SDK de Cordova de Pushwoosh utilizando este ejemplo rápido y sencillo

Prerrequisitos

Para integrar el SDK de Cordova de Pushwoosh en su aplicación, necesitará lo siguiente:

Requisitos

• Una cuenta de Pushwoosh.
• Un proyecto de Pushwoosh configurado en su cuenta.
• Para la integración con iOS:
  • Una plataforma iOS configurada para enviar notificaciones push. Recomendamos usar la configuración de autenticación basada en token (Token-Based Authentication) como el enfoque más simple.
  • Durante la configuración, establezca el Gateway en Sandbox para enviar pushes a un simulador.
• Para la integración con Android:
  • Una plataforma Android configurada
  • El project number (también conocido como Sender ID), el archivo google-services.json y el package name de su proyecto de Firebase.
  • Un proyecto de Firebase conectado a su aplicación de Android. Siga la guía de configuración de Firebase si es necesario.
• Su Pushwoosh Application Code y su token de API de dispositivo de Pushwoosh (Pushwoosh Device API Token) desde el Panel de Control de Pushwoosh para su aplicación.

Descargar el proyecto de ejemplo

# Clone el repositorio del SDK y navegue hasta el proyecto de ejemplo
git clone https://github.com/Pushwoosh/pushwoosh-phonegap-plugin.git

# Navegue al directorio de ejemplo
cd pushwoosh-phonegap-plugin/example/newdemo/

Configurar el proyecto

Instale las dependencias:

npm i

Añada el plugin de Pushwoosh:

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

Abra www/js/index.js y actualice la llamada pushwoosh.onDeviceReady:

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

Reemplace los valores de appid y projectid con su Código de Aplicación de Pushwoosh y su Número de Proyecto de Firebase.

iOS

1. Establecer el Identificador de Paquete (Bundle Identifier)

Abra el archivo platforms/ios/newdemo.xcworkspace en Xcode.

Establezca el Identificador de Paquete (Bundle Identifier) para cada destino:

• newdemo: el nombre del paquete de su aplicación. (p. ej., com.example.pushwoosh)

2. Añadir capacidades (capabilities)

Para habilitar las Notificaciones Push, necesita añadir ciertas capacidades.

En la sección Signing & Capabilities, añada las siguientes capacidades:

• Push Notifications
• Background Modes. Después de añadir esta capacidad, marque la casilla para Remote notifications.

3. Establecer el Token de API

En su ios/newdemo/Info.plist, establezca la clave Pushwoosh_API_TOKEN con el Token de API de Dispositivo de Pushwoosh

Android

1. Configurar google-services.json

Copie su archivo google-services.json al directorio raíz del proyecto

2. Establecer el nombre del paquete

Abra android/app/build.gradle y establezca el applicationId con el nombre del paquete de su aplicación. (p. ej., com.example.pushwoosh)

3. Establecer el Token de API

Abra su archivo android/app/src/main/AndroidManifest.xml y añada los siguientes metadatos dentro de la etiqueta <application>:

AndroidManifest.xml

<meta-data android:name="com.pushwoosh.apitoken" android:value="__YOUR_PUSHWOOSH_DEVICE_API_TOKEN__" />

Reemplace __YOUR_PUSHWOOSH_DEVICE_API_TOKEN__ con su Token de API de Dispositivo de Pushwoosh.

Ejecutar el proyecto

1. Compile y ejecute el proyecto.
2. Active el interruptor Register for notifications.
3. Conceda permiso para las notificaciones push. El dispositivo se registrará en Pushwoosh.

Enviar una notificación push

Vuelva al Panel de Control de Pushwoosh y envíe una notificación push a su dispositivo registrado.