PhoneGap-Plugin-Push Version 1.4.0 Has Been Released

The latest release of the PushPlugin is now available on npm. This release is the long awaited release that is fully tested with iOS9. I was able to test on an iPhone 6+ running iOS 8.4.1, iPod Touch running iOS 9.0.2 and an iPad Air 2 running iOS 9.1.0. Please let me know if you run into any problems with this release.

On Android the switch over to using Gradle is now complete. The deprecated gcm.jar has been removed from the plugin and replaced with the Google Play Services GCM framework. Even better news is that PhoneGap Build now supports Gradle builds.

The big feature that people have been clamoring for is background or silent notifications. It is now possible for your 'notification' event handler to run when you app is in the background on iOS and Android (support for Windows coming soon).

1.4.0 (2015-10-27)

Full Changelog
Implemented enhancements:

• Use Google's InstanceID API #188

Closed issues:

• How to handle a re-installed app? #203
• interactive push notifications? #266
• Empty registrationId Android #265
• Run callback when clicking of notification body #261
• Android BUILD FAILED #251
• Re-register #250
• how to work in background ? #249
• installing plugin #244
• No Sound and vibration #242
• Unable to build apk #241
• still having problems with build. #239
• Registering on iOS 9 #238
• Custom sound repeated multiple times on Android #237
• Android: status bar notification is not shown #236
• Multiple Push Notifications - phonegap build #234
• error: cannot find symbol String token = InstanceID.getInstance(getApplicationContext()).getToken(senderID, GCM); #231
• Problem using "ledColor" and "VibrationPattern" #229
• Notification event receive, but not notification showing on android #228
• Events for registration not being fired #227
• 'registration' event not firing on windows phone #224
• Can i subscribe to a topic in using plugin? #219
• GCMIntentService.java:472: error: cannot find symbol iconColor #217
• Push Plugin registering on iOS 9 Devices but not showing Notification #216
• Receiving a notification "outside app" while in it? #213
• iOS push not working for device tokens when spaces removed #212
• Error: Plugin PushPlugin failed to install. #210
• Build error #205
• Android push.on('registration', cb) fires correctly on device, but not in emulator. #204
• 1.3.0 version not compatible with "crosswalk" by PGB #199
• How to get data on didReceiveNotification Background Process #198
• PushNotification is not defined in some devices #196
• not getting notifications on the Android device #195
• Installation Errors #186
• IOS: on registration fired twice #185
• Build failed with exit code 8 #184
• iOS: Not able to schedule local notification after adding the plugin #183
• How to show multiple notifications individually in android? #181
• iOS init option type #180
• Building for Android is a quest #179
• How do i tell if the user open the app by tapping the notification? #176
• IOS custom push sound when app is in background #175
• Hi guys please post full working procedure, I'm not able to get registration id also. Please help #174
• Has anyone tested this plugin on windows? #173

PhoneGap-Plugin-Push Version 1.3.0 Has Been Released

The latest release of the PushPlugin is now available on npm. This release switches the plugin over to using Gradle to include the Android Support Framework jar instead of it being included in the plugin. This should fix the issue where this plugin would conflict with others, like the Facebook plugin when building. Just make sure you have version 23 or later of the Android Support Library which can be installed from the Android SDK Manager.

Unfortunately, PhoneGap Build does not yet support Gradle so if you are using this plugin with PhoneGap Build you will need to use version 1.2.3 or earlier for the time being.

I know last time I said I would be making sure that iOS9 works with version 1.3.0 but I wanted to get that Gradle change out as quick as I could. Next release 1.4.0 will be full tested with iOS9 and I won't wait a full month, I'll release it just as soon as it's tested.

Full Change Log

1.3.0 (2015-09-21)

Implemented enhancements:

• How to use GCM 3.0 with this plugin? #127
• Android: possibility to send a notification with a title and without message #122
• Enhancement - Led, Vibration Pattern, Priority on Android #105

Fixed bugs:

• It is using in gcm data.additionalData ? #126
• iOS notification from cold boot #117
• Notification LED is not working #97

Closed issues:

• Know which version is used in build service #151
• Registration is not working in IOS9 #150
• build fail on android #149
• iconColor does not set icon background on Android #146
• Prevent windows toast notification when in foreground #145
• How to implement push notification for ios with this plug-in? #143
• After installing this plugin I can't build on Android #141
• version 1.2.3 #134
• New inbox style on android #131
• impossible to install the phonegap-plugin-push Error #130
• Hello, i am developing a cordova app which requires push notifications to be sent to users android phone, so i tried using this new phonegap push plugin as old one is deprecated, and it keeps giving me an error in console: Uncaught ReferenceError: module is not defined --- Line 154 Push.js and i dont have much experience with cordova, so can anyone assist me ? #128
• INVALID_REGISTRATION when http post request with to IOS #123
• Andriod :More than 2 notifications in status bar it is not works. #121
• Release notes for 1.2.x #119
• Google cloud messaging GCM - Push Notification not being sent (Server Side) #110

