Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
138 changes: 138 additions & 0 deletions README.es-ES.md
Original file line number Diff line number Diff line change
@@ -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.