cloud messaging post added

maciej-nowak · maciej-nowak · commit 9b2d8a53ea2b · 2019-02-07T19:57:03.000+01:00
diff --git a/_drafts/2019-02-11-tdd.md b/_drafts/2019-02-11-tdd.md
@@ -1,7 +1,7 @@
 ---
 layout: post
 title: "TDD"
-date:  2019-02-11
+date: 2019-02-11
 categories: ["Testowanie"]
 image: testing/tdd
 github: testing/tree/master/tdd
diff --git a/_drafts/2019-02-18-analiza_statyczna.md b/_drafts/2019-02-18-analiza_statyczna.md
@@ -1,7 +1,7 @@
 ---
 layout: post
 title: "Analiza statyczna"
-date:  2019-02-18
+date: 2019-02-18
 categories: ["Testowanie"]
 image: testing/static_analysis
 github: testing/tree/master/static_analysis
diff --git a/_drafts/2019-02-25-analytics.md b/_drafts/2019-02-25-analytics.md
@@ -1,7 +1,7 @@
 ---
 layout: post
 title: "Analytics"
-date:  2019-02-25
+date: 2019-02-25
 categories: ["Firebase"]
 image: firebase/analytics
 github: firebase/tree/master/analytics
diff --git a/_drafts/2019-03-04-crashlytics.md b/_drafts/2019-03-04-crashlytics.md
@@ -1,7 +1,7 @@
 ---
 layout: post
 title: "Crashlytics"
-date:  2019-03-04
+date: 2019-03-04
 categories: ["Firebase"]
 image: firebase/crashlytics
 github: firebase/tree/master/crashlytics
diff --git a/_drafts/2019-03-11-performance_monitoring.md b/_drafts/2019-03-11-performance_monitoring.md
@@ -1,7 +1,7 @@
 ---
 layout: post
 title: "Performance Monitoring"
-date:  2019-03-11
+date: 2019-03-11
 categories: ["Firebase"]
 image: firebase/performance_monitoring
 github: firebase/tree/master/performance_monitoring
diff --git a/_drafts/2019-03-18-test_lab.md b/_drafts/2019-03-18-test_lab.md
@@ -1,7 +1,7 @@
 ---
 layout: post
 title: "Test Lab"
-date:  2019-03-18
+date: 2019-03-18
 categories: ["Firebase"]
 image: firebase/test_lab
 description: "Firebase"
diff --git a/_drafts/2019-03-25-authentication.md b/_drafts/2019-03-25-authentication.md
@@ -1,7 +1,7 @@
 ---
 layout: post
 title: "Authentication"
-date:  2019-03-25
+date: 2019-03-25
 categories: ["Firebase"]
 image: firebase/authentication
 github: firebase/tree/master/authentication
diff --git a/_drafts/2019-04-01-cloud_storage.md b/_drafts/2019-04-01-cloud_storage.md
@@ -1,7 +1,7 @@
 ---
 layout: post
 title: "Cloud Storage"
-date:  2019-04-01
+date: 2019-04-01
 categories: ["Firebase"]
 image: firebase/cloud_storage
 github: firebase/tree/master/cloud_storage
diff --git a/_drafts/2019-04-08-cloud_firestore.md b/_drafts/2019-04-08-cloud_firestore.md
@@ -1,7 +1,7 @@
 ---
 layout: post
 title: "Cloud Firestore"
-date:  2019-04-08
+date: 2019-04-08
 categories: ["Firebase"]
 image: firebase/cloud_firestore
 github: firebase/tree/master/cloud_firestore
diff --git a/_drafts/2019-04-15-remote_config.md b/_drafts/2019-04-15-remote_config.md
@@ -1,7 +1,7 @@
 ---
 layout: post
 title: "Remote Config"
-date:  2019-04-08
+date: 2019-04-15
 categories: ["Firebase"]
 image: firebase/remote_config
 github: firebase/tree/master/remote_config
@@ -65,7 +65,4 @@ remoteConfig.fetch(36000L) //cache expiration for 10h
         val skin = remoteConfig.getString("skin")
         //do something with fetched values
     }
