andreybeta / gcmpush

Titanium Module for Android Push

Titanium Module for Firebase Cloud Messaging Push Notifications for Android

A Titanium module for registering a device with Firebase Cloud Messaging and handling push notifications sent to the device.

Read the documentation.

Quickstart

1. Install this module using Axway Studio or via the CLI with gittio install nl.vanvianen.android.gcm
2. Set up your Firebase project.
3. Download the google-services.json file and put it in PROJECT_FOLDER/app/assets/android/ (or PROJECT_FOLDER/Resources/android/ for non-Alloy projects).
4. You are ready to receive Android push notifications! Check the documentation for further instructions and examples.

GCM to FCM Migration

If you are upgrading this module to version 3.0+, you will need to migrate to Firebase (Google will discontinue GCM in April 2019):

1. In the Firebase console, select Add Project
2. Select your GCM project from the list of existing Google Cloud Projects, and select Add Firebase
3. In the Firebase welcome screen, select Add Firebase to your Android App
4. Provide your package name (and optionally an SHA1 from your keystore) and select Add App. A new google-services.json file for your Firebase app is downloaded. Place this file in PROJECT_FOLDER/app/assets/android/ (or PROJECT_FOLDER/Resources/android/ for non-Alloy projects).
5. Update to version 3.0+ of this module
6. Check the Upgrade Guide for instructions about what needs to be altered in your code

Build

To build this module, you will need the prerequisites described in the Android Module Project documentation.

Then, simply cd into the module directory and run the following command:

$ appc ti build -p android --build-only

OR, if you are using just the open-source Titanium SDK:

$ ti build -p android --build-only

A zip file will be created in the dist folder.