1.2.3 (2015-09-08)

Fixed bugs:

• Notification not showing..... #101
• Same data payload for messages with action buttons #90

Closed issues:

• Notification doesn't show the app icon #112
• Notification doesn't show the app icon #111
• Issue with plugin facebook connect #107
• Cordova Support #99
• Uncaught ReferenceError: cordova is not defined, http://localhost:8100/lib/push.js, Line: 7 #98
• Notifications never received on Android #96
• How know the way the app was launched #95
• Android, example doesn't work when it goes into background #94
• Utilizing push plugin #91

1.2.2 (2015-08-31)

Closed issues:

• PushPlugin notification icon is too big #88

1.2.1 (2015-08-31)

Implemented enhancements:

• Question about GCM Notifications and data in the message payload #87

Fixed bugs:

• Notification callback for pushes without a message #80

Closed issues:

• Android: No notification displayed on device. Notification event never called. #86
• it seem no wp8 version for now #56

PhoneGap-Plugin-Push Version 1.2.0 Released!

The latest release of the PushPlugin is now available on npm. This release focuses on bringing a number of enhancements to Android notifications.

Fear not fans of other platforms as subsequent releases will have more features for your OS of choice. In fact release 1.3.0 will center around iOS9 support.

Picture Notifications

Embed a large picture in your notification. You let the plugin know you want to display a picture by setting the style of the push to picture and then giving it a picture property.

For example:

{
    title:"Big Picture", 
    message: "This is my big picture message", 
    style: "picture",
    picture: "http://36.media.tumblr.com/c066cc2238103856c9ac506faa6f3bc2/tumblr_nmstmqtuo81tssmyno1_1280.jpg",
    summaryText: "The internet is built on cat pictures"
}

Produces the cat picture on the right.

Inbox Notifications

Instead of stacking notifications in the tray you can now add multiple notifications to a single entry in the tray by setting the style to inbox. The first notification that arrives looks like normal but the subsequent ones will look like an inbox.

For example:

{
    title:"My Title", 
    message: "My first message", 
    style: "inbox",
    summaryText: "There are %n% notifications"
}

Followed by:

{
    title:"My Title", 
    message: "My second message", 
    style: "inbox",
    summaryText: "There are %n% notifications"
}

Produces the notification above.

Finally, my favourite new addition...

Action Buttons

Your notification can include action buttons. If you wish to include an icon along with the button name they must be placed in the res/drawable directory of your Android project. Then you can send the following JSON from GCM:

{
    title:"AUX Scrum", 
    message: "Scrum: Daily touchbase @ 10am Please be on time so we can cover everything on the agenda.", 
    actions: [
        { icon: "emailGuests", title: "EMAIL GUESTS", callback: "app.emailGuests"},
        { icon: "snooze", title: "SNOOZE", callback: "app.snooze"},
    ]
}

This will produce the following notification in your tray:

When the user clicks on one of the buttons it will execute the JavaScript code you specified as a callback for that button.

Check out the plugin's README for more details.

Full Change Log
1.2.0 (2015-08-25)

Implemented enhancements:

