Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


helloworld-push-Cordova: Basic Mobile Application showing the AeroGear Push feature

Author: Erik Jan de Wit (edewit)
Level: Beginner
Technologies: JavaScript Cordova
Summary: A basic example of Push : Registration and receiving messages.
Target Product: JBoss Mobile Add-On
Product Versions: 1.0.0
Source: https://github.com/aerogear/aerogear-push-helloworld/tree/master/cordova

What is it?

The helloworld project demonstrates how to include basic push functionality in Cordova applications using the AeroGear Cordova Push plug-in.

This simple project consists of a ready-to-build Cordova application. Before building the application, you must register the Android or iOS variant of the application with a running AeroGear UnifiedPush Server instance and Google Cloud Messaging for Android or Apple Push Notification Service for iOS. The resulting unique IDs and other parameters must then be inserted into the application source code. After this is complete, the application can be built and deployed to Android or iOS devices.

When the application is deployed to an Android or iOS device, the push functionality enables the device to register with the running AeroGear UnifiedPush Server instance and receive push notifications.

How do I run it?

###0. System requirements

The Cordova command line tooling is based on node.js so first you'll need to install node, then you can install Cordova by executing:

npm install -g cordova

To deploy on iOS you need to install the ios-deploy package as well

npm install -g ios-deploy


For iOS you'll need a valid provisioning profile as you will need to test on an actual device (push notification is not available when using a simulator). Replace the bundleId with your bundleId (the one associated with your certificate), by editing the config.xml at the root of this project, change the id attribute of the widget node. After that run a cordova platform rm ios followed by cordova platform add ios to change the Xcode project template.

If you want to change your bundleId later on, you will still have to run a cordova platform rm ios followed by cordova platform add ios to change the Xcode project template.


To deploy and run Cordova applications on Android the Android SDK needs to be installed.

You need to have a valid Firebase Cloud Messaging project setup. Download the google-services.json file and put it into the www directory. You also need to use the package from the Firebase Cloud Messaging configuration inside of the config.xml file. At the root of this project, change the id attribute of the widget node, to match your package.

###1. Register Application with Push Services

For the configuration and registration of Android or iOS Applications with PushServices, please refer to the specific guides inside helloworld-push-android and helloworld-push-ios.

###2. Customize and Build Application In www/push-config.json change "pushServerURL" with the url of your AeroGear UnifiedPush Server instance. You also need to change "senderID", "variantID" and "variantSecret" with the values assigned by UnifiedPush Server and GCM or APNS:

   "pushServerURL": "<pushServerURL e.g http(s)//host:port/context >",
   "android": {
      "senderID": "<senderID e.g Google Project ID only for android>",
      "variantID": "<variantID e.g. 1234456-234320>",
      "variantSecret": "<variantSecret e.g. 1234456-234320>"
   "ios": {
      "variantID": "<variantID e.g. 1234456-234320>",
      "variantSecret": "<variantSecret e.g. 1234456-234320>"

Note: You can also copy/paste these settings from your AeroGear UnifiedPush Server console

###3. Install platforms

After changing the push configuration you can install the platforms you want on the Cordova app. AeroGear Cordova PushPlugin currently supports Android and iOS.

cordova platform add <android or ios>

###4. Add the plugin

cordova plugin add aerogear-cordova-push

###5. Test Application

The application can be tested on physical Android or iOS devices only; push notifications are not available for Android emulators nor iOS simulators. To deploy, run and debug the application on an Android or iOS device attached to your system, on the command line enter the following:

cordova run <android or ios>

Send a Push Message

You can send a push notification to your device using the AeroGear UnifiedPush Server console by completing the following steps:

  1. Log into the AeroGear UnifiedPush Server console.
  2. Click Send Push.
  3. From the Applications list, select the application.
  4. In the Messages field, type the text to be sent as the push notification.
  5. Click Send Push Notification.


How does it work?


When you start the application Cordova will fire a deviceready event when Cordova initialization is done and the device is ready (see www/js/index.js). On this event the register function will be executed registering the device with the AeroGear UnifiedPush server. The first argument is a function that gets executed when the device receives a push event, followed by a success and errorCallback that are invoked when the register was successful or not and the last parameter is the push configuration that indicates where the push server is located and which variant/secret to use. When registration is successful it will display this on the UI. You can also verify that the registration was successful by going to the console there a new instance will have appeared with your deviceId, platform and status.

Run the HelloWorld in JBoss Developer Studio or Eclipse

Import the generated project into JBDS import

Select the project location and project import-helloworld

Add the plugin add plugin

Run the project on a device run

Debug the Application

Start a browser Chrome for Android or Safari for iOS


  • Develop -> <device name> -> index.html


  • Menu -> Tools -> Inspect Devices -> inspect