[ADD] mobile: Setup your Firebase Cloud Messaging

applications.rst

@@ -20,3 +20,4 @@ Applications
    livechat/livechat
    expense/expense
    general
+   mobile/firebase

mobile/firebase.rst

@@ -0,0 +1,79 @@
+:banner: banners/mobile.jpg
+
+======
+Mobile
+======
+
+Setup your Firebase Cloud Messaging
+===================================
+
+In order to have mobile notifications in our Android app, you need an
+API key.
+
+If it is not automatically configured (for instance for On-premise or
+Odoo.sh) please follow these steps below to get an API key for the
+android app.
+
+.. danger::
+   The iOS app doesn't support mobile notifications for Odoo
+   versions < 12.
+
+Firebase Settings
+=================
+
+Create a new project
+--------------------
+
+First, make sure you to sign in to your Google Account. Then, go to
+`https://console.firebase.google.com <https://console.firebase.google.com/>`__
+and create a new project.
+
+.. image:: media/firebase01.png
+   :align: center
+
+Choose a project name, click on **Continue**, then click on **Create
+project**.
+
+When you project is ready, click on **Continue**.
+
+You will be redirected to the overview project page (see next
+screenshot).
+
+Add an app
+----------
+
+In the overview page, click on the Android icon.
+
+.. image:: media/firebase02.png
+   :align: center
+
+You must use "com.odoo.com" as Android package name. Otherwise, it will
+not work.
+
+.. image:: media/firebase03.png
+   :align: center
+
+No need to download the config file, you can click on **Next** twice and
+skip the fourth step.
+
+Get generated API key
+---------------------
+
+On the overview page, go to Project settings:
+
+.. image:: media/firebase04.png
+   :align: center
+
+In **Cloud Messaging**, you will see the **API key** and the **Sender ID**
+that you need to set in Odoo General Settings.
+
+.. image:: media/firebase05.png
+   :align: center
+
+Settings in Odoo
+================
+
+Simply paste the API key and the Sender ID from Cloud Messaging.
+
+.. image:: media/firebase06.png
+   :align: center