• Implement Big Picture Style for Android #75
• Implement Inbox style for Android #74
• on("registration" is not getting called... #66
• multi-line text support #63
• Add image property to iOS and Android #39
• Programmatically register #31

Fixed bugs:

• Pushes being deleted from notification bar when cold start #67
• No default sound in Android #53
• Multiple push notification problem #48

Closed issues:

• oficial push plugin and windows and wp8 compatibility #71
• On Android, GCMIntentService.onError() doesn't get passed to the JavaScript "error" event #65
• Android: add property to vibrate phone on received notification #61
• push.on => "registration" will trigger twice times that only in iOS #57
• Publish plugin to PhoneGap Build #22

Merged pull requests:

• usage typo #60 (ericb)
• Updating example to sync with docs #52 (rakatyal)

PhoneGap-Plugin-Push Version 1.1.1 Released!

Back during PhoneGap Day EU 2015 I announced our new PushPlugin with it's normalized API and a promise of continued support. With the release of the 1.1.1 version of the plugin we continue to fulfill that promise with some new features and bug fixes.

The most exciting new feature in this release is official support for the Windows platform! This is thanks to the wonderful team at Microsoft who contributed to the plugin to make it happen. Special thanks to Raghav Katyal and Nikhi Khandelwal!

On the Android side of things you now have way more options on how to set what icon is displayed with your push notifications:

Check out the plugin's README for more details on how to setup the each of the image types.

Full Changelog
Implemented enhancements:

• iOS doesn't add foreground key #41
• Android: Notification icon problem #20
• iOS badge number #18
• How i can set icons for push notifications in status bar and push view in android #14
• Support Win8.1 + Phone 8.1 Universal Apps (WNS), drop support for WP8.0 (MPNS) #13

Fixed bugs:

• iOS only reads out "aps" payload #29
• Event not fired when in background #24
• Custom notification sound in background mode? #17

Closed issues:

• iOS only receives first notification in foreground #42
• Cannot register on iOS #30
• Fix Android paths in src folder #23
• PushNotification not defined #21
• Error trying to remove the plugin #19
• Handling multiple notifications on Android devices #12
• PGB (build.phonegap.com) problem #11
• reporting location via gcm #6

Merged pull requests:

• Updating Readme to document toast capable setting #47 (rakatyal)
• fix issue #41 #44 (Deminetix)
• fix issue #42 #43 (Deminetix)
• Adding hyperlinks to README #40 (rakatyal)
• Updating Readme #37 (rakatyal)
• Adding windows support to plugin #36 (rakatyal)
• Raghav/update #35 (rakatyal)
• Adding behavior for different notification types #28 (rakatyal)
• Initial commit to add support for windows universal platform #15 (rakatyal)

Video of PhoneGap Day EU 2015 - Push N' Pull Presentation

The video for my Push N' Pull presentation is now available.



If you want to get a copy of the slides please check out my previous post.

PhoneGap Day EU 2015 - Push N' Pull

Yesterday, I was happy to present at PhoneGap Day EU in Amsterdam. It's one of my favourite days of the year. Besides getting to hang out with all of my co-workers who I rarely get to see in person as we are separated by half a continent I get to talk in person with the people who use our software.

At PG Day I was presenting on the work that we've been doing in order to make the lives of developers easier. My presentation introduces the new and improved Push Plugin as well as the completely new Content Sync Plugin. I'll be blogging more about these two new plugins in the up coming weeks but for now if anyone wants to check out the slides they are embedded below:

PhoneGap Plugin Updates to TelephoneNumber, IMEI and TTS

I've updated the TelephoneNumber, IMEI and TTS plugins to use the Apache Cordova 2.2.0 API's. That means no more deprecation notices in the Java code and the JavaScript code uses the cordova.require method. However, I'm still slapping the objects into window.plugins so you shouldn't need to change any of your JavaScript code after upgrading.

This completes the upgrade of my plugins that everyone voted on. Next up will be some new work and hopefully I'll be able to get to that WebSpeech shim I've been threatening to do.

Installing the ChildBrowser Plugin on PhoneGap Android

I'm writing up a quick tutorial on how to get the ChildBrowser plugin for PhoneGap Android installed as a few folks on the mailing list are having troubles getting it going. First lets start off with a stock PhoneGap Android project in Eclipse:

Step one is to create the directory structure for the ChildBrowser.java file. Click on the src folder then right mouse click or control click on the folder.  From the popup menu select New and Package.

In the dialog box that appears type in com.phonegap.plugins.childBrowser then click the Finish button. Please note the package name is case sensitive so make sure it matches exactly.

Step two is adding the ChildBrowser.java class to your project.  Download the file from this link and save it in your projects src/com/phonegap/plugins/childBrowser directory.  Then click on you projects name then right mouse click and select Refresh.  Your project explorer should now look like this:

You shouldn't see any red exclamation marks at this point.  If you do you've probably named your package incorrectly.

Step three is to add the childbrowser.js file to your project.  Download the file from this link and save it in your projects assets/www directory. Then click on you projects name then right mouse click and select Refresh. Your project explorer should now look like this:

In step four we will need to modify the AndroidManifest.xml file to add an intent filter for the ChildBrowser.  Paste the following lines inside the <application/> tag:

<activity android:name="com.phonegap.DroidGap" android:label="@string/app_name">
<intent-filter>
</intent-filter>
</activity>

Here is a gist of what my AndroidManifest.xml looks like.

In step five we need to modify our index.html file to a reference the childbrowser.js and call the ChildBrowser.  In the <head/> tag after the reference to phonegap.0.9.5.js add the following line:

<script type="text/javascript" charset="utf-8" src="childbrowser.js"></script>

and somewhere in your <body/> tag add a line like this:

<a href="#" onclick="window.plugins.childBrowser.showWebPage('http://www.google.com');">Open Google.com in child browser</a>

This will give you an app that shows you this:

and opens Google in the ChildBrowser when you click on the link.

The full gist of my index.html is available as well.

Hope this helps everyone!