diff --git a/README.es-ES.md b/README.es-ES.md new file mode 100644 index 0000000..2da8dd8 --- /dev/null +++ b/README.es-ES.md @@ -0,0 +1,138 @@ + + +NativeScript Firebase Cloud Messaging +===================================== + +Este es el complemento que añade soporte para FCM a una aplicación NativeScript. + + +EN DESARROLLO... Manténgase atento. +LA IMPLEMENTACIÓN PARA ANDROID ESTÁ COMPLETA. + + + +### Ejemplo de API + + var FCM = require('nativescript-fcm'); + + // Register token refresh listener + FCM.setTokenRefreshListener(function(e) { + sendTokenToBackend(e.token); + }); + + // Register message listener + FCM.setMessageListener(function(message, data) { + // message.messageId + // message.messageType + // message.sentTime + // message.ttl + // message.from + // message.to + // message.body + // message.title + // message.icon + // message.sound + // message.tag + // message.color + + // #data contains your custom key / values + }); + + // Start by requesting the token and sending it to the server. + // When token changes, you will receive EVENT_TOKEN_REFRESH event. + var token = FCM.getToken(); + if (token) { + sendTokenToBackend(token); + + // (Optionally) subscribe to a topic + FCM.subscribeToTopic("news"); + } else { + // ... Unable to get token ... + } + + +### Gestión del inicio de la aplicación + +Cuando el usuario toca la notificación, su aplicación se inicia con algunos +datos adicionales. Aquí le mostramos cómo extraerlos fácilmente en su `app.js`: + + var Application = require("application"); + var FCM = require("nativescript-fcm"); + + // On app launch, but before we do anything else, we check how + // exactly this app was started. + Application.on(Application.launchEvent, function(args) { + var notificationData = FCM.launchNotificationData(args); + + if (notificationData) { + console.log("Launched from notification:"); + console.log(JSON.stringify(notificationData)); + + // Normal notification: + // {"custom_key":"value","from":"1081060181241","collapse_key":"com.myapp.test"} + // + // Topic notification: + // {"from":"/topics/news","collapse_key":"com.myapp.test"} + + } else { + console.log("Normal launch"); + } + }); + + Application.start({ moduleName: "main-page" }); + + +## Android + +### Requisitos previos + +* Servicios de Google Play 30 +* Repositorio de Google 28 +* google-services.json generado en la consola de Firebase + (https://console.firebase.google.com) para su proyecto. + + + +### Instalación + +* En `app/App_Resources/Android/app.gradle` agregue el ID de su aplicación (puede + encontrarlo en `package.json`): + + android { + defaultConfig { + ... + applicationId "com.myapp.id" + ... + } + } + +* En `platforms/android/build.gradle`... + + * Cerca de la parte superior, agregue Google Services a la sección de dependencias de + la siguiente manera (el classpath de gradle ya debería estar allí): + + dependencies { + classpath "com.android.tools.build:gradle:1.5.0" + classpath "com.google.gms:google-services:3.0.0" + } + + * Al final, agregue el complemento de Google Services: + + apply plugin: "com.google.gms.google-services" + +* Coloque su `google-services.json` en la carpeta `platforms/android/`. + + + +### Solución de problemas + +*La compilación de TNS indica que no puede encontrar firebase-messaging o firebase-core.* + +No tiene instalado el SDK de Play services / repository correcto. Inicie +el Administrador de SDK de Android y búsquelos en la sección de Extras. + +*La compilación de TNS indica: "File google-services.json is missing. The Google Services Plugin cannot function without it."* + +Coloque su `google-services.json` en `platforms/android`. Puede que desee un +script personalizado que lo haga antes de la compilación, ya que este directorio puede +eliminarse.