-{% endhighlight %}
-
-## Czas rzeczywisty
-//TODO
+{% endhighlight %}
diff --git a/_drafts/2019-04-22-cloud_messaging.md b/_drafts/2019-04-22-cloud_messaging.md
@@ -0,0 +1,170 @@
+---
+layout: post
+title: "Cloud Messaging"
+date: 2019-04-22
+categories: ["Firebase"]
+image: firebase/cloud_messaging
+github: firebase/tree/master/cloud_messaging
+description: "Firebase"
+version: Firebase-Firestore 17.3
+keywords: "firebase, chmura, cloud, message, notification, data, android, programowanie, programming"
+---
+
+## Wiadomość
+`Cloud Messaging` (`FCM`) dostarcza wiadomości do wybranych użytkowników aplikacji wysłanych z poziomu `konsoli Firebase`, usługi `Cloud Functions` lub zewnętrznego serwera. Wiadomości dzielą się na dwa typy: automatycznie wyświetlane notyfikacje oraz ręcznie obsługiwane wiadomości danych. W przypadku notyfikacji, gdy aplikacja jest w tle powiadomienia dostarczane są do zasobnika powiadomień, a kiedy działa na pierwszym planie wówczas obsługiwana jest przez funkcję zwrotną. Wiadomości mogą przyjmować format `JSON` i muszą zawierać polę `message`, składające się z pola `message.token` oraz `message.notification` (dla notyfikacji) lub `data` (dla wiadomości danych). Wiadomości mogą zawierać także jednocześnie oba pola: `notification` i `data`.
+
+{% highlight json %}
+{
+  "message":{
+    "token":"abcdefghijklmnopqrstuvwxyz",
+    "notification":{
+      "title":"text",
+      "body":"content"
+    }
+  }
+}
+
+{
+  "message":{
+    "token":"abcdefghijklmnopqrstuvwxyz",
+    "data":{
+      "value" : "some value",
+      "body" : "some body",
+    }
+  }
+}
+
+{
+  "message":{
+    "token":"abcdefghijklmnopqrstuvwxyz",
+    "notification":{
+      "title":"text",
+      "body":"content"
+    },
+    "data" : {
+      "value" : "some value",
+      "body" : "some body"
+    }
+  }
+}
+{% endhighlight %}
+
+Wiadomości konfigurowane pod różne platformy (`Android`, `iOS`, `web`) powinny przestrzegać zasad dostępności kluczy. Jeśli wiadomość kierowana jest do wielu platform wówczas należy używać kluczy ogólnych (`notification`, `data`, `notification.title`, `notification.body`), a w przypadku wysyłania tylko na jedną platformę należy wskazać typ (`android`, `apns`, `webpush`) i wykorzystać specyficzne klucze danej platformy (dla `Android` m.in. `ttl`, `priority`, `data`, `notification`).
+
+{% highlight json %}
+{
+  "message":{
+    "token":"abcdefghijklmnopqrstuvwxyz",
+    "notification":{
+      "title":"text",
+      "body":"content"
+    },
+    "android" : {
+      "ttl" : "36000s",
+      "notification": {
+        "click_action":"OPEN_SETTINGS"
+      }
+    }
+  }
+}
+{% endhighlight %}
+
+## Usługa
+Aby przetwarzać przychodzące wiadomości należy rozszerzyć klasę `FirebaseMessagingService`, zarejestrować usługę oraz dodać opcjonalne informacje w pliku `AndroidManifest`. Usługa `FirebaseMessagingService` odpowiedzialna jest za nasłuchiwanie i podejmowanie akcji dla otrzymanych wiadomości i przyznanego kodu `token`.
+
+{% highlight kotlin %}
+class FcmTokenService : FirebaseMessagingService() {
+
+    //override at least onNewToken, onMessageReceived and onDeletedMessages
+}
+{% endhighlight %}
+
+{% highlight xml %}
+<!-- register service -->
+<service android:name=".java.FcmTokenService">
+    <intent-filter>
+        <action android:name="com.google.firebase.MESSAGING_EVENT" />
+    </intent-filter>
+</service>
+
+<!-- optional add defaults -->
+<meta-data
+    android:name="com.google.firebase.messaging.default_notification_icon"
+    android:resource="@drawable/ic_notification" />
+<meta-data
+    android:name="com.google.firebase.messaging.default_notification_color"
+    android:resource="@color/colorNotification" />
+<meta-data
+    android:name="com.google.firebase.messaging.default_notification_channel_id"
+    android:value="@string/notification_channel_id" />
+{% endhighlight %}
+
+## Token
+Kluczem identyfikującym użytkownika w usłudze `Cloud Messaging` jest `token`, który przyznany przez aplikację powinien zostać wysłany na serwer dzięki czemu możliwym będzie rozpoznanie adresatów wiadomości. Warto mieć na uwadzę, że token może ulec zmianie m.in. w sytuacji usunięcia aplikacji czy wyczyszczenia danych w związku z czym należy rejestrować jego zmiany w metodzie `onNewToken`. Aby ręcznie pobrać bieżący token należy wywołać `FirebaseInstanceId.getInstance().instanceId`.
+
+{% highlight kotlin %}
+class FcmTokenService : FirebaseMessagingService() {
+
+    override fun onNewToken(token: String?) {
+        //send token to server to able to get messages
+    }
+
+    fun fetchCurrentToken() {
+        FirebaseInstanceId.getInstance().instanceId.addOnCompleteListener(OnCompleteListener { task ->
+            if (!task.isSuccessful) {
+                return@OnCompleteListener
+            }
+
+            //get token and do something
+            val token = task.result?.token
+        })
+    }
+}
+{% endhighlight %}
+
+## Odbieranie
+Zarządzanie otrzymanymi i usuniętymi wiadomościami możliwe jest przez nadpisanie metod `onMessageReceived` i `onDeletedMessages`. Metoda `onMessageReceived` dostarcza obsługi dla większości typów wiadomości za wyjątkiem wiadomości notyfikacji otrzymanych podczas działania aplikacji w tle, które trafiają do zasobnika systemowego. Domyślnie kliknięcie na notyfikacje powoduje uruchomienie `launcher` aplikacji, a opcjonalne dane z pola `data` zawarte są w kluczach `extras` obiektu `Intent`.
+
+{% highlight kotlin %}
+class FcmTokenService : FirebaseMessagingService() {
+
+    override fun onMessageReceived(remoteMessage: RemoteMessage?) {
+        //check message contains data payload
+        remoteMessage?.data?.isNotEmpty()?.let {
+            //prepare some action
+        }
+
+        //check message contains notification payload
+        remoteMessage?.notification?.let {
+            //prepare some action like show notification
+        }
+    }
+
+    override fun onDeletedMessages() {
+        //do something like server sync for deleted and not received message
+    }
+}
+{% endhighlight %}
+
+## Grupowanie
+Wiadomości mogą być wysyłane do grupy użytkowników na podstawie informacji przypisanych do konta, zapisanych do tematu (`topic`) lub należących do grupy urządzeń (zawiera dodatkowo autentykacje). W celu zapisania i wypisania klienta do tematu należy wywołać metodę `subscribeToTopic` lub `unsubscribeFromTopic`.
+
+{% highlight kotlin %}
+fun subscribeToTopic() {
+    FirebaseMessaging.getInstance().subscribeToTopic("title").addOnCompleteListener { task ->
+        if (!task.isSuccessful) {
+            //subscribe failed
+        }
+        //subscribe success
+    }
+}
+
+fun unsubscribeToTopic() {
+    FirebaseMessaging.getInstance().unsubscribeFromTopic("title").addOnCompleteListener { task ->
+        if (!task.isSuccessful) {
+            //unsubscribe failed
+        }
+        //unsubscribe success
+    }
+}
+{% endhighlight %}
diff --git a/assets/img/posts/firebase/cloud_messaging.jpg b/assets/img/posts/firebase/cloud_messaging.jpg
diff --git a/assets/img/posts/firebase/cloud_messaging_placehold.jpg b/assets/img/posts/firebase/cloud_messaging_placehold.jpg
diff --git a/assets/img/posts/firebase/cloud_messaging_thumb.jpg b/assets/img/posts/firebase/cloud_messaging_thumb.jpg
