From a86a91f3582e318d38ad7874a8865c878c996bbf Mon Sep 17 00:00:00 2001 From: Bob Easterday Date: Tue, 4 Dec 2012 11:35:38 -0800 Subject: [PATCH 001/133] Reference Cordove 2.2.0 and obscure sender id from example --- Example/index.html | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/Example/index.html b/Example/index.html index 2500876e..672c91dd 100755 --- a/Example/index.html +++ b/Example/index.html @@ -2,7 +2,7 @@ com.PhoneGap.c2dm - + @@ -18,7 +18,7 @@ pushNotification = window.plugins.pushNotification; if (device.platform == 'android' || device.platform == 'Android') { - pushNotification.register(successHandler, errorHandler, {"senderID":"661780372179","ecb":"onNotificationGCM"}); + pushNotification.register(successHandler, errorHandler, {"senderID":"replace_with_sender_id","ecb":"onNotificationGCM"}); } else { pushNotification.register(tokenHandler, errorHandler, {"badge":"true","sound":"true","alert":"true","ecb":"onNotificationAPN"}); } From 24b0e18a8799a66f29b21b12d2bb82cfbd77d2bf Mon Sep 17 00:00:00 2001 From: Bob Easterday Date: Wed, 19 Dec 2012 09:33:09 -0800 Subject: [PATCH 002/133] Cleanup documentation and sample layout --- Example/Sample_AndroidManifest.xml | 2 ++ Example/Sample_config.xml | 29 ++++++++++++++++++++++++++ Example/pushGCM.rb | 8 ------- Example/{ => server}/pushAPNS.rb | 0 Example/server/pushGCM.rb | 8 +++++++ Example/www/PushNotification.js | 28 +++++++++++++++++++++++++ Example/{ => www}/beep.wav | Bin Example/{ => www}/index.html | 2 +- Example/{ => www}/jquery_1.5.2.min.js | 0 README.md | 27 ++++++++++++------------ plugin.xml | 1 + 11 files changed, 83 insertions(+), 22 deletions(-) create mode 100644 Example/Sample_AndroidManifest.xml create mode 100755 Example/Sample_config.xml delete mode 100644 Example/pushGCM.rb rename Example/{ => server}/pushAPNS.rb (100%) create mode 100644 Example/server/pushGCM.rb create mode 100644 Example/www/PushNotification.js rename Example/{ => www}/beep.wav (100%) rename Example/{ => www}/index.html (98%) rename Example/{ => www}/jquery_1.5.2.min.js (100%) diff --git a/Example/Sample_AndroidManifest.xml b/Example/Sample_AndroidManifest.xml new file mode 100644 index 00000000..5cf6fa8a --- /dev/null +++ b/Example/Sample_AndroidManifest.xml @@ -0,0 +1,2 @@ + + \ No newline at end of file diff --git a/Example/Sample_config.xml b/Example/Sample_config.xml new file mode 100755 index 00000000..a38205e6 --- /dev/null +++ b/Example/Sample_config.xml @@ -0,0 +1,29 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/Example/pushGCM.rb b/Example/pushGCM.rb deleted file mode 100644 index 45b870a1..00000000 --- a/Example/pushGCM.rb +++ /dev/null @@ -1,8 +0,0 @@ -require 'rubygems' -require 'pushmeup' -GCM.host = 'https://android.googleapis.com/gcm/send' -GCM.format = :json -GCM.key = "AIzaSyB9bWG4OL5-m0eSE5PYaOhsE4lvKwpWBeg" -destination = ["APA91bHi2_juaN9NMBn8bh2rzC-VTg47E8DckJzxVyVr8zxOHI-IswZZibeyyNQo6Wj9u7XVHs_eizoILByPODGtYo71O0qjGaqOoloq6fRBc8DyhQCR1KmZY6qOlUJAKqE21pD5VGN9"] -data = {:message => "this is a test", :msgcnt => "1"} -GCM.send_notification( destination, data) diff --git a/Example/pushAPNS.rb b/Example/server/pushAPNS.rb similarity index 100% rename from Example/pushAPNS.rb rename to Example/server/pushAPNS.rb diff --git a/Example/server/pushGCM.rb b/Example/server/pushGCM.rb new file mode 100644 index 00000000..bfc81a4e --- /dev/null +++ b/Example/server/pushGCM.rb @@ -0,0 +1,8 @@ +require 'rubygems' +require 'pushmeup' +GCM.host = 'https://android.googleapis.com/gcm/send' +GCM.format = :json +GCM.key = "API_KEY_GOES_HERE" +destination = ["REGISTRATION_ID_GOES_HERE"] +data = {:message => "PhoneGap Build rocks!", :msgcnt => "1"} +GCM.send_notification( destination, data) diff --git a/Example/www/PushNotification.js b/Example/www/PushNotification.js new file mode 100644 index 00000000..77121cdc --- /dev/null +++ b/Example/www/PushNotification.js @@ -0,0 +1,28 @@ +(function(cordova) { + var cordovaRef = window.PhoneGap || window.Cordova || window.cordova; + + function PushNotification() {} + + // Call this to register for push notifications. Content of [options] depends on whether we are working with APNS (iOS) or GCM (Android) + PushNotification.prototype.register = function(successCallback, errorCallback, options) { + cordovaRef.exec(successCallback, errorCallback, "PushPlugin", "register", [options]); + }; + + // Call this to unregister for push notifications + PushNotification.prototype.unregister = function(successCallback, errorCallback) { + cordovaRef.exec(successCallback, errorCallback, "PushPlugin", "unregister", []); + }; + + + // Call this to set the application icon badge + PushNotification.prototype.setApplicationIconBadgeNumber = function(successCallback, badge) { + cordovaRef.exec(successCallback, successCallback, "PushPlugin", "setApplicationIconBadgeNumber", [{badge: badge}]); + }; + + cordova.addConstructor(function() { + if(!window.plugins) + window.plugins = {}; + window.plugins.pushNotification = new PushNotification(); + }); + + })(window.cordova || window.Cordova || window.PhoneGap); diff --git a/Example/beep.wav b/Example/www/beep.wav similarity index 100% rename from Example/beep.wav rename to Example/www/beep.wav diff --git a/Example/index.html b/Example/www/index.html similarity index 98% rename from Example/index.html rename to Example/www/index.html index 672c91dd..0f621e98 100755 --- a/Example/index.html +++ b/Example/www/index.html @@ -89,7 +89,7 @@
    -
  • Cordova Google Cloud Messaging Plugin Demo
    • +
  • Cordova PushNotification Plugin Demo
diff --git a/Example/jquery_1.5.2.min.js b/Example/www/jquery_1.5.2.min.js similarity index 100% rename from Example/jquery_1.5.2.min.js rename to Example/www/jquery_1.5.2.min.js diff --git a/README.md b/README.md index fc4fa2e0..e1211dca 100644 --- a/README.md +++ b/README.md @@ -40,6 +40,7 @@ Add the **com.google.android.gcm** and **com.plugin.GCM** packages to your proje Modify your **AndroidManifest.xml** and add the following lines to your manifest tag, replacing **your_app_package** with your app's package path: + @@ -47,7 +48,7 @@ Modify your **AndroidManifest.xml** and add the following lines to your manifest -Modify your **AndroidManifest.xml** and add the following lines to your application tag, replacing **your_app_package** with your app's package path: +Modify your **AndroidManifest.xml** and add the **receiver** and **service** tags to your **application** section, replacing **your_app_package** with your app's package path: (See the Sample_AndroidManifest.xml file in the Example folder.) @@ -57,15 +58,13 @@ Modify your **AndroidManifest.xml** and add the following lines to your applicat - - -Modify your **res/xml/plugins.xml** to include the following line in order to tell Cordova to include this plugin and where it can be found: +Modify your **res/xml/config.xml** to include the following line in order to tell Cordova to include this plugin and where it can be found: (See the Sample_config.xml file in the Example folder) -Add the **PushNotification.js** script to your assets/www folder (or javascripts folder, wherever you want really) and reference it in your main index.html file. +Add the **PushNotification.js** script to your assets/www folder (or javascripts folder, wherever you want really) and reference it in your main index.html file. This file's usage is described in the **Plugin API** section below. @@ -115,12 +114,16 @@ When deviceReady fires, get the plugin reference #### register This should be called as soon as the device becomes ready. On success, you will get a call to tokenHandler (iOS), or onNotificationGCM (Android), allowing you to obtain the device token or registration ID, respectively. Those values will typically get posted to your intermediary push server so it knows who it can send notifications to. + +For Android, If you have not already done so, you'll need to set up a Google API project, to generate your senderID. [Follow these steps](http://developer.android.com/guide/google/gcm/gs.html) to do so. This is described more fully in the **Test Environment** section below. + +In this example, sure and substitute your own senderID. Get your senderID by signing into to your [google dashboard](https://code.google.com/apis/console/). The senderID is found at **Overview->Dashboard->Project Number**. + if (device.platform == 'android' || device.platform == 'Android') { - pushNotification.register(successHandler, errorHandler,{"senderID":"661780372179","ecb":"onNotificationGCM"}); + pushNotification.register(successHandler, errorHandler,{"senderID":"replace_with_sender_id","ecb":"onNotificationGCM"}); } else { pushNotification.register(tokenHandler, errorHandler {"badge":"true","sound":"true","alert":"true","ecb":"onNotificationAPN"}); } - **successHandler** - called when a plugin method returns without error @@ -223,15 +226,13 @@ This plugin and its target Cordova application comprise the client application.T - You have successfully built a client with this plugin, on both iOS and Android and have installed them on a device. -#### 1) [Get the gem](https://github.com/NicosKaralis/pushmeup), either by downloading the zip or cloning the repo. - - a) cd to the pushmeup directory you just downloaded - b) sudo gem install pushmeup +#### 1) [Get the gem](https://github.com/NicosKaralis/pushmeup) + $ sudo gem install pushmeup #### 2) (iOS) [Follow this tutorial](http://www.raywenderlich.com/3443/apple-push-notification-services-tutorial-part-12) to create a file called ck.pem. Start at the section entitled "Generating the Certificate Signing Request (CSR)", and substitute your own Bundle Identifier, and Description. - a) go the this plugin's Example folder and open pushAPNS.rb in the text editor of your choice. + a) go the this plugin's Example/server folder and open pushAPNS.rb in the text editor of your choice. b) set the APNS.pem variable to the path of the ck.pem file you just created c) set APNS.pass to the password associated with the certificate you just created. (warning this is cleartext, so don't share this file) d) set device_token to the token for the device you want to send a push to. (you can run the Cordova app / plugin in Xcode and extract the token from the log messages) @@ -239,7 +240,7 @@ Start at the section entitled "Generating the Certificate Signing Request (CSR)" #### 3) (Android) [Follow these steps](http://developer.android.com/guide/google/gcm/gs.html) to generate a project ID and a server based API key. - a) go the this plugin's Example folder and open pushGCM.rb in the text editor of your choice. + a) go the this plugin's Example/server folder and open pushGCM.rb in the text editor of your choice. b) set the GCM.key variable to the API key you just generated. c) set the destination variable to the Registration ID of the device. (you can run the Cordova app / plugin in on a device via Eclipse and extract the regID from the log messages) diff --git a/plugin.xml b/plugin.xml index f19648f8..a900e121 100755 --- a/plugin.xml +++ b/plugin.xml @@ -13,6 +13,7 @@ + From e25e44dc853330d3540891123cdc6a692d334914 Mon Sep 17 00:00:00 2001 From: Bob Easterday Date: Wed, 19 Dec 2012 13:29:59 -0800 Subject: [PATCH 003/133] Cleanup file hierarchy and clarify it in manual installation section of readme --- README.md | 29 +++++++++++++++---- plugin.xml | 12 ++++---- .../android}/gcm/GCMBaseIntentService.java | 0 .../android}/gcm/GCMBroadcastReceiver.java | 0 .../google/android}/gcm/GCMConstants.java | 0 .../google/android}/gcm/GCMIntentService.java | 0 .../google/android}/gcm/GCMRegistrar.java | 0 .../plugin/GCM}/PushPlugin.java | 0 8 files changed, 30 insertions(+), 11 deletions(-) rename src/android/{ => com/google/android}/gcm/GCMBaseIntentService.java (100%) rename src/android/{ => com/google/android}/gcm/GCMBroadcastReceiver.java (100%) rename src/android/{ => com/google/android}/gcm/GCMConstants.java (100%) rename src/android/{ => com/google/android}/gcm/GCMIntentService.java (100%) rename src/android/{ => com/google/android}/gcm/GCMRegistrar.java (100%) rename src/android/{plugin => com/plugin/GCM}/PushPlugin.java (100%) diff --git a/README.md b/README.md index e1211dca..41ceac90 100644 --- a/README.md +++ b/README.md @@ -35,9 +35,28 @@ This plugin is for use with [Cordova](http://incubator.apache.org/cordova/), and ## Manual Installation for Android -Add the **com.google.android.gcm** and **com.plugin.GCM** packages to your project's src directory. -Modify your **AndroidManifest.xml** and add the following lines to your manifest tag, replacing **your_app_package** with your app's package path: +1) copy the contents of **src/android/com/** to your project's **src/com/** folder. The final hirearchy will likely look something like this; + + {project_folder} + src + com + google + android + gcm + GCMBaseIntentService.java + GCMBroadcastReceiver.java + GCMConstants.java + GCMIntentService.java + GCMRegistrar.java + plugin + GCM + PushPlugin.java + {company_name} + {intent_name} + {intent_name}.java + +2) Modify your **AndroidManifest.xml** and add the following lines to your manifest tag, replacing **your_app_package** with your app's package path: @@ -48,7 +67,7 @@ Modify your **AndroidManifest.xml** and add the following lines to your manifest -Modify your **AndroidManifest.xml** and add the **receiver** and **service** tags to your **application** section, replacing **your_app_package** with your app's package path: (See the Sample_AndroidManifest.xml file in the Example folder.) +3) Modify your **AndroidManifest.xml** and add the **receiver** and **service** tags to your **application** section, replacing **your_app_package** with your app's package path: (See the Sample_AndroidManifest.xml file in the Example folder.) @@ -60,11 +79,11 @@ Modify your **AndroidManifest.xml** and add the **receiver** and **service** tag -Modify your **res/xml/config.xml** to include the following line in order to tell Cordova to include this plugin and where it can be found: (See the Sample_config.xml file in the Example folder) +4) Modify your **res/xml/config.xml** to include the following line in order to tell Cordova to include this plugin and where it can be found: (See the Sample_config.xml file in the Example folder) -Add the **PushNotification.js** script to your assets/www folder (or javascripts folder, wherever you want really) and reference it in your main index.html file. This file's usage is described in the **Plugin API** section below. +5) Add the **PushNotification.js** script to your assets/www folder (or javascripts folder, wherever you want really) and reference it in your main index.html file. This file's usage is described in the **Plugin API** section below. diff --git a/plugin.xml b/plugin.xml index a900e121..9b3d9f1d 100755 --- a/plugin.xml +++ b/plugin.xml @@ -32,12 +32,12 @@ - - - - - - + + + + + + diff --git a/src/android/gcm/GCMBaseIntentService.java b/src/android/com/google/android/gcm/GCMBaseIntentService.java similarity index 100% rename from src/android/gcm/GCMBaseIntentService.java rename to src/android/com/google/android/gcm/GCMBaseIntentService.java diff --git a/src/android/gcm/GCMBroadcastReceiver.java b/src/android/com/google/android/gcm/GCMBroadcastReceiver.java similarity index 100% rename from src/android/gcm/GCMBroadcastReceiver.java rename to src/android/com/google/android/gcm/GCMBroadcastReceiver.java diff --git a/src/android/gcm/GCMConstants.java b/src/android/com/google/android/gcm/GCMConstants.java similarity index 100% rename from src/android/gcm/GCMConstants.java rename to src/android/com/google/android/gcm/GCMConstants.java diff --git a/src/android/gcm/GCMIntentService.java b/src/android/com/google/android/gcm/GCMIntentService.java similarity index 100% rename from src/android/gcm/GCMIntentService.java rename to src/android/com/google/android/gcm/GCMIntentService.java diff --git a/src/android/gcm/GCMRegistrar.java b/src/android/com/google/android/gcm/GCMRegistrar.java similarity index 100% rename from src/android/gcm/GCMRegistrar.java rename to src/android/com/google/android/gcm/GCMRegistrar.java diff --git a/src/android/plugin/PushPlugin.java b/src/android/com/plugin/GCM/PushPlugin.java similarity index 100% rename from src/android/plugin/PushPlugin.java rename to src/android/com/plugin/GCM/PushPlugin.java From ac095d7415c48ccded8bf85b524f8e0d024e9525 Mon Sep 17 00:00:00 2001 From: Bob Easterday Date: Thu, 17 Jan 2013 15:51:34 -0800 Subject: [PATCH 004/133] cleanup onLoad functionality --- Example/www/index.html | 27 ++++++++++++++------------- 1 file changed, 14 insertions(+), 13 deletions(-) diff --git a/Example/www/index.html b/Example/www/index.html index 0f621e98..6813b5e3 100755 --- a/Example/www/index.html +++ b/Example/www/index.html @@ -2,23 +2,21 @@ com.PhoneGap.c2dm - + + + - - + + document.addEventListener('deviceready', onDeviceReady, true); + + +
-
    -
  • Cordova PushNotification Plugin Demo
    • -
-
+
    +
  • Cordova PushNotification Plugin Demo
    • +
+ \ No newline at end of file From cb52942c80944e0fc211fc4f0babd73f53262ed3 Mon Sep 17 00:00:00 2001 From: Colene Date: Wed, 23 Jan 2013 16:51:43 -0800 Subject: [PATCH 005/133] Update README.md Fix apple link. --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 41ceac90..2ba8abc7 100644 --- a/README.md +++ b/README.md @@ -4,7 +4,7 @@ ## DESCRIPTION -This plugin is for use with [Cordova](http://incubator.apache.org/cordova/), and allows your application to receive push notifications on both Android and iOS devices. The Android implementation uses [Google's GCM (Google Cloud Messaging) service](http://developer.android.com/guide/google/gcm/index.html), whereas the iOS version is based on [Apple APNS Notifications](http://developer.android.com/guide/google/gcm/index.html) +This plugin is for use with [Cordova](http://incubator.apache.org/cordova/), and allows your application to receive push notifications on both Android and iOS devices. The Android implementation uses [Google's GCM (Google Cloud Messaging) service](http://developer.android.com/guide/google/gcm/index.html), whereas the iOS version is based on [Apple APNS Notifications](http://developer.apple.com/library/mac/#documentation/NetworkingInternet/Conceptual/RemoteNotificationsPG/ApplePushService/ApplePushService.html) **Important** - Push notifications are intended for real devices. The registration process will fail on the iOS simulator. Notifications can be made to work on the Android Emulator. However, doing so requires installation of some helper libraries, as outlined [here,](http://www.androidhive.info/2012/10/android-push-notifications-using-google-cloud-messaging-gcm-php-and-mysql/) under the section titled "Installing helper libraries and setting up the Emulator". From e52c125fa6990af510ffe199ac593f50777c216b Mon Sep 17 00:00:00 2001 From: Bob Easterday Date: Fri, 1 Feb 2013 16:59:54 -0800 Subject: [PATCH 006/133] Add compatibility with 2.3.0 --- plugin.xml | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/plugin.xml b/plugin.xml index 9b3d9f1d..19227d01 100755 --- a/plugin.xml +++ b/plugin.xml @@ -2,7 +2,7 @@ + version="1.0.1"> PushPlugin @@ -43,7 +43,14 @@ + + + + + + + From 1d660fe9147ae1b53a56fbaa894272a99a650aef Mon Sep 17 00:00:00 2001 From: Bob Easterday Date: Tue, 5 Feb 2013 13:32:58 -0800 Subject: [PATCH 007/133] Add support for background notifications --- Example/server/pushGCM.rb | 3 +- Example/www/index.html | 17 ++- plugin.xml | 5 +- .../google/android/gcm/GCMIntentService.java | 137 ++++++++++++++---- .../com/plugin/GCM/PushHandlerActivity.java | 66 +++++++++ 5 files changed, 194 insertions(+), 34 deletions(-) create mode 100644 src/android/com/plugin/GCM/PushHandlerActivity.java diff --git a/Example/server/pushGCM.rb b/Example/server/pushGCM.rb index bfc81a4e..e1efce5e 100644 --- a/Example/server/pushGCM.rb +++ b/Example/server/pushGCM.rb @@ -4,5 +4,6 @@ GCM.format = :json GCM.key = "API_KEY_GOES_HERE" destination = ["REGISTRATION_ID_GOES_HERE"] -data = {:message => "PhoneGap Build rocks!", :msgcnt => "1"} +data = {:message => "PhoneGap Build rocks!", :msgcnt => "1", :soundname => "beep.wav"} + GCM.send_notification( destination, data) diff --git a/Example/www/index.html b/Example/www/index.html index 6813b5e3..decbd60f 100755 --- a/Example/www/index.html +++ b/Example/www/index.html @@ -56,8 +56,21 @@ break; case 'message': - $("#app-status-ul").append('
  • MESSAGE -> MSG: ' + e.message + '
    • '); - $("#app-status-ul").append('
  • MESSAGE -> MSGCNT: ' + e.msgcnt + '
    • '); + // if this flag is set, this notification happened while we were in the foreground. + // you might want to play a sound to get the user's attention, throw up a dialog, etc. + if (e.foreground) + { + $("#app-status-ul").append('
  • --INLINE NOTIFICATION--' + '
    • '); + + // if the notification contains a soundname, play it. + var my_media = new Media("/android_asset/www/"+e.soundname); + my_media.play(); + } + else // otherwise we were launched because the user touched a notification in the notification tray. + $("#app-status-ul").append('
  • --BACKGROUND NOTIFICATION--' + '
    • '); + + $("#app-status-ul").append('
  • MESSAGE -> MSG: ' + e.message + '
    • '); + $("#app-status-ul").append('
  • MESSAGE -> MSGCNT: ' + e.msgcnt + '
    • '); break; case 'error': diff --git a/plugin.xml b/plugin.xml index 19227d01..28727fe6 100755 --- a/plugin.xml +++ b/plugin.xml @@ -2,7 +2,7 @@ + version="1.1.0"> PushPlugin @@ -13,6 +13,7 @@ + @@ -22,6 +23,7 @@ + @@ -38,6 +40,7 @@ +     diff --git a/src/android/com/google/android/gcm/GCMIntentService.java b/src/android/com/google/android/gcm/GCMIntentService.java index 79a13ca0..0252472e 100644 --- a/src/android/com/google/android/gcm/GCMIntentService.java +++ b/src/android/com/google/android/gcm/GCMIntentService.java @@ -1,18 +1,39 @@ package com.google.android.gcm; +import java.io.IOException; +import java.util.List; + +import com.plugin.GCM.PushHandlerActivity; import com.google.android.gcm.*; + +import org.apache.cordova.example.R; import org.json.JSONException; import org.json.JSONObject; + +import android.annotation.SuppressLint; +import android.app.ActivityManager; +import android.app.ActivityManager.RunningTaskInfo; +import android.app.Notification; +import android.app.NotificationManager; +import android.app.PendingIntent; import android.content.Context; import android.content.Intent; +import android.media.MediaPlayer; +import android.media.Ringtone; +import android.media.RingtoneManager; +import android.net.Uri; import android.os.Bundle; +import android.support.v4.app.NotificationCompat; +import android.support.v4.app.TaskStackBuilder; import android.util.Log; import com.plugin.GCM.PushPlugin; +@SuppressLint("NewApi") public class GCMIntentService extends GCMBaseIntentService { public static final String ME="GCMReceiver"; + public static final int notificationID = 237; public GCMIntentService() { super("GCMIntentService"); @@ -53,43 +74,99 @@ public void onUnregistered(Context context, String regId) { @Override protected void onMessage(Context context, Intent intent) { - Log.d(TAG, "onMessage - context: " + context); + Log.d(TAG, "onMessage - context: " + context); // Extract the payload from the message - Bundle extras = intent.getExtras(); - if (extras != null) { - try - { - JSONObject json; - json = new JSONObject().put("event", "message"); - - - // My application on my host server sends back to "EXTRAS" variables message and msgcnt - // Depending on how you build your server app you can specify what variables you want to send - // - json.put("message", extras.getString("message")); - json.put("msgcnt", extras.getString("msgcnt")); - - Log.v(ME + ":onMessage ", json.toString()); - - PushPlugin.sendJavascript( json ); - // Send the MESSAGE to the Javascript application - } - catch( JSONException e) - { - Log.e(ME + ":onMessage", "JSON exception"); - } - } - - + Bundle extras = intent.getExtras(); + if (extras != null) + { + boolean foreground = this.isInForeground(); + extras.putBoolean("foreground", foreground); + + // we can't call into the JS app if we are in the background + if (foreground) + { + try + { + JSONObject json; + json = new JSONObject().put("event", "message"); + + // My application on my host server sends back to "EXTRAS" variables message and msgcnt + // Depending on how you build your server app you can specify what variables you want to send + json.put("message", extras.getString("message")); + json.put("msgcnt", extras.getString("msgcnt")); + json.put("soundname", extras.getString("soundname")); + json.put("foreground", foreground); + + Log.v(ME + ":onMessage ", json.toString()); + + PushPlugin.sendJavascript( json ); + } + catch( JSONException e) + { + Log.e(ME + ":onMessage", "JSON exception"); + } + } + else + this.onReceive(context, extras); + } } + + // This is called for all notifications, whether the app is in the foreground or the background. + // This is so we can update any existing notification in the tray, for our app. + public void onReceive(Context context, Bundle extras) + { + NotificationManager mNotificationManager = (NotificationManager) getSystemService(Context.NOTIFICATION_SERVICE); + CharSequence appName = context.getPackageManager().getApplicationLabel(context.getApplicationInfo()); + if (null == appName) + appName = ""; + + Intent notificationIntent = new Intent(this, PushHandlerActivity.class); + notificationIntent.addFlags(Intent.FLAG_ACTIVITY_SINGLE_TOP | Intent.FLAG_ACTIVITY_CLEAR_TOP); + notificationIntent.putExtra("pushBundle", extras); + + PendingIntent contentIntent = PendingIntent.getActivity(this, 0, notificationIntent, 0); + + NotificationCompat.Builder mBuilder = new NotificationCompat.Builder(context) + .setSmallIcon(R.drawable.icon) + .setWhen(System.currentTimeMillis()) + .setContentTitle(appName) + .setTicker(appName) + .setContentText(extras.getString("message")) + .setNumber(Integer.parseInt(extras.getString("msgcnt"))) + .setContentIntent(contentIntent); + + mNotificationManager.notify(notificationID, mBuilder.build()); + + try + { + Uri notification = RingtoneManager.getDefaultUri(RingtoneManager.TYPE_NOTIFICATION); + Ringtone r = RingtoneManager.getRingtone(getApplicationContext(), notification); + r.play(); + } + catch (Exception e) + { + e.printStackTrace(); + } + } + + public boolean isInForeground() + { + ActivityManager activityManager = (ActivityManager) getApplicationContext().getSystemService(Context.ACTIVITY_SERVICE); + List services = activityManager + .getRunningTasks(Integer.MAX_VALUE); + + if (services.get(0).topActivity.getPackageName().toString() + .equalsIgnoreCase(getApplicationContext().getPackageName().toString())) + return true; + + return false; + } + @Override public void onError(Context context, String errorId) { Log.e(TAG, "onError - errorId: " + errorId); } - - - } diff --git a/src/android/com/plugin/GCM/PushHandlerActivity.java b/src/android/com/plugin/GCM/PushHandlerActivity.java new file mode 100644 index 00000000..6c3b6450 --- /dev/null +++ b/src/android/com/plugin/GCM/PushHandlerActivity.java @@ -0,0 +1,66 @@ +// +// PushHandlerActivity.java +// +// Pushwoosh Push Notifications SDK +// www.pushwoosh.com +// +// MIT Licensed + +package com.plugin.GCM; + +import org.json.JSONException; +import org.json.JSONObject; + +import android.app.Activity; +import android.content.Intent; +import android.os.Bundle; +import android.util.Log; + +public class PushHandlerActivity extends Activity +{ + @Override + public void onCreate(Bundle savedInstanceState) + { + super.onCreate(savedInstanceState); + handlePush(); + } + + private void handlePush() + { + // If we are here, it is because we were launched via a notification. It is up to the author to decide what to do with it. + // You may simply ignore it since the notification already fired in the background. Either way, the background flag + // will let you know what the state was when the notification fired. + Bundle extras = this.getIntent().getExtras(); + if (extras != null) + { + Bundle originalExtras = extras.getBundle("pushBundle"); + if (originalExtras != null) + { + try + { + JSONObject json; + json = new JSONObject().put("event", "message"); + + json.put("message", originalExtras.getString("message")); + json.put("msgcnt", originalExtras.getString("msgcnt")); + json.put("foreground", originalExtras.getBoolean("foreground")); + + Log.v("PushHandlerActivity:handlePush", json.toString()); + + PushPlugin.sendJavascript( json ); + } + catch( JSONException e) + { + Log.e("PushHandlerActivity:handlePush", "JSON exception"); + } + } + } + finish(); + } + + @Override + protected void onNewIntent(Intent intent) + { + super.onNewIntent(intent); + } +} From f854ec29ef9da0fae6cd85c59b5db4e300b83239 Mon Sep 17 00:00:00 2001 From: Bob Easterday Date: Tue, 5 Feb 2013 15:57:04 -0800 Subject: [PATCH 008/133] Add v13 compatibility shim --- plugin.xml | 2 +- src/android/com/plugin/android-support-v13.jar | Bin 0 -> 402581 bytes 2 files changed, 1 insertion(+), 1 deletion(-) create mode 100644 src/android/com/plugin/android-support-v13.jar diff --git a/plugin.xml b/plugin.xml index 28727fe6..ba7a64dd 100755 --- a/plugin.xml +++ b/plugin.xml @@ -41,7 +41,7 @@ - + diff --git a/src/android/com/plugin/android-support-v13.jar b/src/android/com/plugin/android-support-v13.jar new file mode 100644 index 0000000000000000000000000000000000000000..57b70721d6b8db1b60aa408e134954922f9dd990 GIT binary patch literal 402581 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
  • deviceready event received
    • '); - pushNotification = window.plugins.pushNotification; - if (device.platform == 'android' || device.platform == 'Android') { - pushNotification.register(successHandler, errorHandler, {"senderID":"661780372179","ecb":"onNotificationGCM"}); - } else { - pushNotification.register(tokenHandler, errorHandler, {"badge":"true","sound":"true","alert":"true","ecb":"onNotificationAPN"}); + try + { + pushNotification = window.plugins.pushNotification; + if (device.platform == 'android' || device.platform == 'Android') { + $("#app-status-ul").append('
  • registering android
    • '); + pushNotification.register(successHandler, errorHandler, {"senderID":"661780372179","ecb":"onNotificationGCM"}); + } else { + $("#app-status-ul").append('
  • registering iOS
    • '); + pushNotification.register(tokenHandler, errorHandler, {"badge":"true","sound":"true","alert":"true","ecb":"onNotificationAPN"}); + } } + catch(err) + { + txt="There was an error on this page.\n\n"; + txt+="Error description: " + err.message + "\n\n"; + alert(txt); + } } // handle APNS notifications for iOS - function onNotificationAPN(event) { - if (event.alert) { - $("#app-status-ul").append('
  • push-notification: ' + event.alert + '
    • '); - navigator.notification.alert(event.alert); - } + function onNotificationAPN(e) { - if (event.sound) { - var snd = new Media(event.sound); - snd.play(); + if (e.foreground) { + $("#app-status-ul").append('
  • --INLINE NOTIFICATION--' + '
    • '); + + if (e.sound) { + var snd = new Media(e.sound); + snd.play(); + } + + if (e.alert) { + $("#app-status-ul").append('
  • push-notification: ' + e.alert + '
    • '); + navigator.notification.alert(e.alert); + } + } + else { + $("#app-status-ul").append('
  • --BACKGROUND NOTIFICATION--' + '
    • '); + + if (e.alert) { + $("#app-status-ul").append('
  • push-notification: ' + e.alert + '
    • '); + } } - if (event.badge) { - pushNotification.setApplicationIconBadgeNumber(successHandler, event.badge); + if (e.badge) { + pushNotification.setApplicationIconBadgeNumber(successHandler, e.badge); } } @@ -74,17 +99,18 @@ break; case 'error': - $("#app-status-ul").append('
  • ERROR -> MSG:' + e.msg + '
    • '); + $("#app-status-ul").append('
  • ERROR -> MSG:' + e.msg + '
    • '); break; default: - $("#app-status-ul").append('
  • EVENT -> Unknown, an event was received and we do not know what it is
    • '); + $("#app-status-ul").append('
  • EVENT -> Unknown, an event was received and we do not know what it is
    • '); break; } } function tokenHandler (result) { $("#app-status-ul").append('
  • token: '+ result +'
    • '); + console.log("token = " + result); // Your iOS push server needs to know the token before it can push to this device // here is where you might want to send it the token for later use. } diff --git a/src/ios/AppDelegate+notification.m b/src/ios/AppDelegate+notification.m index 78eb1556..e563a0cb 100644 --- a/src/ios/AppDelegate+notification.m +++ b/src/ios/AppDelegate+notification.m @@ -41,6 +41,7 @@ - (void)application:(UIApplication *)application didReceiveRemoteNotification:(N if (appState == UIApplicationStateActive) { PushPlugin *pushHandler = [self getCommandInstance:@"PushPlugin"]; pushHandler.notificationMessage = [userInfo objectForKey:@"aps"]; + pushHandler.isInline = YES; [pushHandler notificationReceived]; } else { //save it for later diff --git a/src/ios/PushPlugin.h b/src/ios/PushPlugin.h index ef82acdf..9d7e4763 100644 --- a/src/ios/PushPlugin.h +++ b/src/ios/PushPlugin.h @@ -29,6 +29,7 @@ @interface PushPlugin : CDVPlugin { NSDictionary *notificationMessage; + BOOL isInline; NSString *notificationCallbackId; NSString *callback; @@ -40,6 +41,7 @@ @property (nonatomic, copy) NSString *callback; @property (nonatomic, retain) NSDictionary *notificationMessage; +@property BOOL isInline; - (void)register:(NSMutableArray *)arguments withDict:(NSMutableDictionary *)options; diff --git a/src/ios/PushPlugin.m b/src/ios/PushPlugin.m index af1096e1..990e9e1a 100644 --- a/src/ios/PushPlugin.m +++ b/src/ios/PushPlugin.m @@ -28,6 +28,7 @@ @implementation PushPlugin @synthesize notificationMessage; +@synthesize isInline; @synthesize callbackId; @synthesize notificationCallbackId; @@ -70,6 +71,8 @@ - (void)register:(NSMutableArray *)arguments withDict:(NSMutableDictionary *)opt if (notificationTypes == UIRemoteNotificationTypeNone) NSLog(@"PushPlugin.register: Push notification type is set to none"); + isInline = NO; + [[UIApplication sharedApplication] registerForRemoteNotificationTypes:notificationTypes]; } @@ -163,6 +166,12 @@ - (void)notificationReceived { if ([notificationMessage objectForKey:@"badge"]) [jsonStr appendFormat:@"badge:%d,", [[notificationMessage objectForKey:@"badge"] intValue]]; + if (isInline) + { + [jsonStr appendFormat:@"foreground:'%d',", 1]; + isInline = NO; + } + if ([notificationMessage objectForKey:@"sound"]) [jsonStr appendFormat:@"sound:'%@',", [notificationMessage objectForKey:@"sound"]]; From 60cb9c779deeac21e49bfa7fdb5bb734b8de0a2f Mon Sep 17 00:00:00 2001 From: Bob Easterday Date: Wed, 13 Feb 2013 16:58:23 -0800 Subject: [PATCH 013/133] send entire payload to JS app --- Example/www/index.html | 36 ++++-- .../google/android/gcm/GCMIntentService.java | 34 +----- .../com/plugin/GCM/PushHandlerActivity.java | 103 ++++++++++++++---- src/android/com/plugin/GCM/PushPlugin.java | 2 +- 4 files changed, 115 insertions(+), 60 deletions(-) diff --git a/Example/www/index.html b/Example/www/index.html index 0fad81ae..c6264f73 100755 --- a/Example/www/index.html +++ b/Example/www/index.html @@ -16,6 +16,22 @@ function onDeviceReady() { $("#app-status-ul").append('
  • deviceready event received
    • '); + document.addEventListener("backbutton", function(e) + { + $("#app-status-ul").append('
  • backbutton event received
    • '); + + if( $("#home").length > 0) + { + e.preventDefault(); + pushNotification.unregister(successHandler, errorHandler); + navigator.app.exitApp(); + } + else + { + navigator.app.backHistory(); + } + }, false); + try { pushNotification = window.plugins.pushNotification; @@ -37,8 +53,7 @@ // handle APNS notifications for iOS function onNotificationAPN(e) { - - if (e.foreground) { + if (e.foreground) { $("#app-status-ul").append('
  • --INLINE NOTIFICATION--' + '
    • '); if (e.sound) { @@ -93,9 +108,9 @@ } else // otherwise we were launched because the user touched a notification in the notification tray. $("#app-status-ul").append('
  • --BACKGROUND NOTIFICATION--' + '
    • '); - - $("#app-status-ul").append('
  • MESSAGE -> MSG: ' + e.message + '
    • '); - $("#app-status-ul").append('
  • MESSAGE -> MSGCNT: ' + e.msgcnt + '
    • '); + + $("#app-status-ul").append('
  • MESSAGE -> MSG: ' + e.payload.message + '
    • '); + $("#app-status-ul").append('
  • MESSAGE -> MSGCNT: ' + e.payload.msgcnt + '
    • '); break; case 'error': @@ -126,11 +141,12 @@ document.addEventListener('deviceready', onDeviceReady, true); - -
    -
      -
    • Cordova PushNotification Plugin Demo
      • -
    +
    +
    +
      +
    • Cordova PushNotification Plugin Demo
      • +
    +
    \ No newline at end of file diff --git a/src/android/com/google/android/gcm/GCMIntentService.java b/src/android/com/google/android/gcm/GCMIntentService.java index 95f40248..bfece58a 100644 --- a/src/android/com/google/android/gcm/GCMIntentService.java +++ b/src/android/com/google/android/gcm/GCMIntentService.java @@ -5,7 +5,9 @@ import com.plugin.GCM.PushHandlerActivity; import com.google.android.gcm.*; +import java.util.Iterator; +import org.json.JSONArray; import org.json.JSONException; import org.json.JSONObject; @@ -80,39 +82,16 @@ protected void onMessage(Context context, Intent intent) { if (extras != null) { boolean foreground = this.isInForeground(); + extras.putBoolean("foreground", foreground); - // we can't call into the JS app if we are in the background if (foreground) - { - try - { - JSONObject json; - json = new JSONObject().put("event", "message"); - - // My application on my host server sends back to "EXTRAS" variables message and msgcnt - // Depending on how you build your server app you can specify what variables you want to send - json.put("message", extras.getString("message")); - json.put("msgcnt", extras.getString("msgcnt")); - json.put("soundname", extras.getString("soundname")); - json.put("foreground", foreground); - - Log.v(ME + ":onMessage ", json.toString()); - - PushPlugin.sendJavascript( json ); - } - catch( JSONException e) - { - Log.e(ME + ":onMessage", "JSON exception"); - } - } + PushHandlerActivity.sendToApp(extras); else this.onReceive(context, extras); - } + } } - // This is called for all notifications, whether the app is in the foreground or the background. - // This is so we can update any existing notification in the tray, for our app. public void onReceive(Context context, Bundle extras) { NotificationManager mNotificationManager = (NotificationManager) getSystemService(Context.NOTIFICATION_SERVICE); @@ -160,8 +139,7 @@ public boolean isInForeground() return true; return false; - } - + } @Override public void onError(Context context, String errorId) { diff --git a/src/android/com/plugin/GCM/PushHandlerActivity.java b/src/android/com/plugin/GCM/PushHandlerActivity.java index 6c3b6450..1905ad2f 100644 --- a/src/android/com/plugin/GCM/PushHandlerActivity.java +++ b/src/android/com/plugin/GCM/PushHandlerActivity.java @@ -8,6 +8,9 @@ package com.plugin.GCM; +import java.util.Iterator; + +import org.json.JSONArray; import org.json.JSONException; import org.json.JSONObject; @@ -35,28 +38,86 @@ private void handlePush() { Bundle originalExtras = extras.getBundle("pushBundle"); if (originalExtras != null) - { - try - { - JSONObject json; - json = new JSONObject().put("event", "message"); - - json.put("message", originalExtras.getString("message")); - json.put("msgcnt", originalExtras.getString("msgcnt")); - json.put("foreground", originalExtras.getBoolean("foreground")); - - Log.v("PushHandlerActivity:handlePush", json.toString()); - - PushPlugin.sendJavascript( json ); - } - catch( JSONException e) - { - Log.e("PushHandlerActivity:handlePush", "JSON exception"); - } - } - } + PushHandlerActivity.sendToApp(originalExtras); + } finish(); - } + } + + public static void sendToApp(Bundle extras) + { + try + { + JSONObject json; + json = new JSONObject().put("event", "message"); + + JSONObject jsondata = new JSONObject(); + Iterator it = extras.keySet().iterator(); + while (it.hasNext()) + { + String key = it.next(); + String value = extras.getString(key); + + // System data from Android + if (key.equals("from") || key.equals("collapse_key")) + { + json.put(key, value); + } + else if (key.equals("foreground")) + { + json.put(key, extras.getBoolean("foreground")); + } + else + { + // Maintain backwards compatibility + if (key.equals("message") || key.equals("msgcnt") || key.equals("soundname")) + { + json.put(key, value); + } + + // Try to figure out if the value is another JSON object + if (value.startsWith("{")) + { + try + { + JSONObject json2 = new JSONObject(value); + jsondata.put(key, json2); + } + catch (Exception e) + { + jsondata.put(key, value); + } + // Try to figure out if the value is another JSON array + } + else if (value.startsWith("[")) + { + try + { + JSONArray json2 = new JSONArray(value); + jsondata.put(key, json2); + } + catch (Exception e) + { + jsondata.put(key, value); + } + } + else + { + jsondata.put(key, value); + } + } + } // while + json.put("payload", jsondata); + + Log.v("sendToApp:", json.toString()); + + PushPlugin.sendJavascript( json ); + // Send the MESSAGE to the Javascript application + } + catch( JSONException e) + { + Log.e("sendToApp:", "JSON exception"); + } + } @Override protected void onNewIntent(Intent intent) diff --git a/src/android/com/plugin/GCM/PushPlugin.java b/src/android/com/plugin/GCM/PushPlugin.java index ec8aaa69..b67820ed 100644 --- a/src/android/com/plugin/GCM/PushPlugin.java +++ b/src/android/com/plugin/GCM/PushPlugin.java @@ -76,7 +76,7 @@ else if (UNREGISTER.equals(action)) { GCMRegistrar.unregister(this.ctx.getContext()); Log.v(ME + ":" + UNREGISTER, "GCMRegistrar.unregister called "); - + result = new PluginResult(Status.OK); } else { From d61412e9999e66c3203660f5615d102533261e50 Mon Sep 17 00:00:00 2001 From: Bob Easterday Date: Thu, 14 Feb 2013 12:22:00 -0800 Subject: [PATCH 014/133] Clean up some unused imports --- src/android/com/google/android/gcm/GCMIntentService.java | 8 -------- 1 file changed, 8 deletions(-) diff --git a/src/android/com/google/android/gcm/GCMIntentService.java b/src/android/com/google/android/gcm/GCMIntentService.java index bfece58a..ee4e1041 100644 --- a/src/android/com/google/android/gcm/GCMIntentService.java +++ b/src/android/com/google/android/gcm/GCMIntentService.java @@ -1,31 +1,23 @@ package com.google.android.gcm; -import java.io.IOException; import java.util.List; import com.plugin.GCM.PushHandlerActivity; -import com.google.android.gcm.*; -import java.util.Iterator; - -import org.json.JSONArray; import org.json.JSONException; import org.json.JSONObject; import android.annotation.SuppressLint; import android.app.ActivityManager; import android.app.ActivityManager.RunningTaskInfo; -import android.app.Notification; import android.app.NotificationManager; import android.app.PendingIntent; import android.content.Context; import android.content.Intent; -import android.media.MediaPlayer; import android.media.Ringtone; import android.media.RingtoneManager; import android.net.Uri; import android.os.Bundle; import android.support.v4.app.NotificationCompat; -import android.support.v4.app.TaskStackBuilder; import android.util.Log; import com.plugin.GCM.PushPlugin; From 33459fc4626ab20230732d0484b34ceaf1ab67c0 Mon Sep 17 00:00:00 2001 From: Bob Easterday Date: Thu, 14 Feb 2013 16:32:45 -0800 Subject: [PATCH 015/133] Update read me and examples to reflect status bar notifications changes --- Example/Sample_AndroidManifest.xml | 2 +- Example/www/index.html | 2 +- README.md | 71 ++++++++++++++++++++++++++---- 3 files changed, 64 insertions(+), 11 deletions(-) diff --git a/Example/Sample_AndroidManifest.xml b/Example/Sample_AndroidManifest.xml index 5cf6fa8a..b2ddeaee 100644 --- a/Example/Sample_AndroidManifest.xml +++ b/Example/Sample_AndroidManifest.xml @@ -1,2 +1,2 @@ - \ No newline at end of file + \ No newline at end of file diff --git a/Example/www/index.html b/Example/www/index.html index c6264f73..94e9b7a5 100755 --- a/Example/www/index.html +++ b/Example/www/index.html @@ -89,9 +89,9 @@ if ( e.regid.length > 0 ) { $("#app-status-ul").append('
  • REGISTERED -> REGID:' + e.regid + "
    • "); + console.log("regID = " + regID); // Your GCM push server needs to know the regID before it can push to this device // here is where you might want to send it the regID for later use. - console.log("regID = " + regID); } break; diff --git a/README.md b/README.md index 2ba8abc7..022cb189 100644 --- a/README.md +++ b/README.md @@ -51,10 +51,10 @@ This plugin is for use with [Cordova](http://incubator.apache.org/cordova/), and GCMRegistrar.java plugin GCM - PushPlugin.java + PushPlugin.java {company_name} {intent_name} - {intent_name}.java + {intent_name}.java 2) Modify your **AndroidManifest.xml** and add the following lines to your manifest tag, replacing **your_app_package** with your app's package path: @@ -67,9 +67,9 @@ This plugin is for use with [Cordova](http://incubator.apache.org/cordova/), and -3) Modify your **AndroidManifest.xml** and add the **receiver** and **service** tags to your **application** section, replacing **your_app_package** with your app's package path: (See the Sample_AndroidManifest.xml file in the Example folder.) - +3) Modify your **AndroidManifest.xml** and add the following **activity**, **receiver** and **service** tags to your **application** section, replacing **your_app_package** with your app's package path: (See the Sample_AndroidManifest.xml file in the Example folder.) + @@ -136,7 +136,7 @@ This should be called as soon as the device becomes ready. On success, you will For Android, If you have not already done so, you'll need to set up a Google API project, to generate your senderID. [Follow these steps](http://developer.android.com/guide/google/gcm/gs.html) to do so. This is described more fully in the **Test Environment** section below. -In this example, sure and substitute your own senderID. Get your senderID by signing into to your [google dashboard](https://code.google.com/apis/console/). The senderID is found at **Overview->Dashboard->Project Number**. +In this example, be sure and substitute your own senderID. Get your senderID by signing into to your [google dashboard](https://code.google.com/apis/console/). The senderID is found at **Overview->Dashboard->Project Number**. if (device.platform == 'android' || device.platform == 'Android') { pushNotification.register(successHandler, errorHandler,{"senderID":"replace_with_sender_id","ecb":"onNotificationGCM"}); @@ -201,9 +201,21 @@ In this example, sure and substitute your own senderID. Get your senderID by sig break; case 'message': - // this is the actual push notification. its format depends on the data model - // of the intermediary push server which must also be reflected in GCMIntentService.java - alert('message = '+e.message+' msgcnt = '+e.msgcnt); + // if this flag is set, this notification happened while we were in the foreground. + // you might want to play a sound to get the user's attention, throw up a dialog, etc. + if (e.foreground) + { + $("#app-status-ul").append('
  • --INLINE NOTIFICATION--' + '
    • '); + + // if the notification contains a soundname, play it. + var my_media = new Media("/android_asset/www/"+e.soundname); + my_media.play(); + } + else // otherwise we were launched because the user touched a notification in the notification tray. + $("#app-status-ul").append('
  • --BACKGROUND NOTIFICATION--' + '
    • '); + + $("#app-status-ul").append('
  • MESSAGE -> MSG: ' + e.payload.message + '
    • '); + $("#app-status-ul").append('
  • MESSAGE -> MSGCNT: ' + e.payload.msgcnt + '
    • '); break; case 'error': @@ -216,11 +228,50 @@ In this example, sure and substitute your own senderID. Get your senderID by sig } } +Looking at the above message handling code for Android, a few things bear explaination. Your app may receive a notification while it is active (INLINE). If you background the app by hitting the Home button on your device, you may later receive a status bar notification. Selecting that notification from the status will bring your app to the front and allow you to process the notification (BACKGROUND). You can look at the **foreground** flag on the event to determine whether you are processing a background or na in-line notification. You may choose, for example to play a sound or show a dialog only for inline notifications since the user has already been allerted via the status bar. + +Also make note of the **payload** object. Since the Android notification data model is much more flexible than that of iOS, there may be additional elements beyond **message**, **soundname**, and **msgcnt**. You can access those elements and any additional ones via the payload element. This means that if your data model should change in the future, there will be no need to change and recompile the plugin. + #### unregister Call this when your app is exiting to cleanup any used resources. pushNotification.unregister(successHandler, errorHandler); +You'll probably want to trap on the **backbutton** event and only call this when the home page is showing. Remember, the back button on android is not the same as the Home button. When you hit the back button from the home page, your activity gets dismissed. While you will still receive status bar notifications thereafter, selecting that notification from the status tray will not sub-launch your app. If you, however, "exit" the app by pressing the home button, subsequent status bar touchs WILL sublaunch your app, giving you the opportunity to process the notification. Here is an example of how to trap the backbutton event; + + function onDeviceReady() { + $("#app-status-ul").append('
  • deviceready event received
    • '); + + document.addEventListener("backbutton", function(e) + { + $("#app-status-ul").append('
  • backbutton event received
    • '); + + if( $("#home").length > 0) + { + e.preventDefault(); + pushNotification.unregister(successHandler, errorHandler); + navigator.app.exitApp(); + } + else + { + navigator.app.backHistory(); + } + }, false); + + // aditional onDeviceReady work… + } +For the above to work, make sure the content for your home page is wrapped in an element with an id of home, like this; + +
    +
    +
      +
    • Cordova PushNotification Plugin Demo
      • +
    +
    +
    + + + #### setApplicationIconBadgeNumber (iOS only) set the badge count visible when the app is not running @@ -291,7 +342,7 @@ If you run this demo using the emulator you will not receive notifications from If everything seems right and you are not receiving a registration id response back from Google, try uninstalling and reinstalling your app. That has worked for some devs out there. -While the data model for iOS is somewhat fixed, it should be noted that GCM is far more flexible. The Android implementation in this plugin, for example, assumes the incoming message will contain a 'message' and a 'msgcnt' node. This is reflected in both the plugin (see GCMIntentService.java) as well as in provided example ruby script (pushGCM.rb). Should you employ a commercial service, their data model may differ, in which case the plugin will need to me modified to accommodate those differences. +While the data model for iOS is somewhat fixed, it should be noted that GCM is far more flexible. The Android implementation in this plugin, for example, assumes the incoming message will contain a '**message**' and a '**msgcnt**' node. This is reflected in both the plugin (see GCMIntentService.java) as well as in provided example ruby script (pushGCM.rb). Should you employ a commercial service, their data model may differ. As mentioned earlier, this is where you will want to take a look at the **payload** element of the message event. In addition to the cannonical message and msgcnt elements, any additional elements in the incoming JSON object will be accessible here, obviating the need to edit and recompile the plugin. Many thanks to Tobias Hößl for this functionality! ## Additional Resources @@ -310,3 +361,5 @@ While the data model for iOS is somewhat fixed, it should be noted that GCM is f Huge thanks to Mark Nutter whose [GCM-Cordova plugin](https://github.com/marknutter/GCM-Cordova) forms the basis for the Android side implimentation. Likewise, the iOS side was inspired by Olivier Louvignes' [Cordova PushNotification Plugin](https://github.com/phonegap/phonegap-plugins/tree/master/iOS/PushNotification) (Copyright (c) 2012 Olivier Louvignes) for iOS. + +Props to [Tobias Hößl](https://github.com/CatoTH), who provided the code to surface the full JSON object up to the JS layer. From 778bbbb9dca42646b511cf198d53869673d1bfbe Mon Sep 17 00:00:00 2001 From: Bob Easterday Date: Tue, 19 Feb 2013 14:15:53 -0800 Subject: [PATCH 016/133] Surface custom key/value pairs to JS for iOS --- src/ios/AppDelegate+notification.m | 4 ++-- src/ios/PushPlugin.m | 31 +++++++++++++++++++++--------- 2 files changed, 24 insertions(+), 11 deletions(-) diff --git a/src/ios/AppDelegate+notification.m b/src/ios/AppDelegate+notification.m index e563a0cb..4c71a58c 100644 --- a/src/ios/AppDelegate+notification.m +++ b/src/ios/AppDelegate+notification.m @@ -40,7 +40,7 @@ - (void)application:(UIApplication *)application didReceiveRemoteNotification:(N if (appState == UIApplicationStateActive) { PushPlugin *pushHandler = [self getCommandInstance:@"PushPlugin"]; - pushHandler.notificationMessage = [userInfo objectForKey:@"aps"]; + pushHandler.notificationMessage = userInfo; pushHandler.isInline = YES; [pushHandler notificationReceived]; } else { @@ -58,7 +58,7 @@ - (void)applicationDidBecomeActive:(UIApplication *)application { if (![self.viewController.webView isLoading] && self.launchNotification) { PushPlugin *pushHandler = [self getCommandInstance:@"PushPlugin"]; - pushHandler.notificationMessage = [self.launchNotification objectForKey:@"aps"]; + pushHandler.notificationMessage = self.launchNotification; self.launchNotification = nil; diff --git a/src/ios/PushPlugin.m b/src/ios/PushPlugin.m index 990e9e1a..80ab84d3 100644 --- a/src/ios/PushPlugin.m +++ b/src/ios/PushPlugin.m @@ -156,15 +156,12 @@ - (void)didFailToRegisterForRemoteNotificationsWithError:(NSError *)error - (void)notificationReceived { NSLog(@"Notification received"); - NSLog(@"Msg: %@", [notificationMessage descriptionWithLocale:[NSLocale currentLocale] indent:4]); - if (notificationMessage) { + if (notificationMessage) + { NSMutableString *jsonStr = [NSMutableString stringWithString:@"{"]; - if ([notificationMessage objectForKey:@"alert"]) - [jsonStr appendFormat:@"alert:'%@',", [[notificationMessage objectForKey:@"alert"] stringByReplacingOccurrencesOfString:@"'" withString:@"\\'"]]; - if ([notificationMessage objectForKey:@"badge"]) - [jsonStr appendFormat:@"badge:%d,", [[notificationMessage objectForKey:@"badge"] intValue]]; + [self parseDictionary:notificationMessage intoJSON:jsonStr]; if (isInline) { @@ -172,11 +169,10 @@ - (void)notificationReceived { isInline = NO; } - if ([notificationMessage objectForKey:@"sound"]) - [jsonStr appendFormat:@"sound:'%@',", [notificationMessage objectForKey:@"sound"]]; - [jsonStr appendString:@"}"]; + NSLog(@"Msg: %@", jsonStr); + NSString * jsCallBack = [NSString stringWithFormat:@"%@(%@);", self.callback, jsonStr]; [self.webView stringByEvaluatingJavaScriptFromString:jsCallBack]; @@ -184,6 +180,23 @@ - (void)notificationReceived { } } +// reentrant method to drill down and surface all sub-dictionaries' key/value pairs into the top level json +-(void)parseDictionary:(NSDictionary *)inDictionary intoJSON:(NSMutableString *)jsonString +{ + NSArray *keys = [inDictionary allKeys]; + NSString *key; + + for (key in keys) + { + id thisObject = [inDictionary objectForKey:key]; + + if ([thisObject isKindOfClass:[NSDictionary class]]) + [self parseDictionary:thisObject intoJSON:jsonString]; + else + [jsonString appendFormat:@"%@:'%@',", key, [inDictionary objectForKey:key]]; + } +} + - (void)setApplicationIconBadgeNumber:(NSMutableArray *)arguments withDict:(NSMutableDictionary *)options { DLog(@"setApplicationIconBadgeNumber:%@\n withDict:%@", arguments, options); From a412c1c713caf1e5d39f319a12dd343be7b4e00e Mon Sep 17 00:00:00 2001 From: Bob Easterday Date: Wed, 20 Feb 2013 16:34:43 -0800 Subject: [PATCH 017/133] Don't choke if no msgcnt or message values are passed in the notification --- Example/www/index.html | 2 +- .../google/android/gcm/GCMIntentService.java | 18 ++++++++++++++++-- src/android/com/plugin/GCM/PushPlugin.java | 2 ++ 3 files changed, 19 insertions(+), 3 deletions(-) diff --git a/Example/www/index.html b/Example/www/index.html index 94e9b7a5..3b2741dc 100755 --- a/Example/www/index.html +++ b/Example/www/index.html @@ -89,7 +89,7 @@ if ( e.regid.length > 0 ) { $("#app-status-ul").append('
  • REGISTERED -> REGID:' + e.regid + "
    • "); - console.log("regID = " + regID); + console.log("regID = " + e.regID); // Your GCM push server needs to know the regID before it can push to this device // here is where you might want to send it the regID for later use. } diff --git a/src/android/com/google/android/gcm/GCMIntentService.java b/src/android/com/google/android/gcm/GCMIntentService.java index ee4e1041..25e891ac 100644 --- a/src/android/com/google/android/gcm/GCMIntentService.java +++ b/src/android/com/google/android/gcm/GCMIntentService.java @@ -102,10 +102,24 @@ public void onReceive(Context context, Bundle extras) .setWhen(System.currentTimeMillis()) .setContentTitle(appName) .setTicker(appName) - .setContentText(extras.getString("message")) - .setNumber(Integer.parseInt(extras.getString("msgcnt"))) .setContentIntent(contentIntent); + String message = extras.getString("message"); + if (message != null) + { + mBuilder.setContentText(message); + } + else + { + mBuilder.setContentText(""); + } + + String msgcnt = extras.getString("msgcnt"); + if (msgcnt != null) + { + mBuilder.setNumber(Integer.parseInt(msgcnt)); + } + mNotificationManager.notify(notificationID, mBuilder.build()); try diff --git a/src/android/com/plugin/GCM/PushPlugin.java b/src/android/com/plugin/GCM/PushPlugin.java index b67820ed..2032abe0 100644 --- a/src/android/com/plugin/GCM/PushPlugin.java +++ b/src/android/com/plugin/GCM/PushPlugin.java @@ -75,6 +75,8 @@ public PluginResult execute(String action, JSONArray data, String callbackId) else if (UNREGISTER.equals(action)) { GCMRegistrar.unregister(this.ctx.getContext()); + GCMRegistrar.onDestroy(this.ctx.getContext()); + Log.v(ME + ":" + UNREGISTER, "GCMRegistrar.unregister called "); result = new PluginResult(Status.OK); } From 08783e4309c7827fcbcecc0e0436dbadf1589a82 Mon Sep 17 00:00:00 2001 From: Bob Easterday Date: Thu, 21 Feb 2013 09:17:59 -0800 Subject: [PATCH 018/133] Dismiss notification from tray once it has been processed --- .../com/google/android/gcm/GCMIntentService.java | 4 +--- .../com/plugin/GCM/PushHandlerActivity.java | 14 ++++++++++++++ 2 files changed, 15 insertions(+), 3 deletions(-) diff --git a/src/android/com/google/android/gcm/GCMIntentService.java b/src/android/com/google/android/gcm/GCMIntentService.java index 25e891ac..f4bfefac 100644 --- a/src/android/com/google/android/gcm/GCMIntentService.java +++ b/src/android/com/google/android/gcm/GCMIntentService.java @@ -26,7 +26,6 @@ public class GCMIntentService extends GCMBaseIntentService { public static final String ME="GCMReceiver"; - public static final int notificationID = 237; public GCMIntentService() { super("GCMIntentService"); @@ -120,8 +119,7 @@ public void onReceive(Context context, Bundle extras) mBuilder.setNumber(Integer.parseInt(msgcnt)); } - mNotificationManager.notify(notificationID, mBuilder.build()); - + mNotificationManager.notify((String) appName, PushHandlerActivity.NOTIFICATION_ID, mBuilder.build()); try { Uri notification = RingtoneManager.getDefaultUri(RingtoneManager.TYPE_NOTIFICATION); diff --git a/src/android/com/plugin/GCM/PushHandlerActivity.java b/src/android/com/plugin/GCM/PushHandlerActivity.java index 1905ad2f..02b2dc7e 100644 --- a/src/android/com/plugin/GCM/PushHandlerActivity.java +++ b/src/android/com/plugin/GCM/PushHandlerActivity.java @@ -15,12 +15,16 @@ import org.json.JSONObject; import android.app.Activity; +import android.app.NotificationManager; +import android.content.Context; import android.content.Intent; import android.os.Bundle; import android.util.Log; public class PushHandlerActivity extends Activity { + public static final int NOTIFICATION_ID = 237; + @Override public void onCreate(Bundle savedInstanceState) { @@ -41,6 +45,16 @@ private void handlePush() PushHandlerActivity.sendToApp(originalExtras); } finish(); + + // Now that we've processed the notification, remove it from the tray + CharSequence appName = this.getPackageManager().getApplicationLabel(this.getApplicationInfo()); + if (null == appName) + appName = ""; + + NotificationManager mNotificationManager = (NotificationManager) getSystemService(Context.NOTIFICATION_SERVICE); + // use a combo of appName and id to insure uniqueness since this plugin may be running + // in multiple apps on a particular device. + mNotificationManager.cancel((String) appName, NOTIFICATION_ID); } public static void sendToApp(Bundle extras) From a3dc402dfbb6bf161b83bb6ed6ff28a7b20ad837 Mon Sep 17 00:00:00 2001 From: Bob Easterday Date: Thu, 21 Feb 2013 10:48:45 -0800 Subject: [PATCH 019/133] Bump the plugin version --- plugin.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/plugin.xml b/plugin.xml index 99afa640..bc3c2998 100755 --- a/plugin.xml +++ b/plugin.xml @@ -2,7 +2,7 @@ + version="1.1.1"> PushPlugin From 2ee858f634d6038e3f652dc85dc3b2db4266fc75 Mon Sep 17 00:00:00 2001 From: Bob Easterday Date: Tue, 5 Mar 2013 16:53:35 -0800 Subject: [PATCH 020/133] Always refresh the content Intent on new notifications. --- src/android/com/google/android/gcm/GCMIntentService.java | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/android/com/google/android/gcm/GCMIntentService.java b/src/android/com/google/android/gcm/GCMIntentService.java index f4bfefac..470111a3 100644 --- a/src/android/com/google/android/gcm/GCMIntentService.java +++ b/src/android/com/google/android/gcm/GCMIntentService.java @@ -94,7 +94,7 @@ public void onReceive(Context context, Bundle extras) notificationIntent.addFlags(Intent.FLAG_ACTIVITY_SINGLE_TOP | Intent.FLAG_ACTIVITY_CLEAR_TOP); notificationIntent.putExtra("pushBundle", extras); - PendingIntent contentIntent = PendingIntent.getActivity(this, 0, notificationIntent, 0); + PendingIntent contentIntent = PendingIntent.getActivity(this, 0, notificationIntent, PendingIntent.FLAG_UPDATE_CURRENT); NotificationCompat.Builder mBuilder = new NotificationCompat.Builder(context) .setSmallIcon(context.getApplicationInfo().icon) From fa8ea29db62b1858bfd8be6a7f1bfbb3add0fddc Mon Sep 17 00:00:00 2001 From: Bob Easterday Date: Tue, 5 Mar 2013 16:57:11 -0800 Subject: [PATCH 021/133] and bump the version --- plugin.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/plugin.xml b/plugin.xml index bc3c2998..61e7fecc 100755 --- a/plugin.xml +++ b/plugin.xml @@ -2,7 +2,7 @@ + version="1.1.2"> PushPlugin From de8c1c56b52b8caee634da1775e3620f1316a678 Mon Sep 17 00:00:00 2001 From: Bob Easterdayerday Date: Fri, 22 Mar 2013 09:14:04 -0700 Subject: [PATCH 022/133] Remove use of now private uniqueIdentifier accessor --- src/ios/PushPlugin.m | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/src/ios/PushPlugin.m b/src/ios/PushPlugin.m index 80ab84d3..ba1282d4 100644 --- a/src/ios/PushPlugin.m +++ b/src/ios/PushPlugin.m @@ -138,9 +138,8 @@ - (void)didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken { [results setValue:pushAlert forKey:@"pushAlert"]; [results setValue:pushSound forKey:@"pushSound"]; - // Get the users Device Model, Display Name, Unique ID, Token & Version Number + // Get the users Device Model, Display Name, Token & Version Number UIDevice *dev = [UIDevice currentDevice]; - [results setValue:dev.uniqueIdentifier forKey:@"deviceUuid"]; [results setValue:dev.name forKey:@"deviceName"]; [results setValue:dev.model forKey:@"deviceModel"]; [results setValue:dev.systemVersion forKey:@"deviceSystemVersion"]; From 86bec0e728db87bffe7df930ed45419e32f9a7fe Mon Sep 17 00:00:00 2001 From: Bob Easterdayerday Date: Fri, 22 Mar 2013 09:19:47 -0700 Subject: [PATCH 023/133] bump version for uniqueidentifier fix --- plugin.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/plugin.xml b/plugin.xml index 61e7fecc..54ca1f0d 100755 --- a/plugin.xml +++ b/plugin.xml @@ -2,7 +2,7 @@ + version="1.1.3"> PushPlugin From 595e762e453249b387ec0c0535bc5ea0d1ff93e3 Mon Sep 17 00:00:00 2001 From: Bob Easterday Date: Mon, 25 Mar 2013 17:51:57 -0700 Subject: [PATCH 024/133] Add cold-start functionality --- Example/Sample_AndroidManifest.xml | 2 - Example/Sample_config.xml | 29 ------ Example/www/PushNotification.js | 61 +++++++++--- Example/www/index.html | 40 ++++---- plugin.xml | 2 +- .../google/android/gcm/GCMIntentService.java | 3 +- .../com/plugin/GCM/PushHandlerActivity.java | 94 +++++++++++++------ src/android/com/plugin/GCM/PushPlugin.java | 71 ++++++++++---- 8 files changed, 185 insertions(+), 117 deletions(-) delete mode 100644 Example/Sample_AndroidManifest.xml delete mode 100755 Example/Sample_config.xml diff --git a/Example/Sample_AndroidManifest.xml b/Example/Sample_AndroidManifest.xml deleted file mode 100644 index b2ddeaee..00000000 --- a/Example/Sample_AndroidManifest.xml +++ /dev/null @@ -1,2 +0,0 @@ - - \ No newline at end of file diff --git a/Example/Sample_config.xml b/Example/Sample_config.xml deleted file mode 100755 index a38205e6..00000000 --- a/Example/Sample_config.xml +++ /dev/null @@ -1,29 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - \ No newline at end of file diff --git a/Example/www/PushNotification.js b/Example/www/PushNotification.js index 77121cdc..6b51bade 100644 --- a/Example/www/PushNotification.js +++ b/Example/www/PushNotification.js @@ -1,28 +1,65 @@ -(function(cordova) { - var cordovaRef = window.PhoneGap || window.Cordova || window.cordova; - function PushNotification() {} +var PushNotification = function() { +}; + // Call this to register for push notifications. Content of [options] depends on whether we are working with APNS (iOS) or GCM (Android) PushNotification.prototype.register = function(successCallback, errorCallback, options) { - cordovaRef.exec(successCallback, errorCallback, "PushPlugin", "register", [options]); + if (errorCallback == null) { errorCallback = function() {}} + + if (typeof errorCallback != "function") { + console.log("PushNotification.register failure: failure parameter not a function"); + return; + } + + if (typeof successCallback != "function") { + console.log("PushNotification.register failure: success callback parameter must be a function"); + return; + } + + cordova.exec(successCallback, errorCallback, "PushPlugin", "register", [options]); }; // Call this to unregister for push notifications PushNotification.prototype.unregister = function(successCallback, errorCallback) { - cordovaRef.exec(successCallback, errorCallback, "PushPlugin", "unregister", []); + if (errorCallback == null) { errorCallback = function() {}} + + if (typeof errorCallback != "function") { + console.log("PushNotification.unregister failure: failure parameter not a function"); + return; + } + + if (typeof successCallback != "function") { + console.log("PushNotification.unregister failure: success callback parameter must be a function"); + return; + } + + cordova.exec(successCallback, errorCallback, "PushPlugin", "unregister", []); }; // Call this to set the application icon badge PushNotification.prototype.setApplicationIconBadgeNumber = function(successCallback, badge) { - cordovaRef.exec(successCallback, successCallback, "PushPlugin", "setApplicationIconBadgeNumber", [{badge: badge}]); + if (errorCallback == null) { errorCallback = function() {}} + + if (typeof errorCallback != "function") { + console.log("PushNotification.setApplicationIconBadgeNumber failure: failure parameter not a function"); + return; + } + + if (typeof successCallback != "function") { + console.log("PushNotification.setApplicationIconBadgeNumber failure: success callback parameter must be a function"); + return; + } + + cordova.exec(successCallback, successCallback, "PushPlugin", "setApplicationIconBadgeNumber", [{badge: badge}]); }; - cordova.addConstructor(function() { - if(!window.plugins) - window.plugins = {}; - window.plugins.pushNotification = new PushNotification(); - }); +//------------------------------------------------------------------- - })(window.cordova || window.Cordova || window.PhoneGap); +if(!window.plugins) { + window.plugins = {}; +} +if (!window.plugins.pushNotification) { + window.plugins.pushNotification = new PushNotification(); +} diff --git a/Example/www/index.html b/Example/www/index.html index 3b2741dc..49d95707 100755 --- a/Example/www/index.html +++ b/Example/www/index.html @@ -22,8 +22,9 @@ if( $("#home").length > 0) { + // call this to get a new token each time. don't call it to reuse existing token. + //pushNotification.unregister(successHandler, errorHandler); e.preventDefault(); - pushNotification.unregister(successHandler, errorHandler); navigator.app.exitApp(); } else @@ -37,10 +38,10 @@ pushNotification = window.plugins.pushNotification; if (device.platform == 'android' || device.platform == 'Android') { $("#app-status-ul").append('
  • registering android
    • '); - pushNotification.register(successHandler, errorHandler, {"senderID":"661780372179","ecb":"onNotificationGCM"}); + pushNotification.register(successHandler, errorHandler, {"senderID":"661780372179","ecb":"onNotificationGCM"}); // required! } else { $("#app-status-ul").append('
  • registering iOS
    • '); - pushNotification.register(tokenHandler, errorHandler, {"badge":"true","sound":"true","alert":"true","ecb":"onNotificationAPN"}); + pushNotification.register(tokenHandler, errorHandler, {"badge":"true","sound":"true","alert":"true","ecb":"onNotificationAPN"}); // required! } } catch(err) @@ -53,25 +54,14 @@ // handle APNS notifications for iOS function onNotificationAPN(e) { - if (e.foreground) { - $("#app-status-ul").append('
  • --INLINE NOTIFICATION--' + '
    • '); - - if (e.sound) { - var snd = new Media(e.sound); - snd.play(); - } - - if (e.alert) { - $("#app-status-ul").append('
  • push-notification: ' + e.alert + '
    • '); - navigator.notification.alert(e.alert); - } + if (e.alert) { + $("#app-status-ul").append('
  • push-notification: ' + e.alert + '
    • '); + navigator.notification.alert(e.alert); } - else { - $("#app-status-ul").append('
  • --BACKGROUND NOTIFICATION--' + '
    • '); - if (e.alert) { - $("#app-status-ul").append('
  • push-notification: ' + e.alert + '
    • '); - } + if (e.sound) { + var snd = new Media(e.sound); + snd.play(); } if (e.badge) { @@ -89,9 +79,9 @@ if ( e.regid.length > 0 ) { $("#app-status-ul").append('
  • REGISTERED -> REGID:' + e.regid + "
    • "); - console.log("regID = " + e.regID); // Your GCM push server needs to know the regID before it can push to this device // here is where you might want to send it the regID for later use. + console.log("regID = " + e.regID); } break; @@ -106,8 +96,13 @@ var my_media = new Media("/android_asset/www/"+e.soundname); my_media.play(); } - else // otherwise we were launched because the user touched a notification in the notification tray. + else + { // otherwise we were launched because the user touched a notification in the notification tray. + if (e.coldstart) + $("#app-status-ul").append('
  • --COLDSTART NOTIFICATION--' + '
    • '); + else $("#app-status-ul").append('
  • --BACKGROUND NOTIFICATION--' + '
    • '); + } $("#app-status-ul").append('
  • MESSAGE -> MSG: ' + e.payload.message + '
    • '); $("#app-status-ul").append('
  • MESSAGE -> MSGCNT: ' + e.payload.msgcnt + '
    • '); @@ -125,7 +120,6 @@ function tokenHandler (result) { $("#app-status-ul").append('
  • token: '+ result +'
    • '); - console.log("token = " + result); // Your iOS push server needs to know the token before it can push to this device // here is where you might want to send it the token for later use. } diff --git a/plugin.xml b/plugin.xml index 54ca1f0d..6436d7bf 100755 --- a/plugin.xml +++ b/plugin.xml @@ -2,7 +2,7 @@ + version="1.2.0"> PushPlugin diff --git a/src/android/com/google/android/gcm/GCMIntentService.java b/src/android/com/google/android/gcm/GCMIntentService.java index 470111a3..a462b443 100644 --- a/src/android/com/google/android/gcm/GCMIntentService.java +++ b/src/android/com/google/android/gcm/GCMIntentService.java @@ -138,8 +138,7 @@ public boolean isInForeground() List services = activityManager .getRunningTasks(Integer.MAX_VALUE); - if (services.get(0).topActivity.getPackageName().toString() - .equalsIgnoreCase(getApplicationContext().getPackageName().toString())) + if (services.get(0).topActivity.getPackageName().toString().equalsIgnoreCase(getApplicationContext().getPackageName().toString())) return true; return false; diff --git a/src/android/com/plugin/GCM/PushHandlerActivity.java b/src/android/com/plugin/GCM/PushHandlerActivity.java index 02b2dc7e..fc1fbfa7 100644 --- a/src/android/com/plugin/GCM/PushHandlerActivity.java +++ b/src/android/com/plugin/GCM/PushHandlerActivity.java @@ -1,13 +1,10 @@ // // PushHandlerActivity.java // -// Pushwoosh Push Notifications SDK -// www.pushwoosh.com -// -// MIT Licensed package com.plugin.GCM; +import java.io.FileOutputStream; import java.util.Iterator; import org.json.JSONArray; @@ -18,46 +15,83 @@ import android.app.NotificationManager; import android.content.Context; import android.content.Intent; +import android.content.pm.PackageManager; import android.os.Bundle; import android.util.Log; public class PushHandlerActivity extends Activity { public static final int NOTIFICATION_ID = 237; + public static boolean EXITED = false; + // this activity will be started if the user touches a notification that we own. If returning from the background, + // we process it immediately. If from a cold start, we cache the payload and start the main activity which will then process the cached payload. @Override public void onCreate(Bundle savedInstanceState) { + Log.v("onCreate:", "entry"); + super.onCreate(savedInstanceState); - handlePush(); - } - private void handlePush() - { - // If we are here, it is because we were launched via a notification. It is up to the author to decide what to do with it. - // You may simply ignore it since the notification already fired in the background. Either way, the background flag - // will let you know what the state was when the notification fired. - Bundle extras = this.getIntent().getExtras(); + Bundle extras = getIntent().getExtras(); if (extras != null) { Bundle originalExtras = extras.getBundle("pushBundle"); if (originalExtras != null) - PushHandlerActivity.sendToApp(originalExtras); - } - finish(); + { + if (EXITED) + { + PackageManager pm = getPackageManager(); + Intent launchIntent = pm.getLaunchIntentForPackage(getApplicationContext().getPackageName()); + + // remember how we got here + originalExtras.putBoolean("coldstart", true); + + // serialize and cache the payload before starting the main activity. + String json = extrasToJSON(originalExtras).toString(); + try + { + FileOutputStream fos = openFileOutput("cached_payload", Context.MODE_PRIVATE); + fos.write(json.getBytes()); + fos.close(); + } + catch (Exception e) + { + e.printStackTrace(); + } - // Now that we've processed the notification, remove it from the tray - CharSequence appName = this.getPackageManager().getApplicationLabel(this.getApplicationInfo()); - if (null == appName) - appName = ""; + // now fire up our main activity + startActivity(launchIntent); + } + else + { + // our main activity was already running (in the background), process the payload + sendToApp(originalExtras); + } + + // Now that we've processed the notification, remove it from the tray + CharSequence appName = this.getPackageManager().getApplicationLabel(this.getApplicationInfo()); + if (null == (String)appName) + appName = ""; - NotificationManager mNotificationManager = (NotificationManager) getSystemService(Context.NOTIFICATION_SERVICE); - // use a combo of appName and id to insure uniqueness since this plugin may be running - // in multiple apps on a particular device. - mNotificationManager.cancel((String) appName, NOTIFICATION_ID); - } + NotificationManager mNotificationManager = (NotificationManager) getSystemService(Context.NOTIFICATION_SERVICE); + mNotificationManager.cancel((String) appName, NOTIFICATION_ID); + } + } + + finish(); + } + // surface the notification up to the JS layer public static void sendToApp(Bundle extras) + { + JSONObject json = extrasToJSON(extras); + + PushPlugin.sendJavascript( json ); + } + + // serialize the bundle for caching or JS processing + private static JSONObject extrasToJSON(Bundle extras) { try { @@ -80,6 +114,10 @@ else if (key.equals("foreground")) { json.put(key, extras.getBoolean("foreground")); } + else if (key.equals("coldstart")) + { + json.put(key, extras.getBoolean("coldstart")); + } else { // Maintain backwards compatibility @@ -122,15 +160,15 @@ else if (value.startsWith("[")) } // while json.put("payload", jsondata); - Log.v("sendToApp:", json.toString()); + Log.v("extrasToJSON:", json.toString()); - PushPlugin.sendJavascript( json ); - // Send the MESSAGE to the Javascript application + return json; } catch( JSONException e) { - Log.e("sendToApp:", "JSON exception"); + Log.e("extrasToJSON:", "JSON exception"); } + return null; } @Override diff --git a/src/android/com/plugin/GCM/PushPlugin.java b/src/android/com/plugin/GCM/PushPlugin.java index 2032abe0..145b5ac2 100644 --- a/src/android/com/plugin/GCM/PushPlugin.java +++ b/src/android/com/plugin/GCM/PushPlugin.java @@ -1,9 +1,9 @@ package com.plugin.GCM; - -//import java.io.*; -//import java.util.*; - +import java.io.BufferedReader; +import java.io.FileNotFoundException; +import java.io.IOException; +import java.io.InputStreamReader; import org.json.JSONArray; import org.json.JSONException; @@ -28,13 +28,14 @@ public class PushPlugin extends Plugin { public static final String REGISTER="register"; public static final String UNREGISTER="unregister"; + public static final String EXIT="exit"; public static Plugin gwebView; private static String gECB; private static String gSenderID; @SuppressWarnings("deprecation") -@Override + @Override public PluginResult execute(String action, JSONArray data, String callbackId) { @@ -46,6 +47,7 @@ public PluginResult execute(String action, JSONArray data, String callbackId) Log.v(ME + ":execute", "data=" + data.toString()); + try { JSONObject jo= new JSONObject(data.toString().substring(1, data.toString().length()-1)); @@ -67,15 +69,44 @@ public PluginResult execute(String action, JSONArray data, String callbackId) result = new PluginResult(Status.OK); } catch (JSONException e) { - Log.e(ME, "Got JSON Exception " - + e.getMessage()); + Log.e(ME, "Got JSON Exception " + e.getMessage()); result = new PluginResult(Status.JSON_EXCEPTION); } + + // if a notification was touched while we were completely exited, process it now + try + { + BufferedReader inputReader = new BufferedReader(new InputStreamReader(ctx.getApplicationContext().openFileInput("cached_payload"))); + String inputString; + StringBuffer stringBuffer = new StringBuffer(); + while ((inputString = inputReader.readLine()) != null) + { + stringBuffer.append(inputString); + } + + // surface the cached payload + JSONObject jsonObj = new JSONObject(stringBuffer.toString()); + sendJavascript(jsonObj); + ctx.getApplicationContext().getFileStreamPath("cached_payload").delete(); + } + catch (FileNotFoundException fnf) + { + Log.e("REGISTER", fnf.getMessage()); + } + catch (IOException io) + { + io.printStackTrace(); + } + catch (JSONException j) + { + j.printStackTrace(); + } + + PushHandlerActivity.EXITED = false; } else if (UNREGISTER.equals(action)) { GCMRegistrar.unregister(this.ctx.getContext()); - GCMRegistrar.onDestroy(this.ctx.getContext()); Log.v(ME + ":" + UNREGISTER, "GCMRegistrar.unregister called "); result = new PluginResult(Status.OK); @@ -92,21 +123,21 @@ else if (UNREGISTER.equals(action)) { public static void sendJavascript( JSONObject _json ) { - String _d = "javascript:"+gECB+"(" + _json.toString() + ")"; - Log.v(ME + ":sendJavascript", _d); + String _d = "javascript:"+gECB+"(" + _json.toString() + ")"; + Log.v(ME + ":sendJavascript", _d); - if (gECB != null ) { - gwebView.sendJavascript( _d ); - } + if (gECB != null ) { + gwebView.sendJavascript( _d ); + } } - /** - * Gets the Directory listing for file, in JSON format - * @param file The file for which we want to do directory listing - * @return JSONObject representation of directory list. e.g {"filename":"/sdcard","isdir":true,"children":[{"filename":"a.txt","isdir":false},{..}]} - * @throws JSONException - */ - + public void onDestroy() + { + super.onDestroy(); + // let the service know we are exiting so it can cache the next notification payload. + PushHandlerActivity.EXITED = true; + GCMRegistrar.onDestroy(cordova.getContext()); + } } From a6f665db697ceb4642fbd12e6578df3d18b4ab54 Mon Sep 17 00:00:00 2001 From: Bob Easterday Date: Tue, 26 Mar 2013 14:48:07 -0700 Subject: [PATCH 025/133] Update documentation to reflect new coldstart functionality --- README.md | 88 ++++++++++++++++++++++++++++++------------------------- 1 file changed, 48 insertions(+), 40 deletions(-) diff --git a/README.md b/README.md index 022cb189..5c59215a 100644 --- a/README.md +++ b/README.md @@ -188,56 +188,64 @@ In this example, be sure and substitute your own senderID. Get your senderID by // Android - function onNotificationGCM(e) { - switch( e.event ) - { - case 'registered': - if ( e.regid.length > 0 ) - { - // Your GCM push server needs to know the regID before it can push to this device - // here is where you might want to send it the regID for later use. - alert('registration id = e.regid); - } - break; + function onNotificationGCM(e) { + $("#app-status-ul").append('
  • EVENT -> RECEIVED:' + e.event + '
    • '); - case 'message': - // if this flag is set, this notification happened while we were in the foreground. - // you might want to play a sound to get the user's attention, throw up a dialog, etc. - if (e.foreground) - { - $("#app-status-ul").append('
  • --INLINE NOTIFICATION--' + '
    • '); + switch( e.event ) + { + case 'registered': + if ( e.regid.length > 0 ) + { + $("#app-status-ul").append('
  • REGISTERED -> REGID:' + e.regid + "
    • "); + // Your GCM push server needs to know the regID before it can push to this device + // here is where you might want to send it the regID for later use. + console.log("regID = " + e.regID); + } + break; + + case 'message': + // if this flag is set, this notification happened while we were in the foreground. + // you might want to play a sound to get the user's attention, throw up a dialog, etc. + if (e.foreground) + { + $("#app-status-ul").append('
  • --INLINE NOTIFICATION--' + '
    • '); - // if the notification contains a soundname, play it. - var my_media = new Media("/android_asset/www/"+e.soundname); - my_media.play(); - } - else // otherwise we were launched because the user touched a notification in the notification tray. - $("#app-status-ul").append('
  • --BACKGROUND NOTIFICATION--' + '
    • '); + // if the notification contains a soundname, play it. + var my_media = new Media("/android_asset/www/"+e.soundname); + my_media.play(); + } + else + { // otherwise we were launched because the user touched a notification in the notification tray. + if (e.coldstart) + $("#app-status-ul").append('
  • --COLDSTART NOTIFICATION--' + '
    • '); + else + $("#app-status-ul").append('
  • --BACKGROUND NOTIFICATION--' + '
    • '); + } - $("#app-status-ul").append('
  • MESSAGE -> MSG: ' + e.payload.message + '
    • '); - $("#app-status-ul").append('
  • MESSAGE -> MSGCNT: ' + e.payload.msgcnt + '
    • '); - break; - - case 'error': - alert('GCM error = e.msg); - break; - - default: - alert('An unknown GCM event has occurred); - break; - } - } + $("#app-status-ul").append('
  • MESSAGE -> MSG: ' + e.payload.message + '
    • '); + $("#app-status-ul").append('
  • MESSAGE -> MSGCNT: ' + e.payload.msgcnt + '
    • '); + break; + + case 'error': + $("#app-status-ul").append('
  • ERROR -> MSG:' + e.msg + '
    • '); + break; + + default: + $("#app-status-ul").append('
  • EVENT -> Unknown, an event was received and we do not know what it is
    • '); + break; + } + } -Looking at the above message handling code for Android, a few things bear explaination. Your app may receive a notification while it is active (INLINE). If you background the app by hitting the Home button on your device, you may later receive a status bar notification. Selecting that notification from the status will bring your app to the front and allow you to process the notification (BACKGROUND). You can look at the **foreground** flag on the event to determine whether you are processing a background or na in-line notification. You may choose, for example to play a sound or show a dialog only for inline notifications since the user has already been allerted via the status bar. +Looking at the above message handling code for Android, a few things bear explaination. Your app may receive a notification while it is active (INLINE). If you background the app by hitting the Home button on your device, you may later receive a status bar notification. Selecting that notification from the status will bring your app to the front and allow you to process the notification (BACKGROUND). Finally, should you completely exit the app by hitting the back button from the home page, you may still receive a notification. Touching that notification in the notification tray will relaunch your app and allow you to process the notification (COLDSTART). In this case the **coldstart** flag will be set on the incoming event. You can look at the **foreground** flag on the event to determine whether you are processing a background or an in-line notification. You may choose, for example to play a sound or show a dialog only for inline or coldstart notifications since the user has already been alerted via the status bar. -Also make note of the **payload** object. Since the Android notification data model is much more flexible than that of iOS, there may be additional elements beyond **message**, **soundname**, and **msgcnt**. You can access those elements and any additional ones via the payload element. This means that if your data model should change in the future, there will be no need to change and recompile the plugin. +Also make note of the **payload** object. Since the Android notification data model is much more flexible than that of iOS, there may be additional elements beyond **message**, **soundname**, and **msgcnt**. You can access those elements and any additional ones via the **payload** element. This means that if your data model should change in the future, there will be no need to change and recompile the plugin. #### unregister -Call this when your app is exiting to cleanup any used resources. +You will typically call this when your app is exiting, to cleanup any used resources. Its not strictly necessary to call it, and indeed it may be desireable to NOT call it if you are debugging your intermediarry push server. When you call unregister(), the current token for a particular device will get invalidated, and the next call to register() will return a new token. If you do NOT call unregister(), the last token will remain in effect until it is invalidated for some reason at the GCM side. Since such invalidations are beyond your control, its recommended that, in a production environment, that you have a matching unregister() call, for every call to register(), and that your server updates the devices' records each time. pushNotification.unregister(successHandler, errorHandler); -You'll probably want to trap on the **backbutton** event and only call this when the home page is showing. Remember, the back button on android is not the same as the Home button. When you hit the back button from the home page, your activity gets dismissed. While you will still receive status bar notifications thereafter, selecting that notification from the status tray will not sub-launch your app. If you, however, "exit" the app by pressing the home button, subsequent status bar touchs WILL sublaunch your app, giving you the opportunity to process the notification. Here is an example of how to trap the backbutton event; +You'll probably want to trap on the **backbutton** event and only call this when the home page is showing. Remember, the back button on android is not the same as the Home button. When you hit the back button from the home page, your activity gets dismissed. Here is an example of how to trap the backbutton event; function onDeviceReady() { $("#app-status-ul").append('
  • deviceready event received
    • '); From 90fe5b077af088d3a2663d24face45dda6ac9d32 Mon Sep 17 00:00:00 2001 From: markeeftb Date: Wed, 27 Mar 2013 12:31:35 +0100 Subject: [PATCH 026/133] Update README.md You need to add android.permission.GET_TASKS. Without this permission, the application crashes when it receives PUSH NOTIFICATION. --- README.md | 1 + 1 file changed, 1 insertion(+) diff --git a/README.md b/README.md index 5c59215a..70a2a35f 100644 --- a/README.md +++ b/README.md @@ -63,6 +63,7 @@ This plugin is for use with [Cordova](http://incubator.apache.org/cordova/), and + From 43c7d539355589340e0662025b79ef8926f02c29 Mon Sep 17 00:00:00 2001 From: Bob Easterday Date: Thu, 28 Mar 2013 16:11:08 -0700 Subject: [PATCH 027/133] Update PushPlugin for 2.5.0+ --- plugin.xml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/plugin.xml b/plugin.xml index 6436d7bf..5c4b9a4d 100755 --- a/plugin.xml +++ b/plugin.xml @@ -2,7 +2,7 @@ + version="1.2.1"> PushPlugin @@ -51,7 +51,7 @@ - + From 33c34d5df14ff8c2c957a70bd663bf20b6c45a69 Mon Sep 17 00:00:00 2001 From: Bob Easterday Date: Mon, 8 Apr 2013 17:51:50 -0700 Subject: [PATCH 028/133] Get rid of deprecated call to getContext() --- plugin.xml | 2 +- src/android/com/plugin/GCM/PushPlugin.java | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/plugin.xml b/plugin.xml index 5c4b9a4d..cd43b3ed 100755 --- a/plugin.xml +++ b/plugin.xml @@ -2,7 +2,7 @@ + version="1.2.2"> PushPlugin diff --git a/src/android/com/plugin/GCM/PushPlugin.java b/src/android/com/plugin/GCM/PushPlugin.java index 145b5ac2..60215223 100644 --- a/src/android/com/plugin/GCM/PushPlugin.java +++ b/src/android/com/plugin/GCM/PushPlugin.java @@ -138,6 +138,6 @@ public void onDestroy() // let the service know we are exiting so it can cache the next notification payload. PushHandlerActivity.EXITED = true; - GCMRegistrar.onDestroy(cordova.getContext()); + GCMRegistrar.onDestroy(cordova.getActivity()); } } From bf9e04759cfd862e0f59b13d981b7c2857637706 Mon Sep 17 00:00:00 2001 From: Bob Easterday Date: Fri, 10 May 2013 10:12:17 -0700 Subject: [PATCH 029/133] Add plugman support --- plugin.xml | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) diff --git a/plugin.xml b/plugin.xml index cd43b3ed..92cdaebd 100755 --- a/plugin.xml +++ b/plugin.xml @@ -8,6 +8,10 @@ + + + + @@ -55,9 +59,11 @@ - - + + + + From 3b247283c65dc5e7fe8f14231cea85dba9592058 Mon Sep 17 00:00:00 2001 From: Bob Easterday Date: Fri, 10 May 2013 11:36:31 -0700 Subject: [PATCH 030/133] Add jasmin test spec --- spec/config.xml | 20 + spec/genericpush.tests.js | 46 + spec/html/HtmlReporter.js | 101 ++ spec/html/HtmlReporterHelpers.js | 60 + spec/html/ReporterView.js | 164 ++ spec/html/SpecView.js | 79 + spec/html/SuiteView.js | 22 + spec/html/TrivialReporter.js | 192 +++ spec/index.html | 75 + spec/jasmine.css | 81 + spec/jasmine.js | 2530 ++++++++++++++++++++++++++++++ spec/test-runner.js | 62 + 12 files changed, 3432 insertions(+) create mode 100644 spec/config.xml create mode 100644 spec/genericpush.tests.js create mode 100644 spec/html/HtmlReporter.js create mode 100644 spec/html/HtmlReporterHelpers.js create mode 100644 spec/html/ReporterView.js create mode 100644 spec/html/SpecView.js create mode 100644 spec/html/SuiteView.js create mode 100644 spec/html/TrivialReporter.js create mode 100644 spec/index.html create mode 100644 spec/jasmine.css create mode 100644 spec/jasmine.js create mode 100644 spec/test-runner.js diff --git a/spec/config.xml b/spec/config.xml new file mode 100644 index 00000000..0752d62b --- /dev/null +++ b/spec/config.xml @@ -0,0 +1,20 @@ + + + cordovaExample + + + GenericPush Spec + + + + Bob Easterday - PhoneGap Team + + + + + + + diff --git a/spec/genericpush.tests.js b/spec/genericpush.tests.js new file mode 100644 index 00000000..6dc2bd7b --- /dev/null +++ b/spec/genericpush.tests.js @@ -0,0 +1,46 @@ +/* + * + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, + * software distributed under the License is distributed on an + * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + * KIND, either express or implied. See the License for the + * specific language governing permissions and limitations + * under the License. + * +*/ + +describe('Plugin object (window.plugins)', function () { + it("should exist", function() { + expect(window.plugins).toBeDefined(); + }); + + it("should contain a pushNotification object", function() { + expect(window.plugins.pushNotification).toBeDefined(); + expect(typeof window.plugins.pushNotification == 'object').toBe(true); + }); + + it("should contain a register function", function() { + expect(window.plugins.pushNotification.register).toBeDefined(); + expect(typeof window.plugins.barcodeScanner.register == 'function').toBe(true); + }); + + it("should contain an unregister function", function() { + expect(window.plugins.pushNotification.unregister).toBeDefined(); + expect(typeof window.plugins.barcodeScanner.unregister == 'function').toBe(true); + }); + + it("should contain a setApplicationIconBadgeNumber function", function() { + expect(window.plugins.pushNotification.setApplicationIconBadgeNumber).toBeDefined(); + expect(typeof window.plugins.barcodeScanner.setApplicationIconBadgeNumber == 'function').toBe(true); + }); +}); diff --git a/spec/html/HtmlReporter.js b/spec/html/HtmlReporter.js new file mode 100644 index 00000000..7d9d9240 --- /dev/null +++ b/spec/html/HtmlReporter.js @@ -0,0 +1,101 @@ +jasmine.HtmlReporter = function(_doc) { + var self = this; + var doc = _doc || window.document; + + var reporterView; + + var dom = {}; + + // Jasmine Reporter Public Interface + self.logRunningSpecs = false; + + self.reportRunnerStarting = function(runner) { + var specs = runner.specs() || []; + + if (specs.length == 0) { + return; + } + + createReporterDom(runner.env.versionString()); + doc.body.appendChild(dom.reporter); + + reporterView = new jasmine.HtmlReporter.ReporterView(dom); + reporterView.addSpecs(specs, self.specFilter); + }; + + self.reportRunnerResults = function(runner) { + reporterView && reporterView.complete(); + }; + + self.reportSuiteResults = function(suite) { + reporterView.suiteComplete(suite); + }; + + self.reportSpecStarting = function(spec) { + if (self.logRunningSpecs) { + self.log('>> Jasmine Running ' + spec.suite.description + ' ' + spec.description + '...'); + } + }; + + self.reportSpecResults = function(spec) { + reporterView.specComplete(spec); + }; + + self.log = function() { + var console = jasmine.getGlobal().console; + if (console && console.log) { + if (console.log.apply) { + console.log.apply(console, arguments); + } else { + console.log(arguments); // ie fix: console.log.apply doesn't exist on ie + } + } + }; + + self.specFilter = function(spec) { + if (!focusedSpecName()) { + return true; + } + + return spec.getFullName().indexOf(focusedSpecName()) === 0; + }; + + return self; + + function focusedSpecName() { + var specName; + + (function memoizeFocusedSpec() { + if (specName) { + return; + } + + var paramMap = []; + var params = doc.location.search.substring(1).split('&'); + + for (var i = 0; i < params.length; i++) { + var p = params[i].split('='); + paramMap[decodeURIComponent(p[0])] = decodeURIComponent(p[1]); + } + + specName = paramMap.spec; + })(); + + return specName; + } + + function createReporterDom(version) { + dom.reporter = self.createDom('div', { id: 'HTMLReporter', className: 'jasmine_reporter' }, + dom.banner = self.createDom('div', { className: 'banner' }, + self.createDom('span', { className: 'title' }, "Jasmine "), + self.createDom('span', { className: 'version' }, version)), + + dom.symbolSummary = self.createDom('ul', {className: 'symbolSummary'}), + dom.alert = self.createDom('div', {className: 'alert'}), + dom.results = self.createDom('div', {className: 'results'}, + dom.summary = self.createDom('div', { className: 'summary' }), + dom.details = self.createDom('div', { id: 'details' })) + ); + } +}; +jasmine.HtmlReporterHelpers.addHelpers(jasmine.HtmlReporter); diff --git a/spec/html/HtmlReporterHelpers.js b/spec/html/HtmlReporterHelpers.js new file mode 100644 index 00000000..745e1e09 --- /dev/null +++ b/spec/html/HtmlReporterHelpers.js @@ -0,0 +1,60 @@ +jasmine.HtmlReporterHelpers = {}; + +jasmine.HtmlReporterHelpers.createDom = function(type, attrs, childrenVarArgs) { + var el = document.createElement(type); + + for (var i = 2; i < arguments.length; i++) { + var child = arguments[i]; + + if (typeof child === 'string') { + el.appendChild(document.createTextNode(child)); + } else { + if (child) { + el.appendChild(child); + } + } + } + + for (var attr in attrs) { + if (attr == "className") { + el[attr] = attrs[attr]; + } else { + el.setAttribute(attr, attrs[attr]); + } + } + + return el; +}; + +jasmine.HtmlReporterHelpers.getSpecStatus = function(child) { + var results = child.results(); + var status = results.passed() ? 'passed' : 'failed'; + if (results.skipped) { + status = 'skipped'; + } + + return status; +}; + +jasmine.HtmlReporterHelpers.appendToSummary = function(child, childElement) { + var parentDiv = this.dom.summary; + var parentSuite = (typeof child.parentSuite == 'undefined') ? 'suite' : 'parentSuite'; + var parent = child[parentSuite]; + + if (parent) { + if (typeof this.views.suites[parent.id] == 'undefined') { + this.views.suites[parent.id] = new jasmine.HtmlReporter.SuiteView(parent, this.dom, this.views); + } + parentDiv = this.views.suites[parent.id].element; + } + + parentDiv.appendChild(childElement); +}; + + +jasmine.HtmlReporterHelpers.addHelpers = function(ctor) { + for(var fn in jasmine.HtmlReporterHelpers) { + ctor.prototype[fn] = jasmine.HtmlReporterHelpers[fn]; + } +}; + diff --git a/spec/html/ReporterView.js b/spec/html/ReporterView.js new file mode 100644 index 00000000..6a6d0056 --- /dev/null +++ b/spec/html/ReporterView.js @@ -0,0 +1,164 @@ +jasmine.HtmlReporter.ReporterView = function(dom) { + this.startedAt = new Date(); + this.runningSpecCount = 0; + this.completeSpecCount = 0; + this.passedCount = 0; + this.failedCount = 0; + this.skippedCount = 0; + + this.createResultsMenu = function() { + this.resultsMenu = this.createDom('span', {className: 'resultsMenu bar'}, + this.summaryMenuItem = this.createDom('a', {className: 'summaryMenuItem', href: "#"}, '0 specs'), + ' | ', + this.detailsMenuItem = this.createDom('a', {className: 'detailsMenuItem', href: "#"}, '0 failing')); + + this.summaryMenuItem.onclick = function() { + dom.reporter.className = dom.reporter.className.replace(/ showDetails/g, ''); + }; + + this.detailsMenuItem.onclick = function() { + showDetails(); + }; + }; + + this.addSpecs = function(specs, specFilter) { + this.totalSpecCount = specs.length; + + this.views = { + specs: {}, + suites: {} + }; + + for (var i = 0; i < specs.length; i++) { + var spec = specs[i]; + this.views.specs[spec.id] = new jasmine.HtmlReporter.SpecView(spec, dom, this.views); + if (specFilter(spec)) { + this.runningSpecCount++; + } + } + }; + + this.specComplete = function(spec) { + this.completeSpecCount++; + + if (isUndefined(this.views.specs[spec.id])) { + this.views.specs[spec.id] = new jasmine.HtmlReporter.SpecView(spec, dom); + } + + var specView = this.views.specs[spec.id]; + + switch (specView.status()) { + case 'passed': + this.passedCount++; + break; + + case 'failed': + this.failedCount++; + break; + + case 'skipped': + this.skippedCount++; + break; + } + + specView.refresh(); + this.refresh(); + }; + + this.suiteComplete = function(suite) { + var suiteView = this.views.suites[suite.id]; + if (isUndefined(suiteView)) { + return; + } + suiteView.refresh(); + }; + + this.refresh = function() { + + if (isUndefined(this.resultsMenu)) { + this.createResultsMenu(); + } + + // currently running UI + if (isUndefined(this.runningAlert)) { + this.runningAlert = this.createDom('a', {href: "?", className: "runningAlert bar"}); + dom.alert.appendChild(this.runningAlert); + } + this.runningAlert.innerHTML = "Running " + this.completeSpecCount + " of " + specPluralizedFor(this.totalSpecCount); + + // skipped specs UI + if (isUndefined(this.skippedAlert)) { + this.skippedAlert = this.createDom('a', {href: "?", className: "skippedAlert bar"}); + } + + this.skippedAlert.innerHTML = "Skipping " + this.skippedCount + " of " + specPluralizedFor(this.totalSpecCount) + " - run all"; + + if (this.skippedCount === 1 && isDefined(dom.alert)) { + dom.alert.appendChild(this.skippedAlert); + } + + // passing specs UI + if (isUndefined(this.passedAlert)) { + this.passedAlert = this.createDom('span', {href: "?", className: "passingAlert bar"}); + } + this.passedAlert.innerHTML = "Passing " + specPluralizedFor(this.passedCount); + + // failing specs UI + if (isUndefined(this.failedAlert)) { + this.failedAlert = this.createDom('span', {href: "?", className: "failingAlert bar"}); + } + this.failedAlert.innerHTML = "Failing " + specPluralizedFor(this.failedCount); + + if (this.failedCount === 1 && isDefined(dom.alert)) { + dom.alert.appendChild(this.failedAlert); + dom.alert.appendChild(this.resultsMenu); + } + + // summary info + this.summaryMenuItem.innerHTML = "" + specPluralizedFor(this.runningSpecCount); + this.detailsMenuItem.innerHTML = "" + this.failedCount + " failing"; + }; + + this.complete = function() { + dom.alert.removeChild(this.runningAlert); + + this.skippedAlert.innerHTML = "Ran " + this.runningSpecCount + " of " + specPluralizedFor(this.totalSpecCount) + " - run all"; + + if (this.failedCount === 0) { + dom.alert.appendChild(this.createDom('span', {className: 'passingAlert bar'}, "Passing " + specPluralizedFor(this.passedCount))); + } else { + showDetails(); + } + + dom.banner.appendChild(this.createDom('span', {className: 'duration'}, "finished in " + ((new Date().getTime() - this.startedAt.getTime()) / 1000) + "s")); + }; + + return this; + + function showDetails() { + if (dom.reporter.className.search(/showDetails/) === -1) { + dom.reporter.className += " showDetails"; + } + } + + function isUndefined(obj) { + return typeof obj === 'undefined'; + } + + function isDefined(obj) { + return !isUndefined(obj); + } + + function specPluralizedFor(count) { + var str = count + " spec"; + if (count > 1) { + str += "s" + } + return str; + } + +}; + +jasmine.HtmlReporterHelpers.addHelpers(jasmine.HtmlReporter.ReporterView); + + diff --git a/spec/html/SpecView.js b/spec/html/SpecView.js new file mode 100644 index 00000000..8769bb84 --- /dev/null +++ b/spec/html/SpecView.js @@ -0,0 +1,79 @@ +jasmine.HtmlReporter.SpecView = function(spec, dom, views) { + this.spec = spec; + this.dom = dom; + this.views = views; + + this.symbol = this.createDom('li', { className: 'pending' }); + this.dom.symbolSummary.appendChild(this.symbol); + + this.summary = this.createDom('div', { className: 'specSummary' }, + this.createDom('a', { + className: 'description', + href: '?spec=' + encodeURIComponent(this.spec.getFullName()), + title: this.spec.getFullName() + }, this.spec.description) + ); + + this.detail = this.createDom('div', { className: 'specDetail' }, + this.createDom('a', { + className: 'description', + href: '?spec=' + encodeURIComponent(this.spec.getFullName()), + title: this.spec.getFullName() + }, this.spec.getFullName()) + ); +}; + +jasmine.HtmlReporter.SpecView.prototype.status = function() { + return this.getSpecStatus(this.spec); +}; + +jasmine.HtmlReporter.SpecView.prototype.refresh = function() { + this.symbol.className = this.status(); + + switch (this.status()) { + case 'skipped': + break; + + case 'passed': + this.appendSummaryToSuiteDiv(); + break; + + case 'failed': + this.appendSummaryToSuiteDiv(); + this.appendFailureDetail(); + break; + } +}; + +jasmine.HtmlReporter.SpecView.prototype.appendSummaryToSuiteDiv = function() { + this.summary.className += ' ' + this.status(); + this.appendToSummary(this.spec, this.summary); +}; + +jasmine.HtmlReporter.SpecView.prototype.appendFailureDetail = function() { + this.detail.className += ' ' + this.status(); + + var resultItems = this.spec.results().getItems(); + var messagesDiv = this.createDom('div', { className: 'messages' }); + + for (var i = 0; i < resultItems.length; i++) { + var result = resultItems[i]; + + if (result.type == 'log') { + messagesDiv.appendChild(this.createDom('div', {className: 'resultMessage log'}, result.toString())); + } else if (result.type == 'expect' && result.passed && !result.passed()) { + messagesDiv.appendChild(this.createDom('div', {className: 'resultMessage fail'}, result.message)); + + if (result.trace.stack) { + messagesDiv.appendChild(this.createDom('div', {className: 'stackTrace'}, result.trace.stack)); + } + } + } + + if (messagesDiv.childNodes.length > 0) { + this.detail.appendChild(messagesDiv); + this.dom.details.appendChild(this.detail); + } +}; + +jasmine.HtmlReporterHelpers.addHelpers(jasmine.HtmlReporter.SpecView); \ No newline at end of file diff --git a/spec/html/SuiteView.js b/spec/html/SuiteView.js new file mode 100644 index 00000000..19a1efaf --- /dev/null +++ b/spec/html/SuiteView.js @@ -0,0 +1,22 @@ +jasmine.HtmlReporter.SuiteView = function(suite, dom, views) { + this.suite = suite; + this.dom = dom; + this.views = views; + + this.element = this.createDom('div', { className: 'suite' }, + this.createDom('a', { className: 'description', href: '?spec=' + encodeURIComponent(this.suite.getFullName()) }, this.suite.description) + ); + + this.appendToSummary(this.suite, this.element); +}; + +jasmine.HtmlReporter.SuiteView.prototype.status = function() { + return this.getSpecStatus(this.suite); +}; + +jasmine.HtmlReporter.SuiteView.prototype.refresh = function() { + this.element.className += " " + this.status(); +}; + +jasmine.HtmlReporterHelpers.addHelpers(jasmine.HtmlReporter.SuiteView); + diff --git a/spec/html/TrivialReporter.js b/spec/html/TrivialReporter.js new file mode 100644 index 00000000..167ac506 --- /dev/null +++ b/spec/html/TrivialReporter.js @@ -0,0 +1,192 @@ +/* @deprecated Use jasmine.HtmlReporter instead + */ +jasmine.TrivialReporter = function(doc) { + this.document = doc || document; + this.suiteDivs = {}; + this.logRunningSpecs = false; +}; + +jasmine.TrivialReporter.prototype.createDom = function(type, attrs, childrenVarArgs) { + var el = document.createElement(type); + + for (var i = 2; i < arguments.length; i++) { + var child = arguments[i]; + + if (typeof child === 'string') { + el.appendChild(document.createTextNode(child)); + } else { + if (child) { el.appendChild(child); } + } + } + + for (var attr in attrs) { + if (attr == "className") { + el[attr] = attrs[attr]; + } else { + el.setAttribute(attr, attrs[attr]); + } + } + + return el; +}; + +jasmine.TrivialReporter.prototype.reportRunnerStarting = function(runner) { + var showPassed, showSkipped; + + this.outerDiv = this.createDom('div', { id: 'TrivialReporter', className: 'jasmine_reporter' }, + this.createDom('div', { className: 'banner' }, + this.createDom('div', { className: 'logo' }, + this.createDom('span', { className: 'title' }, "Jasmine"), + this.createDom('span', { className: 'version' }, runner.env.versionString())), + this.createDom('div', { className: 'options' }, + "Show ", + showPassed = this.createDom('input', { id: "__jasmine_TrivialReporter_showPassed__", type: 'checkbox' }), + this.createDom('label', { "for": "__jasmine_TrivialReporter_showPassed__" }, " passed "), + showSkipped = this.createDom('input', { id: "__jasmine_TrivialReporter_showSkipped__", type: 'checkbox' }), + this.createDom('label', { "for": "__jasmine_TrivialReporter_showSkipped__" }, " skipped") + ) + ), + + this.runnerDiv = this.createDom('div', { className: 'runner running' }, + this.createDom('a', { className: 'run_spec', href: '?' }, "run all"), + this.runnerMessageSpan = this.createDom('span', {}, "Running..."), + this.finishedAtSpan = this.createDom('span', { className: 'finished-at' }, "")) + ); + + this.document.body.appendChild(this.outerDiv); + + var suites = runner.suites(); + for (var i = 0; i < suites.length; i++) { + var suite = suites[i]; + var suiteDiv = this.createDom('div', { className: 'suite' }, + this.createDom('a', { className: 'run_spec', href: '?spec=' + encodeURIComponent(suite.getFullName()) }, "run"), + this.createDom('a', { className: 'description', href: '?spec=' + encodeURIComponent(suite.getFullName()) }, suite.description)); + this.suiteDivs[suite.id] = suiteDiv; + var parentDiv = this.outerDiv; + if (suite.parentSuite) { + parentDiv = this.suiteDivs[suite.parentSuite.id]; + } + parentDiv.appendChild(suiteDiv); + } + + this.startedAt = new Date(); + + var self = this; + showPassed.onclick = function(evt) { + if (showPassed.checked) { + self.outerDiv.className += ' show-passed'; + } else { + self.outerDiv.className = self.outerDiv.className.replace(/ show-passed/, ''); + } + }; + + showSkipped.onclick = function(evt) { + if (showSkipped.checked) { + self.outerDiv.className += ' show-skipped'; + } else { + self.outerDiv.className = self.outerDiv.className.replace(/ show-skipped/, ''); + } + }; +}; + +jasmine.TrivialReporter.prototype.reportRunnerResults = function(runner) { + var results = runner.results(); + var className = (results.failedCount > 0) ? "runner failed" : "runner passed"; + this.runnerDiv.setAttribute("class", className); + //do it twice for IE + this.runnerDiv.setAttribute("className", className); + var specs = runner.specs(); + var specCount = 0; + for (var i = 0; i < specs.length; i++) { + if (this.specFilter(specs[i])) { + specCount++; + } + } + var message = "" + specCount + " spec" + (specCount == 1 ? "" : "s" ) + ", " + results.failedCount + " failure" + ((results.failedCount == 1) ? "" : "s"); + message += " in " + ((new Date().getTime() - this.startedAt.getTime()) / 1000) + "s"; + this.runnerMessageSpan.replaceChild(this.createDom('a', { className: 'description', href: '?'}, message), this.runnerMessageSpan.firstChild); + + this.finishedAtSpan.appendChild(document.createTextNode("Finished at " + new Date().toString())); +}; + +jasmine.TrivialReporter.prototype.reportSuiteResults = function(suite) { + var results = suite.results(); + var status = results.passed() ? 'passed' : 'failed'; + if (results.totalCount === 0) { // todo: change this to check results.skipped + status = 'skipped'; + } + this.suiteDivs[suite.id].className += " " + status; +}; + +jasmine.TrivialReporter.prototype.reportSpecStarting = function(spec) { + if (this.logRunningSpecs) { + this.log('>> Jasmine Running ' + spec.suite.description + ' ' + spec.description + '...'); + } +}; + +jasmine.TrivialReporter.prototype.reportSpecResults = function(spec) { + var results = spec.results(); + var status = results.passed() ? 'passed' : 'failed'; + if (results.skipped) { + status = 'skipped'; + } + var specDiv = this.createDom('div', { className: 'spec ' + status }, + this.createDom('a', { className: 'run_spec', href: '?spec=' + encodeURIComponent(spec.getFullName()) }, "run"), + this.createDom('a', { + className: 'description', + href: '?spec=' + encodeURIComponent(spec.getFullName()), + title: spec.getFullName() + }, spec.description)); + + + var resultItems = results.getItems(); + var messagesDiv = this.createDom('div', { className: 'messages' }); + for (var i = 0; i < resultItems.length; i++) { + var result = resultItems[i]; + + if (result.type == 'log') { + messagesDiv.appendChild(this.createDom('div', {className: 'resultMessage log'}, result.toString())); + } else if (result.type == 'expect' && result.passed && !result.passed()) { + messagesDiv.appendChild(this.createDom('div', {className: 'resultMessage fail'}, result.message)); + + if (result.trace.stack) { + messagesDiv.appendChild(this.createDom('div', {className: 'stackTrace'}, result.trace.stack)); + } + } + } + + if (messagesDiv.childNodes.length > 0) { + specDiv.appendChild(messagesDiv); + } + + this.suiteDivs[spec.suite.id].appendChild(specDiv); +}; + +jasmine.TrivialReporter.prototype.log = function() { + var console = jasmine.getGlobal().console; + if (console && console.log) { + if (console.log.apply) { + console.log.apply(console, arguments); + } else { + console.log(arguments); // ie fix: console.log.apply doesn't exist on ie + } + } +}; + +jasmine.TrivialReporter.prototype.getLocation = function() { + return this.document.location; +}; + +jasmine.TrivialReporter.prototype.specFilter = function(spec) { + var paramMap = {}; + var params = this.getLocation().search.substring(1).split('&'); + for (var i = 0; i < params.length; i++) { + var p = params[i].split('='); + paramMap[decodeURIComponent(p[0])] = decodeURIComponent(p[1]); + } + + if (!paramMap.spec) { + return true; + } + return spec.getFullName().indexOf(paramMap.spec) === 0; +}; diff --git a/spec/index.html b/spec/index.html new file mode 100644 index 00000000..a6bcd8b4 --- /dev/null +++ b/spec/index.html @@ -0,0 +1,75 @@ + + + + + + + Cordova: API Specs + + + + + + + + + + + + + + + + + + + + + + + + + + + + +     Back + + diff --git a/spec/jasmine.css b/spec/jasmine.css new file mode 100644 index 00000000..826e5753 --- /dev/null +++ b/spec/jasmine.css @@ -0,0 +1,81 @@ +body { background-color: #eeeeee; padding: 0; margin: 5px; overflow-y: scroll; } + +#HTMLReporter { font-size: 11px; font-family: Monaco, "Lucida Console", monospace; line-height: 14px; color: #333333; } +#HTMLReporter a { text-decoration: none; } +#HTMLReporter a:hover { text-decoration: underline; } +#HTMLReporter p, #HTMLReporter h1, #HTMLReporter h2, #HTMLReporter h3, #HTMLReporter h4, #HTMLReporter h5, #HTMLReporter h6 { margin: 0; line-height: 14px; } +#HTMLReporter .banner, #HTMLReporter .symbolSummary, #HTMLReporter .summary, #HTMLReporter .resultMessage, #HTMLReporter .specDetail .description, #HTMLReporter .alert .bar, #HTMLReporter .stackTrace { padding-left: 9px; padding-right: 9px; } +#HTMLReporter #jasmine_content { position: fixed; right: 100%; } +#HTMLReporter .version { color: #aaaaaa; } +#HTMLReporter .banner { margin-top: 14px; } +#HTMLReporter .duration { color: #aaaaaa; float: right; } +#HTMLReporter .symbolSummary { overflow: hidden; *zoom: 1; margin: 14px 0; } +#HTMLReporter .symbolSummary li { display: block; float: left; height: 7px; width: 14px; margin-bottom: 7px; font-size: 16px; } +#HTMLReporter .symbolSummary li.passed { font-size: 14px; } +#HTMLReporter .symbolSummary li.passed:before { color: #5e7d00; content: "\02022"; } +#HTMLReporter .symbolSummary li.failed { line-height: 9px; } +#HTMLReporter .symbolSummary li.failed:before { color: #b03911; content: "x"; font-weight: bold; margin-left: -1px; } +#HTMLReporter .symbolSummary li.skipped { font-size: 14px; } +#HTMLReporter .symbolSummary li.skipped:before { color: #bababa; content: "\02022"; } +#HTMLReporter .symbolSummary li.pending { line-height: 11px; } +#HTMLReporter .symbolSummary li.pending:before { color: #aaaaaa; content: "-"; } +#HTMLReporter .bar { line-height: 28px; font-size: 14px; display: block; color: #eee; } +#HTMLReporter .runningAlert { background-color: #666666; } +#HTMLReporter .skippedAlert { background-color: #aaaaaa; } +#HTMLReporter .skippedAlert:first-child { background-color: #333333; } +#HTMLReporter .skippedAlert:hover { text-decoration: none; color: white; text-decoration: underline; } +#HTMLReporter .passingAlert { background-color: #a6b779; } +#HTMLReporter .passingAlert:first-child { background-color: #5e7d00; } +#HTMLReporter .failingAlert { background-color: #cf867e; } +#HTMLReporter .failingAlert:first-child { background-color: #b03911; } +#HTMLReporter .results { margin-top: 14px; } +#HTMLReporter #details { display: none; } +#HTMLReporter .resultsMenu, #HTMLReporter .resultsMenu a { background-color: #fff; color: #333333; } +#HTMLReporter.showDetails .summaryMenuItem { font-weight: normal; text-decoration: inherit; } +#HTMLReporter.showDetails .summaryMenuItem:hover { text-decoration: underline; } +#HTMLReporter.showDetails .detailsMenuItem { font-weight: bold; text-decoration: underline; } +#HTMLReporter.showDetails .summary { display: none; } +#HTMLReporter.showDetails #details { display: block; } +#HTMLReporter .summaryMenuItem { font-weight: bold; text-decoration: underline; } +#HTMLReporter .summary { margin-top: 14px; } +#HTMLReporter .summary .suite .suite, #HTMLReporter .summary .specSummary { margin-left: 14px; } +#HTMLReporter .summary .specSummary.passed a { color: #5e7d00; } +#HTMLReporter .summary .specSummary.failed a { color: #b03911; } +#HTMLReporter .description + .suite { margin-top: 0; } +#HTMLReporter .suite { margin-top: 14px; } +#HTMLReporter .suite a { color: #333333; } +#HTMLReporter #details .specDetail { margin-bottom: 28px; } +#HTMLReporter #details .specDetail .description { display: block; color: white; background-color: #b03911; } +#HTMLReporter .resultMessage { padding-top: 14px; color: #333333; } +#HTMLReporter .resultMessage span.result { display: block; } +#HTMLReporter .stackTrace { margin: 5px 0 0 0; max-height: 224px; overflow: auto; line-height: 18px; color: #666666; border: 1px solid #ddd; background: white; white-space: pre; } + +#TrivialReporter { padding: 8px 13px; position: absolute; top: 0; bottom: 0; left: 0; right: 0; overflow-y: scroll; background-color: white; font-family: "Helvetica Neue Light", "Lucida Grande", "Calibri", "Arial", sans-serif; /*.resultMessage {*/ /*white-space: pre;*/ /*}*/ } +#TrivialReporter a:visited, #TrivialReporter a { color: #303; } +#TrivialReporter a:hover, #TrivialReporter a:active { color: blue; } +#TrivialReporter .run_spec { float: right; padding-right: 5px; font-size: .8em; text-decoration: none; } +#TrivialReporter .banner { color: #303; background-color: #fef; padding: 5px; } +#TrivialReporter .logo { float: left; font-size: 1.1em; padding-left: 5px; } +#TrivialReporter .logo .version { font-size: .6em; padding-left: 1em; } +#TrivialReporter .runner.running { background-color: yellow; } +#TrivialReporter .options { text-align: right; font-size: .8em; } +#TrivialReporter .suite { border: 1px outset gray; margin: 5px 0; padding-left: 1em; } +#TrivialReporter .suite .suite { margin: 5px; } +#TrivialReporter .suite.passed { background-color: #dfd; } +#TrivialReporter .suite.failed { background-color: #fdd; } +#TrivialReporter .spec { margin: 5px; padding-left: 1em; clear: both; } +#TrivialReporter .spec.failed, #TrivialReporter .spec.passed, #TrivialReporter .spec.skipped { padding-bottom: 5px; border: 1px solid gray; } +#TrivialReporter .spec.failed { background-color: #fbb; border-color: red; } +#TrivialReporter .spec.passed { background-color: #bfb; border-color: green; } +#TrivialReporter .spec.skipped { background-color: #bbb; } +#TrivialReporter .messages { border-left: 1px dashed gray; padding-left: 1em; padding-right: 1em; } +#TrivialReporter .passed { background-color: #cfc; display: none; } +#TrivialReporter .failed { background-color: #fbb; } +#TrivialReporter .skipped { color: #777; background-color: #eee; display: none; } +#TrivialReporter .resultMessage span.result { display: block; line-height: 2em; color: black; } +#TrivialReporter .resultMessage .mismatch { color: black; } +#TrivialReporter .stackTrace { white-space: pre; font-size: .8em; margin-left: 10px; max-height: 5em; overflow: auto; border: 1px inset red; padding: 1em; background: #eef; } +#TrivialReporter .finished-at { padding-left: 1em; font-size: .6em; } +#TrivialReporter.show-passed .passed, #TrivialReporter.show-skipped .skipped { display: block; } +#TrivialReporter #jasmine_content { position: fixed; right: 100%; } +#TrivialReporter .runner { border: 1px solid gray; display: block; margin: 5px 0; padding: 2px 0 2px 10px; } diff --git a/spec/jasmine.js b/spec/jasmine.js new file mode 100644 index 00000000..bccb66c3 --- /dev/null +++ b/spec/jasmine.js @@ -0,0 +1,2530 @@ +var isCommonJS = typeof window == "undefined"; + +/** + * Top level namespace for Jasmine, a lightweight JavaScript BDD/spec/testing framework. + * + * @namespace + */ +var jasmine = {}; +if (isCommonJS) exports.jasmine = jasmine; +/** + * @private + */ +jasmine.unimplementedMethod_ = function() { + throw new Error("unimplemented method"); +}; + +/** + * Use jasmine.undefined instead of undefined, since undefined is just + * a plain old variable and may be redefined by somebody else. + * + * @private + */ +jasmine.undefined = jasmine.___undefined___; + +/** + * Show diagnostic messages in the console if set to true + * + */ +jasmine.VERBOSE = false; + +/** + * Default interval in milliseconds for event loop yields (e.g. to allow network activity or to refresh the screen with the HTML-based runner). Small values here may result in slow test running. Zero means no updates until all tests have completed. + * + */ +jasmine.DEFAULT_UPDATE_INTERVAL = 250; + +/** + * Default timeout interval in milliseconds for waitsFor() blocks. + */ +jasmine.DEFAULT_TIMEOUT_INTERVAL = 5000; + +jasmine.getGlobal = function() { + function getGlobal() { + return this; + } + + return getGlobal(); +}; + +/** + * Allows for bound functions to be compared. Internal use only. + * + * @ignore + * @private + * @param base {Object} bound 'this' for the function + * @param name {Function} function to find + */ +jasmine.bindOriginal_ = function(base, name) { + var original = base[name]; + if (original.apply) { + return function() { + return original.apply(base, arguments); + }; + } else { + // IE support + return jasmine.getGlobal()[name]; + } +}; + +jasmine.setTimeout = jasmine.bindOriginal_(jasmine.getGlobal(), 'setTimeout'); +jasmine.clearTimeout = jasmine.bindOriginal_(jasmine.getGlobal(), 'clearTimeout'); +jasmine.setInterval = jasmine.bindOriginal_(jasmine.getGlobal(), 'setInterval'); +jasmine.clearInterval = jasmine.bindOriginal_(jasmine.getGlobal(), 'clearInterval'); + +jasmine.MessageResult = function(values) { + this.type = 'log'; + this.values = values; + this.trace = new Error(); // todo: test better +}; + +jasmine.MessageResult.prototype.toString = function() { + var text = ""; + for (var i = 0; i < this.values.length; i++) { + if (i > 0) text += " "; + if (jasmine.isString_(this.values[i])) { + text += this.values[i]; + } else { + text += jasmine.pp(this.values[i]); + } + } + return text; +}; + +jasmine.ExpectationResult = function(params) { + this.type = 'expect'; + this.matcherName = params.matcherName; + this.passed_ = params.passed; + this.expected = params.expected; + this.actual = params.actual; + this.message = this.passed_ ? 'Passed.' : params.message; + + var trace = (params.trace || new Error(this.message)); + this.trace = this.passed_ ? '' : trace; +}; + +jasmine.ExpectationResult.prototype.toString = function () { + return this.message; +}; + +jasmine.ExpectationResult.prototype.passed = function () { + return this.passed_; +}; + +/** + * Getter for the Jasmine environment. Ensures one gets created + */ +jasmine.getEnv = function() { + var env = jasmine.currentEnv_ = jasmine.currentEnv_ || new jasmine.Env(); + return env; +}; + +/** + * @ignore + * @private + * @param value + * @returns {Boolean} + */ +jasmine.isArray_ = function(value) { + return jasmine.isA_("Array", value); +}; + +/** + * @ignore + * @private + * @param value + * @returns {Boolean} + */ +jasmine.isString_ = function(value) { + return jasmine.isA_("String", value); +}; + +/** + * @ignore + * @private + * @param value + * @returns {Boolean} + */ +jasmine.isNumber_ = function(value) { + return jasmine.isA_("Number", value); +}; + +/** + * @ignore + * @private + * @param {String} typeName + * @param value + * @returns {Boolean} + */ +jasmine.isA_ = function(typeName, value) { + return Object.prototype.toString.apply(value) === '[object ' + typeName + ']'; +}; + +/** + * Pretty printer for expecations. Takes any object and turns it into a human-readable string. + * + * @param value {Object} an object to be outputted + * @returns {String} + */ +jasmine.pp = function(value) { + var stringPrettyPrinter = new jasmine.StringPrettyPrinter(); + stringPrettyPrinter.format(value); + return stringPrettyPrinter.string; +}; + +/** + * Returns true if the object is a DOM Node. + * + * @param {Object} obj object to check + * @returns {Boolean} + */ +jasmine.isDomNode = function(obj) { + return obj.nodeType > 0; +}; + +/** + * Returns a matchable 'generic' object of the class type. For use in expecations of type when values don't matter. + * + * @example + * // don't care about which function is passed in, as long as it's a function + * expect(mySpy).toHaveBeenCalledWith(jasmine.any(Function)); + * + * @param {Class} clazz + * @returns matchable object of the type clazz + */ +jasmine.any = function(clazz) { + return new jasmine.Matchers.Any(clazz); +}; + +/** + * Returns a matchable subset of a JSON object. For use in expectations when you don't care about all of the + * attributes on the object. + * + * @example + * // don't care about any other attributes than foo. + * expect(mySpy).toHaveBeenCalledWith(jasmine.objectContaining({foo: "bar"}); + * + * @param sample {Object} sample + * @returns matchable object for the sample + */ +jasmine.objectContaining = function (sample) { + return new jasmine.Matchers.ObjectContaining(sample); +}; + +/** + * Jasmine Spies are test doubles that can act as stubs, spies, fakes or when used in an expecation, mocks. + * + * Spies should be created in test setup, before expectations. They can then be checked, using the standard Jasmine + * expectation syntax. Spies can be checked if they were called or not and what the calling params were. + * + * A Spy has the following fields: wasCalled, callCount, mostRecentCall, and argsForCall (see docs). + * + * Spies are torn down at the end of every spec. + * + * Note: Do not call new jasmine.Spy() directly - a spy must be created using spyOn, jasmine.createSpy or jasmine.createSpyObj. + * + * @example + * // a stub + * var myStub = jasmine.createSpy('myStub'); // can be used anywhere + * + * // spy example + * var foo = { + * not: function(bool) { return !bool; } + * } + * + * // actual foo.not will not be called, execution stops + * spyOn(foo, 'not'); + + // foo.not spied upon, execution will continue to implementation + * spyOn(foo, 'not').andCallThrough(); + * + * // fake example + * var foo = { + * not: function(bool) { return !bool; } + * } + * + * // foo.not(val) will return val + * spyOn(foo, 'not').andCallFake(function(value) {return value;}); + * + * // mock example + * foo.not(7 == 7); + * expect(foo.not).toHaveBeenCalled(); + * expect(foo.not).toHaveBeenCalledWith(true); + * + * @constructor + * @see spyOn, jasmine.createSpy, jasmine.createSpyObj + * @param {String} name + */ +jasmine.Spy = function(name) { + /** + * The name of the spy, if provided. + */ + this.identity = name || 'unknown'; + /** + * Is this Object a spy? + */ + this.isSpy = true; + /** + * The actual function this spy stubs. + */ + this.plan = function() { + }; + /** + * Tracking of the most recent call to the spy. + * @example + * var mySpy = jasmine.createSpy('foo'); + * mySpy(1, 2); + * mySpy.mostRecentCall.args = [1, 2]; + */ + this.mostRecentCall = {}; + + /** + * Holds arguments for each call to the spy, indexed by call count + * @example + * var mySpy = jasmine.createSpy('foo'); + * mySpy(1, 2); + * mySpy(7, 8); + * mySpy.mostRecentCall.args = [7, 8]; + * mySpy.argsForCall[0] = [1, 2]; + * mySpy.argsForCall[1] = [7, 8]; + */ + this.argsForCall = []; + this.calls = []; +}; + +/** + * Tells a spy to call through to the actual implemenatation. + * + * @example + * var foo = { + * bar: function() { // do some stuff } + * } + * + * // defining a spy on an existing property: foo.bar + * spyOn(foo, 'bar').andCallThrough(); + */ +jasmine.Spy.prototype.andCallThrough = function() { + this.plan = this.originalValue; + return this; +}; + +/** + * For setting the return value of a spy. + * + * @example + * // defining a spy from scratch: foo() returns 'baz' + * var foo = jasmine.createSpy('spy on foo').andReturn('baz'); + * + * // defining a spy on an existing property: foo.bar() returns 'baz' + * spyOn(foo, 'bar').andReturn('baz'); + * + * @param {Object} value + */ +jasmine.Spy.prototype.andReturn = function(value) { + this.plan = function() { + return value; + }; + return this; +}; + +/** + * For throwing an exception when a spy is called. + * + * @example + * // defining a spy from scratch: foo() throws an exception w/ message 'ouch' + * var foo = jasmine.createSpy('spy on foo').andThrow('baz'); + * + * // defining a spy on an existing property: foo.bar() throws an exception w/ message 'ouch' + * spyOn(foo, 'bar').andThrow('baz'); + * + * @param {String} exceptionMsg + */ +jasmine.Spy.prototype.andThrow = function(exceptionMsg) { + this.plan = function() { + throw exceptionMsg; + }; + return this; +}; + +/** + * Calls an alternate implementation when a spy is called. + * + * @example + * var baz = function() { + * // do some stuff, return something + * } + * // defining a spy from scratch: foo() calls the function baz + * var foo = jasmine.createSpy('spy on foo').andCall(baz); + * + * // defining a spy on an existing property: foo.bar() calls an anonymnous function + * spyOn(foo, 'bar').andCall(function() { return 'baz';} ); + * + * @param {Function} fakeFunc + */ +jasmine.Spy.prototype.andCallFake = function(fakeFunc) { + this.plan = fakeFunc; + return this; +}; + +/** + * Resets all of a spy's the tracking variables so that it can be used again. + * + * @example + * spyOn(foo, 'bar'); + * + * foo.bar(); + * + * expect(foo.bar.callCount).toEqual(1); + * + * foo.bar.reset(); + * + * expect(foo.bar.callCount).toEqual(0); + */ +jasmine.Spy.prototype.reset = function() { + this.wasCalled = false; + this.callCount = 0; + this.argsForCall = []; + this.calls = []; + this.mostRecentCall = {}; +}; + +jasmine.createSpy = function(name) { + + var spyObj = function() { + spyObj.wasCalled = true; + spyObj.callCount++; + var args = jasmine.util.argsToArray(arguments); + spyObj.mostRecentCall.object = this; + spyObj.mostRecentCall.args = args; + spyObj.argsForCall.push(args); + spyObj.calls.push({object: this, args: args}); + return spyObj.plan.apply(this, arguments); + }; + + var spy = new jasmine.Spy(name); + + for (var prop in spy) { + spyObj[prop] = spy[prop]; + } + + spyObj.reset(); + + return spyObj; +}; + +/** + * Determines whether an object is a spy. + * + * @param {jasmine.Spy|Object} putativeSpy + * @returns {Boolean} + */ +jasmine.isSpy = function(putativeSpy) { + return putativeSpy && putativeSpy.isSpy; +}; + +/** + * Creates a more complicated spy: an Object that has every property a function that is a spy. Used for stubbing something + * large in one call. + * + * @param {String} baseName name of spy class + * @param {Array} methodNames array of names of methods to make spies + */ +jasmine.createSpyObj = function(baseName, methodNames) { + if (!jasmine.isArray_(methodNames) || methodNames.length === 0) { + throw new Error('createSpyObj requires a non-empty array of method names to create spies for'); + } + var obj = {}; + for (var i = 0; i < methodNames.length; i++) { + obj[methodNames[i]] = jasmine.createSpy(baseName + '.' + methodNames[i]); + } + return obj; +}; + +/** + * All parameters are pretty-printed and concatenated together, then written to the current spec's output. + * + * Be careful not to leave calls to jasmine.log in production code. + */ +jasmine.log = function() { + var spec = jasmine.getEnv().currentSpec; + spec.log.apply(spec, arguments); +}; + +/** + * Function that installs a spy on an existing object's method name. Used within a Spec to create a spy. + * + * @example + * // spy example + * var foo = { + * not: function(bool) { return !bool; } + * } + * spyOn(foo, 'not'); // actual foo.not will not be called, execution stops + * + * @see jasmine.createSpy + * @param obj + * @param methodName + * @returns a Jasmine spy that can be chained with all spy methods + */ +var spyOn = function(obj, methodName) { + return jasmine.getEnv().currentSpec.spyOn(obj, methodName); +}; +if (isCommonJS) exports.spyOn = spyOn; + +/** + * Creates a Jasmine spec that will be added to the current suite. + * + * // TODO: pending tests + * + * @example + * it('should be true', function() { + * expect(true).toEqual(true); + * }); + * + * @param {String} desc description of this specification + * @param {Function} func defines the preconditions and expectations of the spec + */ +var it = function(desc, func) { + return jasmine.getEnv().it(desc, func); +}; +if (isCommonJS) exports.it = it; + +/** + * Creates a disabled Jasmine spec. + * + * A convenience method that allows existing specs to be disabled temporarily during development. + * + * @param {String} desc description of this specification + * @param {Function} func defines the preconditions and expectations of the spec + */ +var xit = function(desc, func) { + return jasmine.getEnv().xit(desc, func); +}; +if (isCommonJS) exports.xit = xit; + +/** + * Starts a chain for a Jasmine expectation. + * + * It is passed an Object that is the actual value and should chain to one of the many + * jasmine.Matchers functions. + * + * @param {Object} actual Actual value to test against and expected value + */ +var expect = function(actual) { + return jasmine.getEnv().currentSpec.expect(actual); +}; +if (isCommonJS) exports.expect = expect; + +/** + * Defines part of a jasmine spec. Used in cominbination with waits or waitsFor in asynchrnous specs. + * + * @param {Function} func Function that defines part of a jasmine spec. + */ +var runs = function(func) { + jasmine.getEnv().currentSpec.runs(func); +}; +if (isCommonJS) exports.runs = runs; + +/** + * Waits a fixed time period before moving to the next block. + * + * @deprecated Use waitsFor() instead + * @param {Number} timeout milliseconds to wait + */ +var waits = function(timeout) { + jasmine.getEnv().currentSpec.waits(timeout); +}; +if (isCommonJS) exports.waits = waits; + +/** + * Waits for the latchFunction to return true before proceeding to the next block. + * + * @param {Function} latchFunction + * @param {String} optional_timeoutMessage + * @param {Number} optional_timeout + */ +var waitsFor = function(latchFunction, optional_timeoutMessage, optional_timeout) { + jasmine.getEnv().currentSpec.waitsFor.apply(jasmine.getEnv().currentSpec, arguments); +}; +if (isCommonJS) exports.waitsFor = waitsFor; + +/** + * A function that is called before each spec in a suite. + * + * Used for spec setup, including validating assumptions. + * + * @param {Function} beforeEachFunction + */ +var beforeEach = function(beforeEachFunction) { + jasmine.getEnv().beforeEach(beforeEachFunction); +}; +if (isCommonJS) exports.beforeEach = beforeEach; + +/** + * A function that is called after each spec in a suite. + * + * Used for restoring any state that is hijacked during spec execution. + * + * @param {Function} afterEachFunction + */ +var afterEach = function(afterEachFunction) { + jasmine.getEnv().afterEach(afterEachFunction); +}; +if (isCommonJS) exports.afterEach = afterEach; + +/** + * Defines a suite of specifications. + * + * Stores the description and all defined specs in the Jasmine environment as one suite of specs. Variables declared + * are accessible by calls to beforeEach, it, and afterEach. Describe blocks can be nested, allowing for specialization + * of setup in some tests. + * + * @example + * // TODO: a simple suite + * + * // TODO: a simple suite with a nested describe block + * + * @param {String} description A string, usually the class under test. + * @param {Function} specDefinitions function that defines several specs. + */ +var describe = function(description, specDefinitions) { + return jasmine.getEnv().describe(description, specDefinitions); +}; +if (isCommonJS) exports.describe = describe; + +/** + * Disables a suite of specifications. Used to disable some suites in a file, or files, temporarily during development. + * + * @param {String} description A string, usually the class under test. + * @param {Function} specDefinitions function that defines several specs. + */ +var xdescribe = function(description, specDefinitions) { + return jasmine.getEnv().xdescribe(description, specDefinitions); +}; +if (isCommonJS) exports.xdescribe = xdescribe; + + +// Provide the XMLHttpRequest class for IE 5.x-6.x: +jasmine.XmlHttpRequest = (typeof XMLHttpRequest == "undefined") ? function() { + function tryIt(f) { + try { + return f(); + } catch(e) { + } + return null; + } + + var xhr = tryIt(function() { + return new ActiveXObject("Msxml2.XMLHTTP.6.0"); + }) || + tryIt(function() { + return new ActiveXObject("Msxml2.XMLHTTP.3.0"); + }) || + tryIt(function() { + return new ActiveXObject("Msxml2.XMLHTTP"); + }) || + tryIt(function() { + return new ActiveXObject("Microsoft.XMLHTTP"); + }); + + if (!xhr) throw new Error("This browser does not support XMLHttpRequest."); + + return xhr; +} : XMLHttpRequest; +/** + * @namespace + */ +jasmine.util = {}; + +/** + * Declare that a child class inherit it's prototype from the parent class. + * + * @private + * @param {Function} childClass + * @param {Function} parentClass + */ +jasmine.util.inherit = function(childClass, parentClass) { + /** + * @private + */ + var subclass = function() { + }; + subclass.prototype = parentClass.prototype; + childClass.prototype = new subclass(); +}; + +jasmine.util.formatException = function(e) { + var lineNumber; + if (e.line) { + lineNumber = e.line; + } + else if (e.lineNumber) { + lineNumber = e.lineNumber; + } + + var file; + + if (e.sourceURL) { + file = e.sourceURL; + } + else if (e.fileName) { + file = e.fileName; + } + + var message = (e.name && e.message) ? (e.name + ': ' + e.message) : e.toString(); + + if (file && lineNumber) { + message += ' in ' + file + ' (line ' + lineNumber + ')'; + } + + return message; +}; + +jasmine.util.htmlEscape = function(str) { + if (!str) return str; + return str.replace(/&/g, '&') + .replace(//g, '>'); +}; + +jasmine.util.argsToArray = function(args) { + var arrayOfArgs = []; + for (var i = 0; i < args.length; i++) arrayOfArgs.push(args[i]); + return arrayOfArgs; +}; + +jasmine.util.extend = function(destination, source) { + for (var property in source) destination[property] = source[property]; + return destination; +}; + +/** + * Environment for Jasmine + * + * @constructor + */ +jasmine.Env = function() { + this.currentSpec = null; + this.currentSuite = null; + this.currentRunner_ = new jasmine.Runner(this); + + this.reporter = new jasmine.MultiReporter(); + + this.updateInterval = jasmine.DEFAULT_UPDATE_INTERVAL; + this.defaultTimeoutInterval = jasmine.DEFAULT_TIMEOUT_INTERVAL; + this.lastUpdate = 0; + this.specFilter = function() { + return true; + }; + + this.nextSpecId_ = 0; + this.nextSuiteId_ = 0; + this.equalityTesters_ = []; + + // wrap matchers + this.matchersClass = function() { + jasmine.Matchers.apply(this, arguments); + }; + jasmine.util.inherit(this.matchersClass, jasmine.Matchers); + + jasmine.Matchers.wrapInto_(jasmine.Matchers.prototype, this.matchersClass); +}; + + +jasmine.Env.prototype.setTimeout = jasmine.setTimeout; +jasmine.Env.prototype.clearTimeout = jasmine.clearTimeout; +jasmine.Env.prototype.setInterval = jasmine.setInterval; +jasmine.Env.prototype.clearInterval = jasmine.clearInterval; + +/** + * @returns an object containing jasmine version build info, if set. + */ +jasmine.Env.prototype.version = function () { + if (jasmine.version_) { + return jasmine.version_; + } else { + throw new Error('Version not set'); + } +}; + +/** + * @returns string containing jasmine version build info, if set. + */ +jasmine.Env.prototype.versionString = function() { + if (!jasmine.version_) { + return "version unknown"; + } + + var version = this.version(); + var versionString = version.major + "." + version.minor + "." + version.build; + if (version.release_candidate) { + versionString += ".rc" + version.release_candidate; + } + versionString += " revision " + version.revision; + return versionString; +}; + +/** + * @returns a sequential integer starting at 0 + */ +jasmine.Env.prototype.nextSpecId = function () { + return this.nextSpecId_++; +}; + +/** + * @returns a sequential integer starting at 0 + */ +jasmine.Env.prototype.nextSuiteId = function () { + return this.nextSuiteId_++; +}; + +/** + * Register a reporter to receive status updates from Jasmine. + * @param {jasmine.Reporter} reporter An object which will receive status updates. + */ +jasmine.Env.prototype.addReporter = function(reporter) { + this.reporter.addReporter(reporter); +}; + +jasmine.Env.prototype.execute = function() { + this.currentRunner_.execute(); +}; + +jasmine.Env.prototype.describe = function(description, specDefinitions) { + var suite = new jasmine.Suite(this, description, specDefinitions, this.currentSuite); + + var parentSuite = this.currentSuite; + if (parentSuite) { + parentSuite.add(suite); + } else { + this.currentRunner_.add(suite); + } + + this.currentSuite = suite; + + var declarationError = null; + try { + specDefinitions.call(suite); + } catch(e) { + declarationError = e; + } + + if (declarationError) { + this.it("encountered a declaration exception", function() { + throw declarationError; + }); + } + + this.currentSuite = parentSuite; + + return suite; +}; + +jasmine.Env.prototype.beforeEach = function(beforeEachFunction) { + if (this.currentSuite) { + this.currentSuite.beforeEach(beforeEachFunction); + } else { + this.currentRunner_.beforeEach(beforeEachFunction); + } +}; + +jasmine.Env.prototype.currentRunner = function () { + return this.currentRunner_; +}; + +jasmine.Env.prototype.afterEach = function(afterEachFunction) { + if (this.currentSuite) { + this.currentSuite.afterEach(afterEachFunction); + } else { + this.currentRunner_.afterEach(afterEachFunction); + } + +}; + +jasmine.Env.prototype.xdescribe = function(desc, specDefinitions) { + return { + execute: function() { + } + }; +}; + +jasmine.Env.prototype.it = function(description, func) { + var spec = new jasmine.Spec(this, this.currentSuite, description); + this.currentSuite.add(spec); + this.currentSpec = spec; + + if (func) { + spec.runs(func); + } + + return spec; +}; + +jasmine.Env.prototype.xit = function(desc, func) { + return { + id: this.nextSpecId(), + runs: function() { + } + }; +}; + +jasmine.Env.prototype.compareObjects_ = function(a, b, mismatchKeys, mismatchValues) { + if (a.__Jasmine_been_here_before__ === b && b.__Jasmine_been_here_before__ === a) { + return true; + } + + a.__Jasmine_been_here_before__ = b; + b.__Jasmine_been_here_before__ = a; + + var hasKey = function(obj, keyName) { + return obj !== null && obj[keyName] !== jasmine.undefined; + }; + + for (var property in b) { + if (!hasKey(a, property) && hasKey(b, property)) { + mismatchKeys.push("expected has key '" + property + "', but missing from actual."); + } + } + for (property in a) { + if (!hasKey(b, property) && hasKey(a, property)) { + mismatchKeys.push("expected missing key '" + property + "', but present in actual."); + } + } + for (property in b) { + if (property == '__Jasmine_been_here_before__') continue; + if (!this.equals_(a[property], b[property], mismatchKeys, mismatchValues)) { + mismatchValues.push("'" + property + "' was '" + (b[property] ? jasmine.util.htmlEscape(b[property].toString()) : b[property]) + "' in expected, but was '" + (a[property] ? jasmine.util.htmlEscape(a[property].toString()) : a[property]) + "' in actual."); + } + } + + if (jasmine.isArray_(a) && jasmine.isArray_(b) && a.length != b.length) { + mismatchValues.push("arrays were not the same length"); + } + + delete a.__Jasmine_been_here_before__; + delete b.__Jasmine_been_here_before__; + return (mismatchKeys.length === 0 && mismatchValues.length === 0); +}; + +jasmine.Env.prototype.equals_ = function(a, b, mismatchKeys, mismatchValues) { + mismatchKeys = mismatchKeys || []; + mismatchValues = mismatchValues || []; + + for (var i = 0; i < this.equalityTesters_.length; i++) { + var equalityTester = this.equalityTesters_[i]; + var result = equalityTester(a, b, this, mismatchKeys, mismatchValues); + if (result !== jasmine.undefined) return result; + } + + if (a === b) return true; + + if (a === jasmine.undefined || a === null || b === jasmine.undefined || b === null) { + return (a == jasmine.undefined && b == jasmine.undefined); + } + + if (jasmine.isDomNode(a) && jasmine.isDomNode(b)) { + return a === b; + } + + if (a instanceof Date && b instanceof Date) { + return a.getTime() == b.getTime(); + } + + if (a.jasmineMatches) { + return a.jasmineMatches(b); + } + + if (b.jasmineMatches) { + return b.jasmineMatches(a); + } + + if (a instanceof jasmine.Matchers.ObjectContaining) { + return a.matches(b); + } + + if (b instanceof jasmine.Matchers.ObjectContaining) { + return b.matches(a); + } + + if (jasmine.isString_(a) && jasmine.isString_(b)) { + return (a == b); + } + + if (jasmine.isNumber_(a) && jasmine.isNumber_(b)) { + return (a == b); + } + + if (typeof a === "object" && typeof b === "object") { + return this.compareObjects_(a, b, mismatchKeys, mismatchValues); + } + + //Straight check + return (a === b); +}; + +jasmine.Env.prototype.contains_ = function(haystack, needle) { + if (jasmine.isArray_(haystack)) { + for (var i = 0; i < haystack.length; i++) { + if (this.equals_(haystack[i], needle)) return true; + } + return false; + } + return haystack.indexOf(needle) >= 0; +}; + +jasmine.Env.prototype.addEqualityTester = function(equalityTester) { + this.equalityTesters_.push(equalityTester); +}; +/** No-op base class for Jasmine reporters. + * + * @constructor + */ +jasmine.Reporter = function() { +}; + +//noinspection JSUnusedLocalSymbols +jasmine.Reporter.prototype.reportRunnerStarting = function(runner) { +}; + +//noinspection JSUnusedLocalSymbols +jasmine.Reporter.prototype.reportRunnerResults = function(runner) { +}; + +//noinspection JSUnusedLocalSymbols +jasmine.Reporter.prototype.reportSuiteResults = function(suite) { +}; + +//noinspection JSUnusedLocalSymbols +jasmine.Reporter.prototype.reportSpecStarting = function(spec) { +}; + +//noinspection JSUnusedLocalSymbols +jasmine.Reporter.prototype.reportSpecResults = function(spec) { +}; + +//noinspection JSUnusedLocalSymbols +jasmine.Reporter.prototype.log = function(str) { +}; + +/** + * Blocks are functions with executable code that make up a spec. + * + * @constructor + * @param {jasmine.Env} env + * @param {Function} func + * @param {jasmine.Spec} spec + */ +jasmine.Block = function(env, func, spec) { + this.env = env; + this.func = func; + this.spec = spec; +}; + +jasmine.Block.prototype.execute = function(onComplete) { + try { + this.func.apply(this.spec); + } catch (e) { + this.spec.fail(e); + } + onComplete(); +}; +/** JavaScript API reporter. + * + * @constructor + */ +jasmine.JsApiReporter = function() { + this.started = false; + this.finished = false; + this.suites_ = []; + this.results_ = {}; +}; + +jasmine.JsApiReporter.prototype.reportRunnerStarting = function(runner) { + this.started = true; + var suites = runner.topLevelSuites(); + for (var i = 0; i < suites.length; i++) { + var suite = suites[i]; + this.suites_.push(this.summarize_(suite)); + } +}; + +jasmine.JsApiReporter.prototype.suites = function() { + return this.suites_; +}; + +jasmine.JsApiReporter.prototype.summarize_ = function(suiteOrSpec) { + var isSuite = suiteOrSpec instanceof jasmine.Suite; + var summary = { + id: suiteOrSpec.id, + name: suiteOrSpec.description, + type: isSuite ? 'suite' : 'spec', + children: [] + }; + + if (isSuite) { + var children = suiteOrSpec.children(); + for (var i = 0; i < children.length; i++) { + summary.children.push(this.summarize_(children[i])); + } + } + return summary; +}; + +jasmine.JsApiReporter.prototype.results = function() { + return this.results_; +}; + +jasmine.JsApiReporter.prototype.resultsForSpec = function(specId) { + return this.results_[specId]; +}; + +//noinspection JSUnusedLocalSymbols +jasmine.JsApiReporter.prototype.reportRunnerResults = function(runner) { + this.finished = true; +}; + +//noinspection JSUnusedLocalSymbols +jasmine.JsApiReporter.prototype.reportSuiteResults = function(suite) { +}; + +//noinspection JSUnusedLocalSymbols +jasmine.JsApiReporter.prototype.reportSpecResults = function(spec) { + this.results_[spec.id] = { + messages: spec.results().getItems(), + result: spec.results().failedCount > 0 ? "failed" : "passed" + }; +}; + +//noinspection JSUnusedLocalSymbols +jasmine.JsApiReporter.prototype.log = function(str) { +}; + +jasmine.JsApiReporter.prototype.resultsForSpecs = function(specIds){ + var results = {}; + for (var i = 0; i < specIds.length; i++) { + var specId = specIds[i]; + results[specId] = this.summarizeResult_(this.results_[specId]); + } + return results; +}; + +jasmine.JsApiReporter.prototype.summarizeResult_ = function(result){ + var summaryMessages = []; + var messagesLength = result.messages.length; + for (var messageIndex = 0; messageIndex < messagesLength; messageIndex++) { + var resultMessage = result.messages[messageIndex]; + summaryMessages.push({ + text: resultMessage.type == 'log' ? resultMessage.toString() : jasmine.undefined, + passed: resultMessage.passed ? resultMessage.passed() : true, + type: resultMessage.type, + message: resultMessage.message, + trace: { + stack: resultMessage.passed && !resultMessage.passed() ? resultMessage.trace.stack : jasmine.undefined + } + }); + } + + return { + result : result.result, + messages : summaryMessages + }; +}; + +/** + * @constructor + * @param {jasmine.Env} env + * @param actual + * @param {jasmine.Spec} spec + */ +jasmine.Matchers = function(env, actual, spec, opt_isNot) { + this.env = env; + this.actual = actual; + this.spec = spec; + this.isNot = opt_isNot || false; + this.reportWasCalled_ = false; +}; + +// todo: @deprecated as of Jasmine 0.11, remove soon [xw] +jasmine.Matchers.pp = function(str) { + throw new Error("jasmine.Matchers.pp() is no longer supported, please use jasmine.pp() instead!"); +}; + +// todo: @deprecated Deprecated as of Jasmine 0.10. Rewrite your custom matchers to return true or false. [xw] +jasmine.Matchers.prototype.report = function(result, failing_message, details) { + throw new Error("As of jasmine 0.11, custom matchers must be implemented differently -- please see jasmine docs"); +}; + +jasmine.Matchers.wrapInto_ = function(prototype, matchersClass) { + for (var methodName in prototype) { + if (methodName == 'report') continue; + var orig = prototype[methodName]; + matchersClass.prototype[methodName] = jasmine.Matchers.matcherFn_(methodName, orig); + } +}; + +jasmine.Matchers.matcherFn_ = function(matcherName, matcherFunction) { + return function() { + var matcherArgs = jasmine.util.argsToArray(arguments); + var result = matcherFunction.apply(this, arguments); + + if (this.isNot) { + result = !result; + } + + if (this.reportWasCalled_) return result; + + var message; + if (!result) { + if (this.message) { + message = this.message.apply(this, arguments); + if (jasmine.isArray_(message)) { + message = message[this.isNot ? 1 : 0]; + } + } else { + var englishyPredicate = matcherName.replace(/[A-Z]/g, function(s) { return ' ' + s.toLowerCase(); }); + message = "Expected " + jasmine.pp(this.actual) + (this.isNot ? " not " : " ") + englishyPredicate; + if (matcherArgs.length > 0) { + for (var i = 0; i < matcherArgs.length; i++) { + if (i > 0) message += ","; + message += " " + jasmine.pp(matcherArgs[i]); + } + } + message += "."; + } + } + var expectationResult = new jasmine.ExpectationResult({ + matcherName: matcherName, + passed: result, + expected: matcherArgs.length > 1 ? matcherArgs : matcherArgs[0], + actual: this.actual, + message: message + }); + this.spec.addMatcherResult(expectationResult); + return jasmine.undefined; + }; +}; + + + + +/** + * toBe: compares the actual to the expected using === + * @param expected + */ +jasmine.Matchers.prototype.toBe = function(expected) { + return this.actual === expected; +}; + +/** + * toNotBe: compares the actual to the expected using !== + * @param expected + * @deprecated as of 1.0. Use not.toBe() instead. + */ +jasmine.Matchers.prototype.toNotBe = function(expected) { + return this.actual !== expected; +}; + +/** + * toEqual: compares the actual to the expected using common sense equality. Handles Objects, Arrays, etc. + * + * @param expected + */ +jasmine.Matchers.prototype.toEqual = function(expected) { + return this.env.equals_(this.actual, expected); +}; + +/** + * toNotEqual: compares the actual to the expected using the ! of jasmine.Matchers.toEqual + * @param expected + * @deprecated as of 1.0. Use not.toEqual() instead. + */ +jasmine.Matchers.prototype.toNotEqual = function(expected) { + return !this.env.equals_(this.actual, expected); +}; + +/** + * Matcher that compares the actual to the expected using a regular expression. Constructs a RegExp, so takes + * a pattern or a String. + * + * @param expected + */ +jasmine.Matchers.prototype.toMatch = function(expected) { + return new RegExp(expected).test(this.actual); +}; + +/** + * Matcher that compares the actual to the expected using the boolean inverse of jasmine.Matchers.toMatch + * @param expected + * @deprecated as of 1.0. Use not.toMatch() instead. + */ +jasmine.Matchers.prototype.toNotMatch = function(expected) { + return !(new RegExp(expected).test(this.actual)); +}; + +/** + * Matcher that compares the actual to jasmine.undefined. + */ +jasmine.Matchers.prototype.toBeDefined = function() { + return (this.actual !== jasmine.undefined); +}; + +/** + * Matcher that compares the actual to jasmine.undefined. + */ +jasmine.Matchers.prototype.toBeUndefined = function() { + return (this.actual === jasmine.undefined); +}; + +/** + * Matcher that compares the actual to null. + */ +jasmine.Matchers.prototype.toBeNull = function() { + return (this.actual === null); +}; + +/** + * Matcher that boolean not-nots the actual. + */ +jasmine.Matchers.prototype.toBeTruthy = function() { + return !!this.actual; +}; + + +/** + * Matcher that boolean nots the actual. + */ +jasmine.Matchers.prototype.toBeFalsy = function() { + return !this.actual; +}; + + +/** + * Matcher that checks to see if the actual, a Jasmine spy, was called. + */ +jasmine.Matchers.prototype.toHaveBeenCalled = function() { + if (arguments.length > 0) { + throw new Error('toHaveBeenCalled does not take arguments, use toHaveBeenCalledWith'); + } + + if (!jasmine.isSpy(this.actual)) { + throw new Error('Expected a spy, but got ' + jasmine.pp(this.actual) + '.'); + } + + this.message = function() { + return [ + "Expected spy " + this.actual.identity + " to have been called.", + "Expected spy " + this.actual.identity + " not to have been called." + ]; + }; + + return this.actual.wasCalled; +}; + +/** @deprecated Use expect(xxx).toHaveBeenCalled() instead */ +jasmine.Matchers.prototype.wasCalled = jasmine.Matchers.prototype.toHaveBeenCalled; + +/** + * Matcher that checks to see if the actual, a Jasmine spy, was not called. + * + * @deprecated Use expect(xxx).not.toHaveBeenCalled() instead + */ +jasmine.Matchers.prototype.wasNotCalled = function() { + if (arguments.length > 0) { + throw new Error('wasNotCalled does not take arguments'); + } + + if (!jasmine.isSpy(this.actual)) { + throw new Error('Expected a spy, but got ' + jasmine.pp(this.actual) + '.'); + } + + this.message = function() { + return [ + "Expected spy " + this.actual.identity + " to not have been called.", + "Expected spy " + this.actual.identity + " to have been called." + ]; + }; + + return !this.actual.wasCalled; +}; + +/** + * Matcher that checks to see if the actual, a Jasmine spy, was called with a set of parameters. + * + * @example + * + */ +jasmine.Matchers.prototype.toHaveBeenCalledWith = function() { + var expectedArgs = jasmine.util.argsToArray(arguments); + if (!jasmine.isSpy(this.actual)) { + throw new Error('Expected a spy, but got ' + jasmine.pp(this.actual) + '.'); + } + this.message = function() { + if (this.actual.callCount === 0) { + // todo: what should the failure message for .not.toHaveBeenCalledWith() be? is this right? test better. [xw] + return [ + "Expected spy " + this.actual.identity + " to have been called with " + jasmine.pp(expectedArgs) + " but it was never called.", + "Expected spy " + this.actual.identity + " not to have been called with " + jasmine.pp(expectedArgs) + " but it was." + ]; + } else { + return [ + "Expected spy " + this.actual.identity + " to have been called with " + jasmine.pp(expectedArgs) + " but was called with " + jasmine.pp(this.actual.argsForCall), + "Expected spy " + this.actual.identity + " not to have been called with " + jasmine.pp(expectedArgs) + " but was called with " + jasmine.pp(this.actual.argsForCall) + ]; + } + }; + + return this.env.contains_(this.actual.argsForCall, expectedArgs); +}; + +/** @deprecated Use expect(xxx).toHaveBeenCalledWith() instead */ +jasmine.Matchers.prototype.wasCalledWith = jasmine.Matchers.prototype.toHaveBeenCalledWith; + +/** @deprecated Use expect(xxx).not.toHaveBeenCalledWith() instead */ +jasmine.Matchers.prototype.wasNotCalledWith = function() { + var expectedArgs = jasmine.util.argsToArray(arguments); + if (!jasmine.isSpy(this.actual)) { + throw new Error('Expected a spy, but got ' + jasmine.pp(this.actual) + '.'); + } + + this.message = function() { + return [ + "Expected spy not to have been called with " + jasmine.pp(expectedArgs) + " but it was", + "Expected spy to have been called with " + jasmine.pp(expectedArgs) + " but it was" + ]; + }; + + return !this.env.contains_(this.actual.argsForCall, expectedArgs); +}; + +/** + * Matcher that checks that the expected item is an element in the actual Array. + * + * @param {Object} expected + */ +jasmine.Matchers.prototype.toContain = function(expected) { + return this.env.contains_(this.actual, expected); +}; + +/** + * Matcher that checks that the expected item is NOT an element in the actual Array. + * + * @param {Object} expected + * @deprecated as of 1.0. Use not.toContain() instead. + */ +jasmine.Matchers.prototype.toNotContain = function(expected) { + return !this.env.contains_(this.actual, expected); +}; + +jasmine.Matchers.prototype.toBeLessThan = function(expected) { + return this.actual < expected; +}; + +jasmine.Matchers.prototype.toBeGreaterThan = function(expected) { + return this.actual > expected; +}; + +/** + * Matcher that checks that the expected item is equal to the actual item + * up to a given level of decimal precision (default 2). + * + * @param {Number} expected + * @param {Number} precision + */ +jasmine.Matchers.prototype.toBeCloseTo = function(expected, precision) { + if (!(precision === 0)) { + precision = precision || 2; + } + var multiplier = Math.pow(10, precision); + var actual = Math.round(this.actual * multiplier); + expected = Math.round(expected * multiplier); + return expected == actual; +}; + +/** + * Matcher that checks that the expected exception was thrown by the actual. + * + * @param {String} expected + */ +jasmine.Matchers.prototype.toThrow = function(expected) { + var result = false; + var exception; + if (typeof this.actual != 'function') { + throw new Error('Actual is not a function'); + } + try { + this.actual(); + } catch (e) { + exception = e; + } + if (exception) { + result = (expected === jasmine.undefined || this.env.equals_(exception.message || exception, expected.message || expected)); + } + + var not = this.isNot ? "not " : ""; + + this.message = function() { + if (exception && (expected === jasmine.undefined || !this.env.equals_(exception.message || exception, expected.message || expected))) { + return ["Expected function " + not + "to throw", expected ? expected.message || expected : "an exception", ", but it threw", exception.message || exception].join(' '); + } else { + return "Expected function to throw an exception."; + } + }; + + return result; +}; + +jasmine.Matchers.Any = function(expectedClass) { + this.expectedClass = expectedClass; +}; + +jasmine.Matchers.Any.prototype.jasmineMatches = function(other) { + if (this.expectedClass == String) { + return typeof other == 'string' || other instanceof String; + } + + if (this.expectedClass == Number) { + return typeof other == 'number' || other instanceof Number; + } + + if (this.expectedClass == Function) { + return typeof other == 'function' || other instanceof Function; + } + + if (this.expectedClass == Object) { + return typeof other == 'object'; + } + + return other instanceof this.expectedClass; +}; + +jasmine.Matchers.Any.prototype.jasmineToString = function() { + return ''; +}; + +jasmine.Matchers.ObjectContaining = function (sample) { + this.sample = sample; +}; + +jasmine.Matchers.ObjectContaining.prototype.jasmineMatches = function(other, mismatchKeys, mismatchValues) { + mismatchKeys = mismatchKeys || []; + mismatchValues = mismatchValues || []; + + var env = jasmine.getEnv(); + + var hasKey = function(obj, keyName) { + return obj != null && obj[keyName] !== jasmine.undefined; + }; + + for (var property in this.sample) { + if (!hasKey(other, property) && hasKey(this.sample, property)) { + mismatchKeys.push("expected has key '" + property + "', but missing from actual."); + } + else if (!env.equals_(this.sample[property], other[property], mismatchKeys, mismatchValues)) { + mismatchValues.push("'" + property + "' was '" + (other[property] ? jasmine.util.htmlEscape(other[property].toString()) : other[property]) + "' in expected, but was '" + (this.sample[property] ? jasmine.util.htmlEscape(this.sample[property].toString()) : this.sample[property]) + "' in actual."); + } + } + + return (mismatchKeys.length === 0 && mismatchValues.length === 0); +}; + +jasmine.Matchers.ObjectContaining.prototype.jasmineToString = function () { + return ""; +}; +// Mock setTimeout, clearTimeout +// Contributed by Pivotal Computer Systems, www.pivotalsf.com + +jasmine.FakeTimer = function() { + this.reset(); + + var self = this; + self.setTimeout = function(funcToCall, millis) { + self.timeoutsMade++; + self.scheduleFunction(self.timeoutsMade, funcToCall, millis, false); + return self.timeoutsMade; + }; + + self.setInterval = function(funcToCall, millis) { + self.timeoutsMade++; + self.scheduleFunction(self.timeoutsMade, funcToCall, millis, true); + return self.timeoutsMade; + }; + + self.clearTimeout = function(timeoutKey) { + self.scheduledFunctions[timeoutKey] = jasmine.undefined; + }; + + self.clearInterval = function(timeoutKey) { + self.scheduledFunctions[timeoutKey] = jasmine.undefined; + }; + +}; + +jasmine.FakeTimer.prototype.reset = function() { + this.timeoutsMade = 0; + this.scheduledFunctions = {}; + this.nowMillis = 0; +}; + +jasmine.FakeTimer.prototype.tick = function(millis) { + var oldMillis = this.nowMillis; + var newMillis = oldMillis + millis; + this.runFunctionsWithinRange(oldMillis, newMillis); + this.nowMillis = newMillis; +}; + +jasmine.FakeTimer.prototype.runFunctionsWithinRange = function(oldMillis, nowMillis) { + var scheduledFunc; + var funcsToRun = []; + for (var timeoutKey in this.scheduledFunctions) { + scheduledFunc = this.scheduledFunctions[timeoutKey]; + if (scheduledFunc != jasmine.undefined && + scheduledFunc.runAtMillis >= oldMillis && + scheduledFunc.runAtMillis <= nowMillis) { + funcsToRun.push(scheduledFunc); + this.scheduledFunctions[timeoutKey] = jasmine.undefined; + } + } + + if (funcsToRun.length > 0) { + funcsToRun.sort(function(a, b) { + return a.runAtMillis - b.runAtMillis; + }); + for (var i = 0; i < funcsToRun.length; ++i) { + try { + var funcToRun = funcsToRun[i]; + this.nowMillis = funcToRun.runAtMillis; + funcToRun.funcToCall(); + if (funcToRun.recurring) { + this.scheduleFunction(funcToRun.timeoutKey, + funcToRun.funcToCall, + funcToRun.millis, + true); + } + } catch(e) { + } + } + this.runFunctionsWithinRange(oldMillis, nowMillis); + } +}; + +jasmine.FakeTimer.prototype.scheduleFunction = function(timeoutKey, funcToCall, millis, recurring) { + this.scheduledFunctions[timeoutKey] = { + runAtMillis: this.nowMillis + millis, + funcToCall: funcToCall, + recurring: recurring, + timeoutKey: timeoutKey, + millis: millis + }; +}; + +/** + * @namespace + */ +jasmine.Clock = { + defaultFakeTimer: new jasmine.FakeTimer(), + + reset: function() { + jasmine.Clock.assertInstalled(); + jasmine.Clock.defaultFakeTimer.reset(); + }, + + tick: function(millis) { + jasmine.Clock.assertInstalled(); + jasmine.Clock.defaultFakeTimer.tick(millis); + }, + + runFunctionsWithinRange: function(oldMillis, nowMillis) { + jasmine.Clock.defaultFakeTimer.runFunctionsWithinRange(oldMillis, nowMillis); + }, + + scheduleFunction: function(timeoutKey, funcToCall, millis, recurring) { + jasmine.Clock.defaultFakeTimer.scheduleFunction(timeoutKey, funcToCall, millis, recurring); + }, + + useMock: function() { + if (!jasmine.Clock.isInstalled()) { + var spec = jasmine.getEnv().currentSpec; + spec.after(jasmine.Clock.uninstallMock); + + jasmine.Clock.installMock(); + } + }, + + installMock: function() { + jasmine.Clock.installed = jasmine.Clock.defaultFakeTimer; + }, + + uninstallMock: function() { + jasmine.Clock.assertInstalled(); + jasmine.Clock.installed = jasmine.Clock.real; + }, + + real: { + setTimeout: jasmine.getGlobal().setTimeout, + clearTimeout: jasmine.getGlobal().clearTimeout, + setInterval: jasmine.getGlobal().setInterval, + clearInterval: jasmine.getGlobal().clearInterval + }, + + assertInstalled: function() { + if (!jasmine.Clock.isInstalled()) { + throw new Error("Mock clock is not installed, use jasmine.Clock.useMock()"); + } + }, + + isInstalled: function() { + return jasmine.Clock.installed == jasmine.Clock.defaultFakeTimer; + }, + + installed: null +}; +jasmine.Clock.installed = jasmine.Clock.real; + +//else for IE support +jasmine.getGlobal().setTimeout = function(funcToCall, millis) { + if (jasmine.Clock.installed.setTimeout.apply) { + return jasmine.Clock.installed.setTimeout.apply(this, arguments); + } else { + return jasmine.Clock.installed.setTimeout(funcToCall, millis); + } +}; + +jasmine.getGlobal().setInterval = function(funcToCall, millis) { + if (jasmine.Clock.installed.setInterval.apply) { + return jasmine.Clock.installed.setInterval.apply(this, arguments); + } else { + return jasmine.Clock.installed.setInterval(funcToCall, millis); + } +}; + +jasmine.getGlobal().clearTimeout = function(timeoutKey) { + if (jasmine.Clock.installed.clearTimeout.apply) { + return jasmine.Clock.installed.clearTimeout.apply(this, arguments); + } else { + return jasmine.Clock.installed.clearTimeout(timeoutKey); + } +}; + +jasmine.getGlobal().clearInterval = function(timeoutKey) { + if (jasmine.Clock.installed.clearTimeout.apply) { + return jasmine.Clock.installed.clearInterval.apply(this, arguments); + } else { + return jasmine.Clock.installed.clearInterval(timeoutKey); + } +}; + +/** + * @constructor + */ +jasmine.MultiReporter = function() { + this.subReporters_ = []; +}; +jasmine.util.inherit(jasmine.MultiReporter, jasmine.Reporter); + +jasmine.MultiReporter.prototype.addReporter = function(reporter) { + this.subReporters_.push(reporter); +}; + +(function() { + var functionNames = [ + "reportRunnerStarting", + "reportRunnerResults", + "reportSuiteResults", + "reportSpecStarting", + "reportSpecResults", + "log" + ]; + for (var i = 0; i < functionNames.length; i++) { + var functionName = functionNames[i]; + jasmine.MultiReporter.prototype[functionName] = (function(functionName) { + return function() { + for (var j = 0; j < this.subReporters_.length; j++) { + var subReporter = this.subReporters_[j]; + if (subReporter[functionName]) { + subReporter[functionName].apply(subReporter, arguments); + } + } + }; + })(functionName); + } +})(); +/** + * Holds results for a set of Jasmine spec. Allows for the results array to hold another jasmine.NestedResults + * + * @constructor + */ +jasmine.NestedResults = function() { + /** + * The total count of results + */ + this.totalCount = 0; + /** + * Number of passed results + */ + this.passedCount = 0; + /** + * Number of failed results + */ + this.failedCount = 0; + /** + * Was this suite/spec skipped? + */ + this.skipped = false; + /** + * @ignore + */ + this.items_ = []; +}; + +/** + * Roll up the result counts. + * + * @param result + */ +jasmine.NestedResults.prototype.rollupCounts = function(result) { + this.totalCount += result.totalCount; + this.passedCount += result.passedCount; + this.failedCount += result.failedCount; +}; + +/** + * Adds a log message. + * @param values Array of message parts which will be concatenated later. + */ +jasmine.NestedResults.prototype.log = function(values) { + this.items_.push(new jasmine.MessageResult(values)); +}; + +/** + * Getter for the results: message & results. + */ +jasmine.NestedResults.prototype.getItems = function() { + return this.items_; +}; + +/** + * Adds a result, tracking counts (total, passed, & failed) + * @param {jasmine.ExpectationResult|jasmine.NestedResults} result + */ +jasmine.NestedResults.prototype.addResult = function(result) { + if (result.type != 'log') { + if (result.items_) { + this.rollupCounts(result); + } else { + this.totalCount++; + if (result.passed()) { + this.passedCount++; + } else { + this.failedCount++; + } + } + } + this.items_.push(result); +}; + +/** + * @returns {Boolean} True if everything below passed + */ +jasmine.NestedResults.prototype.passed = function() { + return this.passedCount === this.totalCount; +}; +/** + * Base class for pretty printing for expectation results. + */ +jasmine.PrettyPrinter = function() { + this.ppNestLevel_ = 0; +}; + +/** + * Formats a value in a nice, human-readable string. + * + * @param value + */ +jasmine.PrettyPrinter.prototype.format = function(value) { + if (this.ppNestLevel_ > 40) { + throw new Error('jasmine.PrettyPrinter: format() nested too deeply!'); + } + + this.ppNestLevel_++; + try { + if (value === jasmine.undefined) { + this.emitScalar('undefined'); + } else if (value === null) { + this.emitScalar('null'); + } else if (value === jasmine.getGlobal()) { + this.emitScalar(''); + } else if (value.jasmineToString) { + this.emitScalar(value.jasmineToString()); + } else if (typeof value === 'string') { + this.emitString(value); + } else if (jasmine.isSpy(value)) { + this.emitScalar("spy on " + value.identity); + } else if (value instanceof RegExp) { + this.emitScalar(value.toString()); + } else if (typeof value === 'function') { + this.emitScalar('Function'); + } else if (typeof value.nodeType === 'number') { + this.emitScalar('HTMLNode'); + } else if (value instanceof Date) { + this.emitScalar('Date(' + value + ')'); + } else if (value.__Jasmine_been_here_before__) { + this.emitScalar(''); + } else if (jasmine.isArray_(value) || typeof value == 'object') { + value.__Jasmine_been_here_before__ = true; + if (jasmine.isArray_(value)) { + this.emitArray(value); + } else { + this.emitObject(value); + } + delete value.__Jasmine_been_here_before__; + } else { + this.emitScalar(value.toString()); + } + } finally { + this.ppNestLevel_--; + } +}; + +jasmine.PrettyPrinter.prototype.iterateObject = function(obj, fn) { + for (var property in obj) { + if (property == '__Jasmine_been_here_before__') continue; + fn(property, obj.__lookupGetter__ ? (obj.__lookupGetter__(property) !== jasmine.undefined && + obj.__lookupGetter__(property) !== null) : false); + } +}; + +jasmine.PrettyPrinter.prototype.emitArray = jasmine.unimplementedMethod_; +jasmine.PrettyPrinter.prototype.emitObject = jasmine.unimplementedMethod_; +jasmine.PrettyPrinter.prototype.emitScalar = jasmine.unimplementedMethod_; +jasmine.PrettyPrinter.prototype.emitString = jasmine.unimplementedMethod_; + +jasmine.StringPrettyPrinter = function() { + jasmine.PrettyPrinter.call(this); + + this.string = ''; +}; +jasmine.util.inherit(jasmine.StringPrettyPrinter, jasmine.PrettyPrinter); + +jasmine.StringPrettyPrinter.prototype.emitScalar = function(value) { + this.append(value); +}; + +jasmine.StringPrettyPrinter.prototype.emitString = function(value) { + this.append("'" + value + "'"); +}; + +jasmine.StringPrettyPrinter.prototype.emitArray = function(array) { + this.append('[ '); + for (var i = 0; i < array.length; i++) { + if (i > 0) { + this.append(', '); + } + this.format(array[i]); + } + this.append(' ]'); +}; + +jasmine.StringPrettyPrinter.prototype.emitObject = function(obj) { + var self = this; + this.append('{ '); + var first = true; + + this.iterateObject(obj, function(property, isGetter) { + if (first) { + first = false; + } else { + self.append(', '); + } + + self.append(property); + self.append(' : '); + if (isGetter) { + self.append(''); + } else { + self.format(obj[property]); + } + }); + + this.append(' }'); +}; + +jasmine.StringPrettyPrinter.prototype.append = function(value) { + this.string += value; +}; +jasmine.Queue = function(env) { + this.env = env; + this.blocks = []; + this.running = false; + this.index = 0; + this.offset = 0; + this.abort = false; +}; + +jasmine.Queue.prototype.addBefore = function(block) { + this.blocks.unshift(block); +}; + +jasmine.Queue.prototype.add = function(block) { + this.blocks.push(block); +}; + +jasmine.Queue.prototype.insertNext = function(block) { + this.blocks.splice((this.index + this.offset + 1), 0, block); + this.offset++; +}; + +jasmine.Queue.prototype.start = function(onComplete) { + this.running = true; + this.onComplete = onComplete; + this.next_(); +}; + +jasmine.Queue.prototype.isRunning = function() { + return this.running; +}; + +jasmine.Queue.LOOP_DONT_RECURSE = true; + +jasmine.Queue.prototype.next_ = function() { + var self = this; + var goAgain = true; + + while (goAgain) { + goAgain = false; + + if (self.index < self.blocks.length && !this.abort) { + var calledSynchronously = true; + var completedSynchronously = false; + + var onComplete = function () { + if (jasmine.Queue.LOOP_DONT_RECURSE && calledSynchronously) { + completedSynchronously = true; + return; + } + + if (self.blocks[self.index].abort) { + self.abort = true; + } + + self.offset = 0; + self.index++; + + var now = new Date().getTime(); + if (self.env.updateInterval && now - self.env.lastUpdate > self.env.updateInterval) { + self.env.lastUpdate = now; + self.env.setTimeout(function() { + self.next_(); + }, 0); + } else { + if (jasmine.Queue.LOOP_DONT_RECURSE && completedSynchronously) { + goAgain = true; + } else { + self.next_(); + } + } + }; + self.blocks[self.index].execute(onComplete); + + calledSynchronously = false; + if (completedSynchronously) { + onComplete(); + } + + } else { + self.running = false; + if (self.onComplete) { + self.onComplete(); + } + } + } +}; + +jasmine.Queue.prototype.results = function() { + var results = new jasmine.NestedResults(); + for (var i = 0; i < this.blocks.length; i++) { + if (this.blocks[i].results) { + results.addResult(this.blocks[i].results()); + } + } + return results; +}; + + +/** + * Runner + * + * @constructor + * @param {jasmine.Env} env + */ +jasmine.Runner = function(env) { + var self = this; + self.env = env; + self.queue = new jasmine.Queue(env); + self.before_ = []; + self.after_ = []; + self.suites_ = []; +}; + +jasmine.Runner.prototype.execute = function() { + var self = this; + if (self.env.reporter.reportRunnerStarting) { + self.env.reporter.reportRunnerStarting(this); + } + self.queue.start(function () { + self.finishCallback(); + }); +}; + +jasmine.Runner.prototype.beforeEach = function(beforeEachFunction) { + beforeEachFunction.typeName = 'beforeEach'; + this.before_.splice(0,0,beforeEachFunction); +}; + +jasmine.Runner.prototype.afterEach = function(afterEachFunction) { + afterEachFunction.typeName = 'afterEach'; + this.after_.splice(0,0,afterEachFunction); +}; + + +jasmine.Runner.prototype.finishCallback = function() { + this.env.reporter.reportRunnerResults(this); +}; + +jasmine.Runner.prototype.addSuite = function(suite) { + this.suites_.push(suite); +}; + +jasmine.Runner.prototype.add = function(block) { + if (block instanceof jasmine.Suite) { + this.addSuite(block); + } + this.queue.add(block); +}; + +jasmine.Runner.prototype.specs = function () { + var suites = this.suites(); + var specs = []; + for (var i = 0; i < suites.length; i++) { + specs = specs.concat(suites[i].specs()); + } + return specs; +}; + +jasmine.Runner.prototype.suites = function() { + return this.suites_; +}; + +jasmine.Runner.prototype.topLevelSuites = function() { + var topLevelSuites = []; + for (var i = 0; i < this.suites_.length; i++) { + if (!this.suites_[i].parentSuite) { + topLevelSuites.push(this.suites_[i]); + } + } + return topLevelSuites; +}; + +jasmine.Runner.prototype.results = function() { + return this.queue.results(); +}; +/** + * Internal representation of a Jasmine specification, or test. + * + * @constructor + * @param {jasmine.Env} env + * @param {jasmine.Suite} suite + * @param {String} description + */ +jasmine.Spec = function(env, suite, description) { + if (!env) { + throw new Error('jasmine.Env() required'); + } + if (!suite) { + throw new Error('jasmine.Suite() required'); + } + var spec = this; + spec.id = env.nextSpecId ? env.nextSpecId() : null; + spec.env = env; + spec.suite = suite; + spec.description = description; + spec.queue = new jasmine.Queue(env); + + spec.afterCallbacks = []; + spec.spies_ = []; + + spec.results_ = new jasmine.NestedResults(); + spec.results_.description = description; + spec.matchersClass = null; +}; + +jasmine.Spec.prototype.getFullName = function() { + return this.suite.getFullName() + ' ' + this.description + '.'; +}; + + +jasmine.Spec.prototype.results = function() { + return this.results_; +}; + +/** + * All parameters are pretty-printed and concatenated together, then written to the spec's output. + * + * Be careful not to leave calls to jasmine.log in production code. + */ +jasmine.Spec.prototype.log = function() { + return this.results_.log(arguments); +}; + +jasmine.Spec.prototype.runs = function (func) { + var block = new jasmine.Block(this.env, func, this); + this.addToQueue(block); + return this; +}; + +jasmine.Spec.prototype.addToQueue = function (block) { + if (this.queue.isRunning()) { + this.queue.insertNext(block); + } else { + this.queue.add(block); + } +}; + +/** + * @param {jasmine.ExpectationResult} result + */ +jasmine.Spec.prototype.addMatcherResult = function(result) { + this.results_.addResult(result); +}; + +jasmine.Spec.prototype.expect = function(actual) { + var positive = new (this.getMatchersClass_())(this.env, actual, this); + positive.not = new (this.getMatchersClass_())(this.env, actual, this, true); + return positive; +}; + +/** + * Waits a fixed time period before moving to the next block. + * + * @deprecated Use waitsFor() instead + * @param {Number} timeout milliseconds to wait + */ +jasmine.Spec.prototype.waits = function(timeout) { + var waitsFunc = new jasmine.WaitsBlock(this.env, timeout, this); + this.addToQueue(waitsFunc); + return this; +}; + +/** + * Waits for the latchFunction to return true before proceeding to the next block. + * + * @param {Function} latchFunction + * @param {String} optional_timeoutMessage + * @param {Number} optional_timeout + */ +jasmine.Spec.prototype.waitsFor = function(latchFunction, optional_timeoutMessage, optional_timeout) { + var latchFunction_ = null; + var optional_timeoutMessage_ = null; + var optional_timeout_ = null; + + for (var i = 0; i < arguments.length; i++) { + var arg = arguments[i]; + switch (typeof arg) { + case 'function': + latchFunction_ = arg; + break; + case 'string': + optional_timeoutMessage_ = arg; + break; + case 'number': + optional_timeout_ = arg; + break; + } + } + + var waitsForFunc = new jasmine.WaitsForBlock(this.env, optional_timeout_, latchFunction_, optional_timeoutMessage_, this); + this.addToQueue(waitsForFunc); + return this; +}; + +jasmine.Spec.prototype.fail = function (e) { + var expectationResult = new jasmine.ExpectationResult({ + passed: false, + message: e ? jasmine.util.formatException(e) : 'Exception', + trace: { stack: e.stack } + }); + this.results_.addResult(expectationResult); +}; + +jasmine.Spec.prototype.getMatchersClass_ = function() { + return this.matchersClass || this.env.matchersClass; +}; + +jasmine.Spec.prototype.addMatchers = function(matchersPrototype) { + var parent = this.getMatchersClass_(); + var newMatchersClass = function() { + parent.apply(this, arguments); + }; + jasmine.util.inherit(newMatchersClass, parent); + jasmine.Matchers.wrapInto_(matchersPrototype, newMatchersClass); + this.matchersClass = newMatchersClass; +}; + +jasmine.Spec.prototype.finishCallback = function() { + this.env.reporter.reportSpecResults(this); +}; + +jasmine.Spec.prototype.finish = function(onComplete) { + this.removeAllSpies(); + this.finishCallback(); + if (onComplete) { + onComplete(); + } +}; + +jasmine.Spec.prototype.after = function(doAfter) { + if (this.queue.isRunning()) { + this.queue.add(new jasmine.Block(this.env, doAfter, this)); + } else { + this.afterCallbacks.unshift(doAfter); + } +}; + +jasmine.Spec.prototype.execute = function(onComplete) { + var spec = this; + if (!spec.env.specFilter(spec)) { + spec.results_.skipped = true; + spec.finish(onComplete); + return; + } + + this.env.reporter.reportSpecStarting(this); + + spec.env.currentSpec = spec; + + spec.addBeforesAndAftersToQueue(); + + spec.queue.start(function () { + spec.finish(onComplete); + }); +}; + +jasmine.Spec.prototype.addBeforesAndAftersToQueue = function() { + var runner = this.env.currentRunner(); + var i; + + for (var suite = this.suite; suite; suite = suite.parentSuite) { + for (i = 0; i < suite.before_.length; i++) { + this.queue.addBefore(new jasmine.Block(this.env, suite.before_[i], this)); + } + } + for (i = 0; i < runner.before_.length; i++) { + this.queue.addBefore(new jasmine.Block(this.env, runner.before_[i], this)); + } + for (i = 0; i < this.afterCallbacks.length; i++) { + this.queue.add(new jasmine.Block(this.env, this.afterCallbacks[i], this)); + } + for (suite = this.suite; suite; suite = suite.parentSuite) { + for (i = 0; i < suite.after_.length; i++) { + this.queue.add(new jasmine.Block(this.env, suite.after_[i], this)); + } + } + for (i = 0; i < runner.after_.length; i++) { + this.queue.add(new jasmine.Block(this.env, runner.after_[i], this)); + } +}; + +jasmine.Spec.prototype.explodes = function() { + throw 'explodes function should not have been called'; +}; + +jasmine.Spec.prototype.spyOn = function(obj, methodName, ignoreMethodDoesntExist) { + if (obj == jasmine.undefined) { + throw "spyOn could not find an object to spy upon for " + methodName + "()"; + } + + if (!ignoreMethodDoesntExist && obj[methodName] === jasmine.undefined) { + throw methodName + '() method does not exist'; + } + + if (!ignoreMethodDoesntExist && obj[methodName] && obj[methodName].isSpy) { + throw new Error(methodName + ' has already been spied upon'); + } + + var spyObj = jasmine.createSpy(methodName); + + this.spies_.push(spyObj); + spyObj.baseObj = obj; + spyObj.methodName = methodName; + spyObj.originalValue = obj[methodName]; + + obj[methodName] = spyObj; + + return spyObj; +}; + +jasmine.Spec.prototype.removeAllSpies = function() { + for (var i = 0; i < this.spies_.length; i++) { + var spy = this.spies_[i]; + spy.baseObj[spy.methodName] = spy.originalValue; + } + this.spies_ = []; +}; + +/** + * Internal representation of a Jasmine suite. + * + * @constructor + * @param {jasmine.Env} env + * @param {String} description + * @param {Function} specDefinitions + * @param {jasmine.Suite} parentSuite + */ +jasmine.Suite = function(env, description, specDefinitions, parentSuite) { + var self = this; + self.id = env.nextSuiteId ? env.nextSuiteId() : null; + self.description = description; + self.queue = new jasmine.Queue(env); + self.parentSuite = parentSuite; + self.env = env; + self.before_ = []; + self.after_ = []; + self.children_ = []; + self.suites_ = []; + self.specs_ = []; +}; + +jasmine.Suite.prototype.getFullName = function() { + var fullName = this.description; + for (var parentSuite = this.parentSuite; parentSuite; parentSuite = parentSuite.parentSuite) { + fullName = parentSuite.description + ' ' + fullName; + } + return fullName; +}; + +jasmine.Suite.prototype.finish = function(onComplete) { + this.env.reporter.reportSuiteResults(this); + this.finished = true; + if (typeof(onComplete) == 'function') { + onComplete(); + } +}; + +jasmine.Suite.prototype.beforeEach = function(beforeEachFunction) { + beforeEachFunction.typeName = 'beforeEach'; + this.before_.unshift(beforeEachFunction); +}; + +jasmine.Suite.prototype.afterEach = function(afterEachFunction) { + afterEachFunction.typeName = 'afterEach'; + this.after_.unshift(afterEachFunction); +}; + +jasmine.Suite.prototype.results = function() { + return this.queue.results(); +}; + +jasmine.Suite.prototype.add = function(suiteOrSpec) { + this.children_.push(suiteOrSpec); + if (suiteOrSpec instanceof jasmine.Suite) { + this.suites_.push(suiteOrSpec); + this.env.currentRunner().addSuite(suiteOrSpec); + } else { + this.specs_.push(suiteOrSpec); + } + this.queue.add(suiteOrSpec); +}; + +jasmine.Suite.prototype.specs = function() { + return this.specs_; +}; + +jasmine.Suite.prototype.suites = function() { + return this.suites_; +}; + +jasmine.Suite.prototype.children = function() { + return this.children_; +}; + +jasmine.Suite.prototype.execute = function(onComplete) { + var self = this; + this.queue.start(function () { + self.finish(onComplete); + }); +}; +jasmine.WaitsBlock = function(env, timeout, spec) { + this.timeout = timeout; + jasmine.Block.call(this, env, null, spec); +}; + +jasmine.util.inherit(jasmine.WaitsBlock, jasmine.Block); + +jasmine.WaitsBlock.prototype.execute = function (onComplete) { + if (jasmine.VERBOSE) { + this.env.reporter.log('>> Jasmine waiting for ' + this.timeout + ' ms...'); + } + this.env.setTimeout(function () { + onComplete(); + }, this.timeout); +}; +/** + * A block which waits for some condition to become true, with timeout. + * + * @constructor + * @extends jasmine.Block + * @param {jasmine.Env} env The Jasmine environment. + * @param {Number} timeout The maximum time in milliseconds to wait for the condition to become true. + * @param {Function} latchFunction A function which returns true when the desired condition has been met. + * @param {String} message The message to display if the desired condition hasn't been met within the given time period. + * @param {jasmine.Spec} spec The Jasmine spec. + */ +jasmine.WaitsForBlock = function(env, timeout, latchFunction, message, spec) { + this.timeout = timeout || env.defaultTimeoutInterval; + this.latchFunction = latchFunction; + this.message = message; + this.totalTimeSpentWaitingForLatch = 0; + jasmine.Block.call(this, env, null, spec); +}; +jasmine.util.inherit(jasmine.WaitsForBlock, jasmine.Block); + +jasmine.WaitsForBlock.TIMEOUT_INCREMENT = 10; + +jasmine.WaitsForBlock.prototype.execute = function(onComplete) { + if (jasmine.VERBOSE) { + this.env.reporter.log('>> Jasmine waiting for ' + (this.message || 'something to happen')); + } + var latchFunctionResult; + try { + latchFunctionResult = this.latchFunction.apply(this.spec); + } catch (e) { + this.spec.fail(e); + onComplete(); + return; + } + + if (latchFunctionResult) { + onComplete(); + } else if (this.totalTimeSpentWaitingForLatch >= this.timeout) { + var message = 'timed out after ' + this.timeout + ' msec waiting for ' + (this.message || 'something to happen'); + this.spec.fail({ + name: 'timeout', + message: message + }); + + this.abort = true; + onComplete(); + } else { + this.totalTimeSpentWaitingForLatch += jasmine.WaitsForBlock.TIMEOUT_INCREMENT; + var self = this; + this.env.setTimeout(function() { + self.execute(onComplete); + }, jasmine.WaitsForBlock.TIMEOUT_INCREMENT); + } +}; + +jasmine.version_= { + "major": 1, + "minor": 2, + "build": 0, + "revision": 1333310630, + "release_candidate": 1 +}; diff --git a/spec/test-runner.js b/spec/test-runner.js new file mode 100644 index 00000000..f72b3cc5 --- /dev/null +++ b/spec/test-runner.js @@ -0,0 +1,62 @@ +/* + * + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, + * software distributed under the License is distributed on an + * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + * KIND, either express or implied. See the License for the + * specific language governing permissions and limitations + * under the License. + * +*/ + +if (window.sessionStorage != null) { + window.sessionStorage.clear(); +} + +// Timeout is 2 seconds to allow physical devices enough +// time to query the response. This is important for some +// Android devices. +var Tests = function() {}; +Tests.TEST_TIMEOUT = 7500; + +// Creates a spy that will fail if called. +function createDoNotCallSpy(name, opt_extraMessage) { + return jasmine.createSpy().andCallFake(function() { + var errorMessage = name + ' should not have been called.'; + if (arguments.length) { + errorMessage += ' Got args: ' + JSON.stringify(arguments); + } + if (opt_extraMessage) { + errorMessage += '\n' + opt_extraMessage; + } + expect(false).toBe(true, errorMessage); + }); +} + +// Waits for any of the given spys to be called. +// Last param may be a custom timeout duration. +function waitsForAny() { + var spys = [].slice.call(arguments); + var timeout = Tests.TEST_TIMEOUT; + if (typeof spys[spys.length - 1] == 'number') { + timeout = spys.pop(); + } + waitsFor(function() { + for (var i = 0; i < spys.length; ++i) { + if (spys[i].wasCalled) { + return true; + } + } + return false; + }, "Expecting callbacks to be called.", timeout); +} From 7405313dd18651a291213f7c4add707d553ef3d8 Mon Sep 17 00:00:00 2001 From: Bob Easterday Date: Fri, 10 May 2013 11:56:28 -0700 Subject: [PATCH 031/133] bump version after adding test spec --- plugin.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/plugin.xml b/plugin.xml index 92cdaebd..dfa7b650 100755 --- a/plugin.xml +++ b/plugin.xml @@ -2,7 +2,7 @@ + version="1.2.3"> PushPlugin From 9c53a2fc417aaa7a3f4307142fbbfe2b49f574d2 Mon Sep 17 00:00:00 2001 From: Bob Easterday Date: Fri, 10 May 2013 15:04:11 -0700 Subject: [PATCH 032/133] Fix the spec --- .gitignore | 2 ++ spec/config.xml | 2 +- spec/genericpush.tests.js | 6 +++--- spec/index.html | 2 +- 4 files changed, 7 insertions(+), 5 deletions(-) create mode 100644 .gitignore diff --git a/.gitignore b/.gitignore new file mode 100644 index 00000000..9bea4330 --- /dev/null +++ b/.gitignore @@ -0,0 +1,2 @@ + +.DS_Store diff --git a/spec/config.xml b/spec/config.xml index 0752d62b..2f6b9eb7 100644 --- a/spec/config.xml +++ b/spec/config.xml @@ -1,7 +1,7 @@ cordovaExample diff --git a/spec/genericpush.tests.js b/spec/genericpush.tests.js index 6dc2bd7b..7374ba4e 100644 --- a/spec/genericpush.tests.js +++ b/spec/genericpush.tests.js @@ -31,16 +31,16 @@ describe('Plugin object (window.plugins)', function () { it("should contain a register function", function() { expect(window.plugins.pushNotification.register).toBeDefined(); - expect(typeof window.plugins.barcodeScanner.register == 'function').toBe(true); + expect(typeof window.plugins.pushNotification.register == 'function').toBe(true); }); it("should contain an unregister function", function() { expect(window.plugins.pushNotification.unregister).toBeDefined(); - expect(typeof window.plugins.barcodeScanner.unregister == 'function').toBe(true); + expect(typeof window.plugins.pushNotification.unregister == 'function').toBe(true); }); it("should contain a setApplicationIconBadgeNumber function", function() { expect(window.plugins.pushNotification.setApplicationIconBadgeNumber).toBeDefined(); - expect(typeof window.plugins.barcodeScanner.setApplicationIconBadgeNumber == 'function').toBe(true); + expect(typeof window.plugins.pushNotification.setApplicationIconBadgeNumber == 'function').toBe(true); }); }); diff --git a/spec/index.html b/spec/index.html index a6bcd8b4..81655f36 100644 --- a/spec/index.html +++ b/spec/index.html @@ -58,7 +58,7 @@ var htmlReporter = new jasmine.HtmlReporter(); - jasmineEnv.addReporter(htmlReporter);jasmineEnv.addReporter(jr); + jasmineEnv.addReporter(htmlReporter); jasmineEnv.specFilter = function(spec) { return htmlReporter.specFilter(spec); From 71cb7f35a6b546fcb1385fa3f604cf0c2407542e Mon Sep 17 00:00:00 2001 From: Fil Maj Date: Wed, 15 May 2013 19:36:41 -0700 Subject: [PATCH 033/133] fully qualified paths for ios. --- plugin.xml | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/plugin.xml b/plugin.xml index dfa7b650..3c75e40e 100755 --- a/plugin.xml +++ b/plugin.xml @@ -59,11 +59,11 @@ - - + + - - + + From 30a413b8c90207396cfaee1949032baa2615ebae Mon Sep 17 00:00:00 2001 From: Guido Smeets Date: Fri, 17 May 2013 09:11:51 +0200 Subject: [PATCH 034/133] Updated to Cordova 2.7, fixed a number of bugs. Cleaned up some code. * Put all the plugin code in the plugin namespace: com.plugin.gcm; * Renamed to namespace GCM to gcm, namespaces should be lower case according to the java style guidelines; * Deleted the google gcm code and added gcm.jar instead; * Added CordovaGCMBroadcastReceiver.java to enable GCMIntentService to be namespaced in the plugin namespace instead of the client project (which is is the default with google's GCMIntentService); * Moved all java <--> javascript interop to PushPlugin; * Moved all notification code to GCMIntentService (maybe this fits better in its own class); * Changed the way the plugin detects cold starts in order for it not to crash when the back button is used to navigate out of the app; * Changed the caching on the filesystem to a memory cache on a static variable, which increases performance and simplifies code; * Cut up some code into separate methods ; * Added code comments; * Updated the readme file. --- README.md | 27 +- libs/gcm.jar | Bin 0 -> 13662 bytes plugin.xml | 23 +- .../android/gcm/GCMBaseIntentService.java | 299 ------------- .../android/gcm/GCMBroadcastReceiver.java | 57 --- .../com/google/android/gcm/GCMConstants.java | 161 ------- .../google/android/gcm/GCMIntentService.java | 152 ------- .../com/google/android/gcm/GCMRegistrar.java | 421 ------------------ .../com/plugin/GCM/PushHandlerActivity.java | 211 ++------- src/android/com/plugin/GCM/PushPlugin.java | 285 +++++++----- .../gcm/CordovaGCMBroadcastReceiver.java | 19 + .../com/plugin/gcm/GCMIntentService.java | 163 +++++++ 12 files changed, 434 insertions(+), 1384 deletions(-) create mode 100644 libs/gcm.jar delete mode 100644 src/android/com/google/android/gcm/GCMBaseIntentService.java delete mode 100644 src/android/com/google/android/gcm/GCMBroadcastReceiver.java delete mode 100644 src/android/com/google/android/gcm/GCMConstants.java delete mode 100644 src/android/com/google/android/gcm/GCMIntentService.java delete mode 100644 src/android/com/google/android/gcm/GCMRegistrar.java create mode 100644 src/android/com/plugin/gcm/CordovaGCMBroadcastReceiver.java create mode 100644 src/android/com/plugin/gcm/GCMIntentService.java diff --git a/README.md b/README.md index 70a2a35f..9c59a147 100644 --- a/README.md +++ b/README.md @@ -36,21 +36,20 @@ This plugin is for use with [Cordova](http://incubator.apache.org/cordova/), and ## Manual Installation for Android -1) copy the contents of **src/android/com/** to your project's **src/com/** folder. The final hirearchy will likely look something like this; +1) copy the contents of **src/android/com/** to your project's **src/com/** folder. + copy the contents of **libs/** to your **libs/** folder. + The final hirearchy will likely look something like this; {project_folder} + libs + gcm.jar src com - google - android - gcm - GCMBaseIntentService.java - GCMBroadcastReceiver.java - GCMConstants.java - GCMIntentService.java - GCMRegistrar.java plugin - GCM + gcm + CordovaGCMBroadcastReceiver.java + GCMIntentService.java + PushHandlerActivity.java PushPlugin.java {company_name} {intent_name} @@ -70,19 +69,19 @@ This plugin is for use with [Cordova](http://incubator.apache.org/cordova/), and 3) Modify your **AndroidManifest.xml** and add the following **activity**, **receiver** and **service** tags to your **application** section, replacing **your_app_package** with your app's package path: (See the Sample_AndroidManifest.xml file in the Example folder.) - - + + - + 4) Modify your **res/xml/config.xml** to include the following line in order to tell Cordova to include this plugin and where it can be found: (See the Sample_config.xml file in the Example folder) - + 5) Add the **PushNotification.js** script to your assets/www folder (or javascripts folder, wherever you want really) and reference it in your main index.html file. This file's usage is described in the **Plugin API** section below. diff --git a/libs/gcm.jar b/libs/gcm.jar new file mode 100644 index 0000000000000000000000000000000000000000..ac109a830ebe95e89e1456e23328212ad70576dc GIT binary patch literal 13662 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 K2s`$_e*GU@T3ng{ literal 0 HcmV?d00001 diff --git a/plugin.xml b/plugin.xml index dfa7b650..2d501b41 100755 --- a/plugin.xml +++ b/plugin.xml @@ -14,7 +14,7 @@ - + @@ -28,25 +28,24 @@ - - + + - + - - - - - - - - + + + + + + + diff --git a/src/android/com/google/android/gcm/GCMBaseIntentService.java b/src/android/com/google/android/gcm/GCMBaseIntentService.java deleted file mode 100644 index 95657654..00000000 --- a/src/android/com/google/android/gcm/GCMBaseIntentService.java +++ /dev/null @@ -1,299 +0,0 @@ -/* - * Copyright 2012 Google Inc. - * - * Licensed under the Apache License, Version 2.0 (the "License"); - * you may not use this file except in compliance with the License. - * You may obtain a copy of the License at - * - * http://www.apache.org/licenses/LICENSE-2.0 - * - * Unless required by applicable law or agreed to in writing, software - * distributed under the License is distributed on an "AS IS" BASIS, - * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. - * See the License for the specific language governing permissions and - * limitations under the License. - */ - -package com.google.android.gcm; - -import static com.google.android.gcm.GCMConstants.ERROR_SERVICE_NOT_AVAILABLE; -import static com.google.android.gcm.GCMConstants.EXTRA_ERROR; -import static com.google.android.gcm.GCMConstants.EXTRA_REGISTRATION_ID; -import static com.google.android.gcm.GCMConstants.EXTRA_SPECIAL_MESSAGE; -import static com.google.android.gcm.GCMConstants.EXTRA_TOTAL_DELETED; -import static com.google.android.gcm.GCMConstants.EXTRA_UNREGISTERED; -import static com.google.android.gcm.GCMConstants.INTENT_FROM_GCM_LIBRARY_RETRY; -import static com.google.android.gcm.GCMConstants.INTENT_FROM_GCM_MESSAGE; -import static com.google.android.gcm.GCMConstants.INTENT_FROM_GCM_REGISTRATION_CALLBACK; -import static com.google.android.gcm.GCMConstants.VALUE_DELETED_MESSAGES; - -import android.app.AlarmManager; -import android.app.IntentService; -import android.app.PendingIntent; -import android.content.Context; -import android.content.Intent; -import android.os.PowerManager; -import android.os.SystemClock; -import android.util.Log; - -import java.util.Random; -import java.util.concurrent.TimeUnit; - -/** - * Skeleton for application-specific {@link IntentService}s responsible for - * handling communication from Google Cloud Messaging service. - *

    - * The abstract methods in this class are called from its worker thread, and - * hence should run in a limited amount of time. If they execute long - * operations, they should spawn new threads, otherwise the worker thread will - * be blocked. - */ -public abstract class GCMBaseIntentService extends IntentService { - - public static final String TAG = "GCMBaseIntentService"; - - // wakelock - private static final String WAKELOCK_KEY = "GCM_LIB"; - private static PowerManager.WakeLock sWakeLock; - - // Java lock used to synchronize access to sWakelock - private static final Object LOCK = GCMBaseIntentService.class; - - private final String mSenderId; - - // instance counter - private static int sCounter = 0; - - private static final Random sRandom = new Random(); - - private static final int MAX_BACKOFF_MS = - (int) TimeUnit.SECONDS.toMillis(3600); // 1 hour - - // token used to check intent origin - private static final String TOKEN = - Long.toBinaryString(sRandom.nextLong()); - private static final String EXTRA_TOKEN = "token"; - - /** - * Subclasses must create a public no-arg constructor and pass the - * sender id to be used for registration. - */ - protected GCMBaseIntentService(String senderId) { - // name is used as base name for threads, etc. - super("GCMIntentService-" + senderId + "-" + (++sCounter)); - mSenderId = senderId; - } - - /** - * Called when a cloud message has been received. - * - * @param context application's context. - * @param intent intent containing the message payload as extras. - */ - protected abstract void onMessage(Context context, Intent intent); - - /** - * Called when the GCM server tells pending messages have been deleted - * because the device was idle. - * - * @param context application's context. - * @param total total number of collapsed messages - */ - protected void onDeletedMessages(Context context, int total) { - } - - /** - * Called on a registration error that could be retried. - * - *

    By default, it does nothing and returns {@literal true}, but could be - * overridden to change that behavior and/or display the error. - * - * @param context application's context. - * @param errorId error id returned by the GCM service. - * - * @return if {@literal true}, failed operation will be retried (using - * exponential backoff). - */ - protected boolean onRecoverableError(Context context, String errorId) { - return true; - } - - /** - * Called on registration or unregistration error. - * - * @param context application's context. - * @param errorId error id returned by the GCM service. - */ - protected abstract void onError(Context context, String errorId); - - /** - * Called after a device has been registered. - * - * @param context application's context. - * @param registrationId the registration id returned by the GCM service. - */ - protected abstract void onRegistered(Context context, - String registrationId); - - /** - * Called after a device has been unregistered. - * - * @param registrationId the registration id that was previously registered. - * @param context application's context. - */ - protected abstract void onUnregistered(Context context, - String registrationId); - - @Override - public final void onHandleIntent(Intent intent) { - try { - Context context = getApplicationContext(); - String action = intent.getAction(); - if (action.equals(INTENT_FROM_GCM_REGISTRATION_CALLBACK)) { - handleRegistration(context, intent); - } else if (action.equals(INTENT_FROM_GCM_MESSAGE)) { - // checks for special messages - String messageType = - intent.getStringExtra(EXTRA_SPECIAL_MESSAGE); - if (messageType != null) { - if (messageType.equals(VALUE_DELETED_MESSAGES)) { - String sTotal = - intent.getStringExtra(EXTRA_TOTAL_DELETED); - if (sTotal != null) { - try { - int total = Integer.parseInt(sTotal); - Log.v(TAG, "Received deleted messages " + - "notification: " + total); - onDeletedMessages(context, total); - } catch (NumberFormatException e) { - Log.e(TAG, "GCM returned invalid number of " + - "deleted messages: " + sTotal); - } - } - } else { - // application is not using the latest GCM library - Log.e(TAG, "Received unknown special message: " + - messageType); - } - } else { - onMessage(context, intent); - } - } else if (action.equals(INTENT_FROM_GCM_LIBRARY_RETRY)) { - String token = intent.getStringExtra(EXTRA_TOKEN); - if (!TOKEN.equals(token)) { - // make sure intent was generated by this class, not by a - // malicious app. - Log.e(TAG, "Received invalid token: " + token); - return; - } - // retry last call - if (GCMRegistrar.isRegistered(context)) { - GCMRegistrar.internalUnregister(context); - } else { - GCMRegistrar.internalRegister(context, mSenderId); - } - } - } finally { - // Release the power lock, so phone can get back to sleep. - // The lock is reference-counted by default, so multiple - // messages are ok. - - // If onMessage() needs to spawn a thread or do something else, - // it should use its own lock. - synchronized (LOCK) { - // sanity check for null as this is a public method - if (sWakeLock != null) { - Log.v(TAG, "Releasing wakelock"); - sWakeLock.release(); - } else { - // should never happen during normal workflow - Log.e(TAG, "Wakelock reference is null"); - } - } - } - } - - /** - * Called from the broadcast receiver. - *

    - * Will process the received intent, call handleMessage(), registered(), - * etc. in background threads, with a wake lock, while keeping the service - * alive. - */ - static void runIntentInService(Context context, Intent intent, - String className) { - synchronized (LOCK) { - if (sWakeLock == null) { - // This is called from BroadcastReceiver, there is no init. - PowerManager pm = (PowerManager) - context.getSystemService(Context.POWER_SERVICE); - sWakeLock = pm.newWakeLock(PowerManager.PARTIAL_WAKE_LOCK, - WAKELOCK_KEY); - } - } - Log.v(TAG, "Acquiring wakelock"); - sWakeLock.acquire(); - intent.setClassName(context, className); - context.startService(intent); - } - - private void handleRegistration(final Context context, Intent intent) { - String registrationId = intent.getStringExtra(EXTRA_REGISTRATION_ID); - String error = intent.getStringExtra(EXTRA_ERROR); - String unregistered = intent.getStringExtra(EXTRA_UNREGISTERED); - Log.d(TAG, "handleRegistration: registrationId = " + registrationId + - ", error = " + error + ", unregistered = " + unregistered); - - // registration succeeded - if (registrationId != null) { - GCMRegistrar.resetBackoff(context); - GCMRegistrar.setRegistrationId(context, registrationId); - onRegistered(context, registrationId); - return; - } - - // unregistration succeeded - if (unregistered != null) { - // Remember we are unregistered - GCMRegistrar.resetBackoff(context); - String oldRegistrationId = - GCMRegistrar.clearRegistrationId(context); - onUnregistered(context, oldRegistrationId); - return; - } - - // last operation (registration or unregistration) returned an error; - Log.d(TAG, "Registration error: " + error); - // Registration failed - if (ERROR_SERVICE_NOT_AVAILABLE.equals(error)) { - boolean retry = onRecoverableError(context, error); - if (retry) { - int backoffTimeMs = GCMRegistrar.getBackoff(context); - int nextAttempt = backoffTimeMs / 2 + - sRandom.nextInt(backoffTimeMs); - Log.d(TAG, "Scheduling registration retry, backoff = " + - nextAttempt + " (" + backoffTimeMs + ")"); - Intent retryIntent = - new Intent(INTENT_FROM_GCM_LIBRARY_RETRY); - retryIntent.putExtra(EXTRA_TOKEN, TOKEN); - PendingIntent retryPendingIntent = PendingIntent - .getBroadcast(context, 0, retryIntent, 0); - AlarmManager am = (AlarmManager) - context.getSystemService(Context.ALARM_SERVICE); - am.set(AlarmManager.ELAPSED_REALTIME, - SystemClock.elapsedRealtime() + nextAttempt, - retryPendingIntent); - // Next retry should wait longer. - if (backoffTimeMs < MAX_BACKOFF_MS) { - GCMRegistrar.setBackoff(context, backoffTimeMs * 2); - } - } else { - Log.d(TAG, "Not retrying failed operation"); - } - } else { - // Unrecoverable error, notify app - onError(context, error); - } - } - -} diff --git a/src/android/com/google/android/gcm/GCMBroadcastReceiver.java b/src/android/com/google/android/gcm/GCMBroadcastReceiver.java deleted file mode 100644 index 6e9b7ebb..00000000 --- a/src/android/com/google/android/gcm/GCMBroadcastReceiver.java +++ /dev/null @@ -1,57 +0,0 @@ -/* - * Copyright 2012 Google Inc. - * - * Licensed under the Apache License, Version 2.0 (the "License"); - * you may not use this file except in compliance with the License. - * You may obtain a copy of the License at - * - * http://www.apache.org/licenses/LICENSE-2.0 - * - * Unless required by applicable law or agreed to in writing, software - * distributed under the License is distributed on an "AS IS" BASIS, - * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. - * See the License for the specific language governing permissions and - * limitations under the License. - */ - -package com.google.android.gcm; - -import static com.google.android.gcm.GCMConstants.DEFAULT_INTENT_SERVICE_CLASS_NAME; - -import android.app.Activity; -import android.content.BroadcastReceiver; -import android.content.Context; -import android.content.Intent; -import android.util.Log; - -/** - * {@link BroadcastReceiver} that receives GCM messages and delivers them to - * an application-specific {@link GCMBaseIntentService} subclass. - *

    - * By default, the {@link GCMBaseIntentService} class belongs to the application - * main package and is named - * {@link GCMConstants#DEFAULT_INTENT_SERVICE_CLASS_NAME}. To use a new class, - * the {@link #getGCMIntentServiceClassName(Context)} must be overridden. - */ -public class GCMBroadcastReceiver extends BroadcastReceiver { - - private static final String TAG = "GCMBroadcastReceiver"; - - @Override - public final void onReceive(Context context, Intent intent) { - Log.v(TAG, "onReceive: " + intent.getAction()); - String className = getGCMIntentServiceClassName(context); - Log.v(TAG, "GCM IntentService class: " + className); - // Delegates to the application-specific intent service. - GCMBaseIntentService.runIntentInService(context, intent, className); - setResult(Activity.RESULT_OK, null /* data */, null /* extra */); - } - - /** - * Gets the class name of the intent service that will handle GCM messages. - */ - protected String getGCMIntentServiceClassName(Context context) { - return "com.google.android.gcm" + DEFAULT_INTENT_SERVICE_CLASS_NAME; - } - -} diff --git a/src/android/com/google/android/gcm/GCMConstants.java b/src/android/com/google/android/gcm/GCMConstants.java deleted file mode 100644 index abcdcfb0..00000000 --- a/src/android/com/google/android/gcm/GCMConstants.java +++ /dev/null @@ -1,161 +0,0 @@ -/* - * Copyright 2012 Google Inc. - * - * Licensed under the Apache License, Version 2.0 (the "License"); - * you may not use this file except in compliance with the License. - * You may obtain a copy of the License at - * - * http://www.apache.org/licenses/LICENSE-2.0 - * - * Unless required by applicable law or agreed to in writing, software - * distributed under the License is distributed on an "AS IS" BASIS, - * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. - * See the License for the specific language governing permissions and - * limitations under the License. - */ - -package com.google.android.gcm; - -/** - * Constants used by the GCM library. - */ -public final class GCMConstants { - - /** - * Intent sent to GCM to register the application. - */ - public static final String INTENT_TO_GCM_REGISTRATION = - "com.google.android.c2dm.intent.REGISTER"; - - /** - * Intent sent to GCM to unregister the application. - */ - public static final String INTENT_TO_GCM_UNREGISTRATION = - "com.google.android.c2dm.intent.UNREGISTER"; - - /** - * Intent sent by GCM indicating with the result of a registration request. - */ - public static final String INTENT_FROM_GCM_REGISTRATION_CALLBACK = - "com.google.android.c2dm.intent.REGISTRATION"; - - /** - * Intent used by the GCM library to indicate that the registration call - * should be retried. - */ - public static final String INTENT_FROM_GCM_LIBRARY_RETRY = - "com.google.android.gcm.intent.RETRY"; - - /** - * Intent sent by GCM containing a message. - */ - public static final String INTENT_FROM_GCM_MESSAGE = - "com.google.android.c2dm.intent.RECEIVE"; - - /** - * Extra used on {@link #INTENT_TO_GCM_REGISTRATION} to indicate the sender - * account (a Google email) that owns the application. - */ - public static final String EXTRA_SENDER = "sender"; - - /** - * Extra used on {@link #INTENT_TO_GCM_REGISTRATION} to get the application - * id. - */ - public static final String EXTRA_APPLICATION_PENDING_INTENT = "app"; - - /** - * Extra used on {@link #INTENT_FROM_GCM_REGISTRATION_CALLBACK} to indicate - * that the application has been unregistered. - */ - public static final String EXTRA_UNREGISTERED = "unregistered"; - - /** - * Extra used on {@link #INTENT_FROM_GCM_REGISTRATION_CALLBACK} to indicate - * an error when the registration fails. See constants starting with ERROR_ - * for possible values. - */ - public static final String EXTRA_ERROR = "error"; - - /** - * Extra used on {@link #INTENT_FROM_GCM_REGISTRATION_CALLBACK} to indicate - * the registration id when the registration succeeds. - */ - public static final String EXTRA_REGISTRATION_ID = "registration_id"; - - /** - * Type of message present in the {@link #INTENT_FROM_GCM_MESSAGE} intent. - * This extra is only set for special messages sent from GCM, not for - * messages originated from the application. - */ - public static final String EXTRA_SPECIAL_MESSAGE = "message_type"; - - /** - * Special message indicating the server deleted the pending messages. - */ - public static final String VALUE_DELETED_MESSAGES = "deleted_messages"; - - /** - * Number of messages deleted by the server because the device was idle. - * Present only on messages of special type - * {@link #VALUE_DELETED_MESSAGES} - */ - public static final String EXTRA_TOTAL_DELETED = "total_deleted"; - - /** - * Permission necessary to receive GCM intents. - */ - public static final String PERMISSION_GCM_INTENTS = - "com.google.android.c2dm.permission.SEND"; - - /** - * @see GCMBroadcastReceiver - */ - public static final String DEFAULT_INTENT_SERVICE_CLASS_NAME = - ".GCMIntentService"; - - /** - * The device can't read the response, or there was a 500/503 from the - * server that can be retried later. The application should use exponential - * back off and retry. - */ - public static final String ERROR_SERVICE_NOT_AVAILABLE = - "SERVICE_NOT_AVAILABLE"; - - /** - * There is no Google account on the phone. The application should ask the - * user to open the account manager and add a Google account. - */ - public static final String ERROR_ACCOUNT_MISSING = - "ACCOUNT_MISSING"; - - /** - * Bad password. The application should ask the user to enter his/her - * password, and let user retry manually later. Fix on the device side. - */ - public static final String ERROR_AUTHENTICATION_FAILED = - "AUTHENTICATION_FAILED"; - - /** - * The request sent by the phone does not contain the expected parameters. - * This phone doesn't currently support GCM. - */ - public static final String ERROR_INVALID_PARAMETERS = - "INVALID_PARAMETERS"; - /** - * The sender account is not recognized. Fix on the device side. - */ - public static final String ERROR_INVALID_SENDER = - "INVALID_SENDER"; - - /** - * Incorrect phone registration with Google. This phone doesn't currently - * support GCM. - */ - public static final String ERROR_PHONE_REGISTRATION_ERROR = - "PHONE_REGISTRATION_ERROR"; - - private GCMConstants() { - throw new UnsupportedOperationException(); - } -} diff --git a/src/android/com/google/android/gcm/GCMIntentService.java b/src/android/com/google/android/gcm/GCMIntentService.java deleted file mode 100644 index a462b443..00000000 --- a/src/android/com/google/android/gcm/GCMIntentService.java +++ /dev/null @@ -1,152 +0,0 @@ -package com.google.android.gcm; - -import java.util.List; - -import com.plugin.GCM.PushHandlerActivity; -import org.json.JSONException; -import org.json.JSONObject; - -import android.annotation.SuppressLint; -import android.app.ActivityManager; -import android.app.ActivityManager.RunningTaskInfo; -import android.app.NotificationManager; -import android.app.PendingIntent; -import android.content.Context; -import android.content.Intent; -import android.media.Ringtone; -import android.media.RingtoneManager; -import android.net.Uri; -import android.os.Bundle; -import android.support.v4.app.NotificationCompat; -import android.util.Log; -import com.plugin.GCM.PushPlugin; - - -@SuppressLint("NewApi") -public class GCMIntentService extends GCMBaseIntentService { - - public static final String ME="GCMReceiver"; - - public GCMIntentService() { - super("GCMIntentService"); - } - private static final String TAG = "GCMIntentService"; - - @Override - public void onRegistered(Context context, String regId) { - - Log.v(ME + ":onRegistered", "Registration ID arrived!"); - Log.v(ME + ":onRegistered", regId); - - JSONObject json; - - try - { - json = new JSONObject().put("event", "registered"); - json.put("regid", regId); - - Log.v(ME + ":onRegisterd", json.toString()); - - // Send this JSON data to the JavaScript application above EVENT should be set to the msg type - // In this case this is the registration ID - PushPlugin.sendJavascript( json ); - - } - catch( JSONException e) - { - // No message to the user is sent, JSON failed - Log.e(ME + ":onRegisterd", "JSON exception"); - } - } - - @Override - public void onUnregistered(Context context, String regId) { - Log.d(TAG, "onUnregistered - regId: " + regId); - } - - @Override - protected void onMessage(Context context, Intent intent) { - Log.d(TAG, "onMessage - context: " + context); - - // Extract the payload from the message - Bundle extras = intent.getExtras(); - if (extras != null) - { - boolean foreground = this.isInForeground(); - - extras.putBoolean("foreground", foreground); - - if (foreground) - PushHandlerActivity.sendToApp(extras); - else - this.onReceive(context, extras); - } - } - - public void onReceive(Context context, Bundle extras) - { - NotificationManager mNotificationManager = (NotificationManager) getSystemService(Context.NOTIFICATION_SERVICE); - CharSequence appName = context.getPackageManager().getApplicationLabel(context.getApplicationInfo()); - if (null == appName) - appName = ""; - - Intent notificationIntent = new Intent(this, PushHandlerActivity.class); - notificationIntent.addFlags(Intent.FLAG_ACTIVITY_SINGLE_TOP | Intent.FLAG_ACTIVITY_CLEAR_TOP); - notificationIntent.putExtra("pushBundle", extras); - - PendingIntent contentIntent = PendingIntent.getActivity(this, 0, notificationIntent, PendingIntent.FLAG_UPDATE_CURRENT); - - NotificationCompat.Builder mBuilder = new NotificationCompat.Builder(context) - .setSmallIcon(context.getApplicationInfo().icon) - .setWhen(System.currentTimeMillis()) - .setContentTitle(appName) - .setTicker(appName) - .setContentIntent(contentIntent); - - String message = extras.getString("message"); - if (message != null) - { - mBuilder.setContentText(message); - } - else - { - mBuilder.setContentText(""); - } - - String msgcnt = extras.getString("msgcnt"); - if (msgcnt != null) - { - mBuilder.setNumber(Integer.parseInt(msgcnt)); - } - - mNotificationManager.notify((String) appName, PushHandlerActivity.NOTIFICATION_ID, mBuilder.build()); - try - { - Uri notification = RingtoneManager.getDefaultUri(RingtoneManager.TYPE_NOTIFICATION); - Ringtone r = RingtoneManager.getRingtone(getApplicationContext(), notification); - r.play(); - } - catch (Exception e) - { - e.printStackTrace(); - } - } - - public boolean isInForeground() - { - ActivityManager activityManager = (ActivityManager) getApplicationContext().getSystemService(Context.ACTIVITY_SERVICE); - List services = activityManager - .getRunningTasks(Integer.MAX_VALUE); - - if (services.get(0).topActivity.getPackageName().toString().equalsIgnoreCase(getApplicationContext().getPackageName().toString())) - return true; - - return false; - } - - @Override - public void onError(Context context, String errorId) { - Log.e(TAG, "onError - errorId: " + errorId); - } - -} diff --git a/src/android/com/google/android/gcm/GCMRegistrar.java b/src/android/com/google/android/gcm/GCMRegistrar.java deleted file mode 100644 index 61ab8f91..00000000 --- a/src/android/com/google/android/gcm/GCMRegistrar.java +++ /dev/null @@ -1,421 +0,0 @@ -/* - * Copyright 2012 Google Inc. - * - * Licensed under the Apache License, Version 2.0 (the "License"); - * you may not use this file except in compliance with the License. - * You may obtain a copy of the License at - * - * http://www.apache.org/licenses/LICENSE-2.0 - * - * Unless required by applicable law or agreed to in writing, software - * distributed under the License is distributed on an "AS IS" BASIS, - * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. - * See the License for the specific language governing permissions and - * limitations under the License. - */ - -package com.google.android.gcm; - -import android.app.PendingIntent; -import android.content.BroadcastReceiver; -import android.content.Context; -import android.content.Intent; -import android.content.IntentFilter; -import android.content.SharedPreferences; -import android.content.SharedPreferences.Editor; -import android.content.pm.ActivityInfo; -import android.content.pm.PackageInfo; -import android.content.pm.PackageManager; -import android.content.pm.PackageManager.NameNotFoundException; -import android.content.pm.ResolveInfo; -import android.os.Build; -import android.util.Log; - -import java.util.HashSet; -import java.util.List; -import java.util.Set; - -/** - * Utilities for device registration. - *

    - * Note: this class uses a private {@link SharedPreferences} - * object to keep track of the registration token. - */ -public final class GCMRegistrar { - - private static final String TAG = "GCMRegistrar"; - private static final String BACKOFF_MS = "backoff_ms"; - private static final String GSF_PACKAGE = "com.google.android.gsf"; - private static final String PREFERENCES = "com.google.android.gcm"; - private static final int DEFAULT_BACKOFF_MS = 3000; - private static final String PROPERTY_REG_ID = "regId"; - private static final String PROPERTY_APP_VERSION = "appVersion"; - private static final String PROPERTY_ON_SERVER = "onServer"; - - /** - * {@link GCMBroadcastReceiver} instance used to handle the retry intent. - * - *

    - * This instance cannot be the same as the one defined in the manifest - * because it needs a different permission. - */ - private static GCMBroadcastReceiver sRetryReceiver; - - /** - * Checks if the device has the proper dependencies installed. - *

    - * This method should be called when the application starts to verify that - * the device supports GCM. - * - * @param context application context. - * @throws UnsupportedOperationException if the device does not support GCM. - */ - public static void checkDevice(Context context) { - int version = Build.VERSION.SDK_INT; - if (version < 8) { - throw new UnsupportedOperationException("Device must be at least " + - "API Level 8 (instead of " + version + ")"); - } - PackageManager packageManager = context.getPackageManager(); - try { - packageManager.getPackageInfo(GSF_PACKAGE, 0); - } catch (NameNotFoundException e) { - throw new UnsupportedOperationException( - "Device does not have package " + GSF_PACKAGE); - } - } - - /** - * Checks that the application manifest is properly configured. - *

    - * A proper configuration means: - *

      - *
    1. It creates a custom permission called - * {@code PACKAGE_NAME.permission.C2D_MESSAGE}. - *
    2. It defines at least one {@link BroadcastReceiver} with category - * {@code PACKAGE_NAME}. - *
    3. The {@link BroadcastReceiver}(s) uses the - * {@value GCMConstants#PERMISSION_GCM_INTENTS} permission. - *
    4. The {@link BroadcastReceiver}(s) handles the 3 GCM intents - * ({@value GCMConstants#INTENT_FROM_GCM_MESSAGE}, - * {@value GCMConstants#INTENT_FROM_GCM_REGISTRATION_CALLBACK}, - * and {@value GCMConstants#INTENT_FROM_GCM_LIBRARY_RETRY}). - *
    - * ...where {@code PACKAGE_NAME} is the application package. - *

    - * This method should be used during development time to verify that the - * manifest is properly set up, but it doesn't need to be called once the - * application is deployed to the users' devices. - * - * @param context application context. - * @throws IllegalStateException if any of the conditions above is not met. - */ - public static void checkManifest(Context context) { - PackageManager packageManager = context.getPackageManager(); - String packageName = context.getPackageName(); - String permissionName = packageName + ".permission.C2D_MESSAGE"; - // check permission - try { - packageManager.getPermissionInfo(permissionName, - PackageManager.GET_PERMISSIONS); - } catch (NameNotFoundException e) { - throw new IllegalStateException( - "Application does not define permission " + permissionName); - } - // check receivers - PackageInfo receiversInfo; - try { - receiversInfo = packageManager.getPackageInfo( - packageName, PackageManager.GET_RECEIVERS); - } catch (NameNotFoundException e) { - throw new IllegalStateException( - "Could not get receivers for package " + packageName); - } - ActivityInfo[] receivers = receiversInfo.receivers; - if (receivers == null || receivers.length == 0) { - throw new IllegalStateException("No receiver for package " + - packageName); - } - if (Log.isLoggable(TAG, Log.VERBOSE)) { - Log.v(TAG, "number of receivers for " + packageName + ": " + - receivers.length); - } - Set allowedReceivers = new HashSet(); - for (ActivityInfo receiver : receivers) { - if (GCMConstants.PERMISSION_GCM_INTENTS.equals( - receiver.permission)) { - allowedReceivers.add(receiver.name); - } - } - if (allowedReceivers.isEmpty()) { - throw new IllegalStateException("No receiver allowed to receive " + - GCMConstants.PERMISSION_GCM_INTENTS); - } - checkReceiver(context, allowedReceivers, - GCMConstants.INTENT_FROM_GCM_REGISTRATION_CALLBACK); - checkReceiver(context, allowedReceivers, - GCMConstants.INTENT_FROM_GCM_MESSAGE); - } - - private static void checkReceiver(Context context, - Set allowedReceivers, String action) { - PackageManager pm = context.getPackageManager(); - String packageName = context.getPackageName(); - Intent intent = new Intent(action); - intent.setPackage(packageName); - List receivers = pm.queryBroadcastReceivers(intent, - PackageManager.GET_INTENT_FILTERS); - if (receivers.isEmpty()) { - throw new IllegalStateException("No receivers for action " + - action); - } - if (Log.isLoggable(TAG, Log.VERBOSE)) { - Log.v(TAG, "Found " + receivers.size() + " receivers for action " + - action); - } - // make sure receivers match - for (ResolveInfo receiver : receivers) { - String name = receiver.activityInfo.name; - if (! allowedReceivers.contains(name)) { - throw new IllegalStateException("Receiver " + name + - " is not set with permission " + - GCMConstants.PERMISSION_GCM_INTENTS); - } - } - } - - /** - * Initiate messaging registration for the current application. - *

    - * The result will be returned as an - * {@link GCMConstants#INTENT_FROM_GCM_REGISTRATION_CALLBACK} intent with - * either a {@link GCMConstants#EXTRA_REGISTRATION_ID} or - * {@link GCMConstants#EXTRA_ERROR}. - * - * @param context application context. - * @param senderIds Google Project ID of the accounts authorized to send - * messages to this application. - * @throws IllegalStateException if device does not have all GCM - * dependencies installed. - */ - public static void register(Context context, String... senderIds) { - setRetryBroadcastReceiver(context); - GCMRegistrar.resetBackoff(context); - internalRegister(context, senderIds); - } - - static void internalRegister(Context context, String... senderIds) { - if (senderIds == null || senderIds.length == 0 ) { - throw new IllegalArgumentException("No senderIds"); - } - StringBuilder builder = new StringBuilder(senderIds[0]); - for (int i = 1; i < senderIds.length; i++) { - builder.append(',').append(senderIds[i]); - } - String senders = builder.toString(); - Log.v(TAG, "Registering app " + context.getPackageName() + - " of senders " + senders); - Intent intent = new Intent(GCMConstants.INTENT_TO_GCM_REGISTRATION); - intent.setPackage(GSF_PACKAGE); - intent.putExtra(GCMConstants.EXTRA_APPLICATION_PENDING_INTENT, - PendingIntent.getBroadcast(context, 0, new Intent(), 0)); - intent.putExtra(GCMConstants.EXTRA_SENDER, senders); - context.startService(intent); - } - - /** - * Unregister the application. - *

    - * The result will be returned as an - * {@link GCMConstants#INTENT_FROM_GCM_REGISTRATION_CALLBACK} intent with an - * {@link GCMConstants#EXTRA_UNREGISTERED} extra. - */ - public static void unregister(Context context) { - setRetryBroadcastReceiver(context); - GCMRegistrar.resetBackoff(context); - internalUnregister(context); - } - - /** - * Clear internal resources. - * - *

    - * This method should be called by the main activity's {@code onDestroy()} - * method. - */ - public static synchronized void onDestroy(Context context) { - if (sRetryReceiver != null) { - Log.v(TAG, "Unregistering receiver"); - context.unregisterReceiver(sRetryReceiver); - sRetryReceiver = null; - } - } - - static void internalUnregister(Context context) { - Log.v(TAG, "Unregistering app " + context.getPackageName() ); - Intent intent = new Intent(GCMConstants.INTENT_TO_GCM_UNREGISTRATION); - intent.setPackage(GSF_PACKAGE); - intent.putExtra(GCMConstants.EXTRA_APPLICATION_PENDING_INTENT, - PendingIntent.getBroadcast(context, 0, new Intent(), 0)); - context.startService(intent); - } - - /** - * Lazy initializes the {@link GCMBroadcastReceiver} instance. - */ - private static synchronized void setRetryBroadcastReceiver(Context context) { - if (sRetryReceiver == null) { - sRetryReceiver = new GCMBroadcastReceiver(); - String category = context.getPackageName(); - IntentFilter filter = new IntentFilter( - GCMConstants.INTENT_FROM_GCM_LIBRARY_RETRY); - filter.addCategory(category); - // must use a permission that is defined on manifest for sure - String permission = category + ".permission.C2D_MESSAGE"; - Log.v(TAG, "Registering receiver"); - context.registerReceiver(sRetryReceiver, filter, permission, null); - } - } - - /** - * Gets the current registration id for application on GCM service. - *

    - * If result is empty, the registration has failed. - * - * @return registration id, or empty string if the registration is not - * complete. - */ - public static String getRegistrationId(Context context) { - final SharedPreferences prefs = getGCMPreferences(context); - String registrationId = prefs.getString(PROPERTY_REG_ID, ""); - // check if app was updated; if so, it must clear registration id to - // avoid a race condition if GCM sends a message - int oldVersion = prefs.getInt(PROPERTY_APP_VERSION, Integer.MIN_VALUE); - int newVersion = getAppVersion(context); - if (oldVersion != Integer.MIN_VALUE && oldVersion != newVersion) { - Log.v(TAG, "App version changed from " + oldVersion + " to " + - newVersion + "; resetting registration id"); - clearRegistrationId(context); - registrationId = ""; - } - return registrationId; - } - - /** - * Checks whether the application was successfully registered on GCM - * service. - */ - public static boolean isRegistered(Context context) { - return getRegistrationId(context).length() > 0; - } - - /** - * Clears the registration id in the persistence store. - * - * @param context application's context. - * @return old registration id. - */ - static String clearRegistrationId(Context context) { - return setRegistrationId(context, ""); - } - - /** - * Sets the registration id in the persistence store. - * - * @param context application's context. - * @param regId registration id - */ - static String setRegistrationId(Context context, String regId) { - final SharedPreferences prefs = getGCMPreferences(context); - String oldRegistrationId = prefs.getString(PROPERTY_REG_ID, ""); - int appVersion = getAppVersion(context); - Log.v(TAG, "Saving regId on app version " + appVersion); - Editor editor = prefs.edit(); - editor.putString(PROPERTY_REG_ID, regId); - editor.putInt(PROPERTY_APP_VERSION, appVersion); - editor.commit(); - return oldRegistrationId; - } - - /** - * Sets whether the device was successfully registered in the server side. - */ - public static void setRegisteredOnServer(Context context, boolean flag) { - final SharedPreferences prefs = getGCMPreferences(context); - Log.v(TAG, "Setting registered on server status as: " + flag); - Editor editor = prefs.edit(); - editor.putBoolean(PROPERTY_ON_SERVER, flag); - editor.commit(); - } - - /** - * Checks whether the device was successfully registered in the server side. - */ - public static boolean isRegisteredOnServer(Context context) { - final SharedPreferences prefs = getGCMPreferences(context); - boolean isRegistered = prefs.getBoolean(PROPERTY_ON_SERVER, false); - Log.v(TAG, "Is registered on server: " + isRegistered); - return isRegistered; - } - - /** - * Gets the application version. - */ - private static int getAppVersion(Context context) { - try { - PackageInfo packageInfo = context.getPackageManager() - .getPackageInfo(context.getPackageName(),0); - return packageInfo.versionCode; - } catch (NameNotFoundException e) { - // should never happen - throw new RuntimeException("Coult not get package name: " + e); - } - } - - /** - * Resets the backoff counter. - *

    - * This method should be called after a GCM call succeeds. - * - * @param context application's context. - */ - static void resetBackoff(Context context) { - Log.d(TAG, "resetting backoff for " + context.getPackageName()); - setBackoff(context, DEFAULT_BACKOFF_MS); - } - - /** - * Gets the current backoff counter. - * - * @param context application's context. - * @return current backoff counter, in milliseconds. - */ - static int getBackoff(Context context) { - final SharedPreferences prefs = getGCMPreferences(context); - return prefs.getInt(BACKOFF_MS, DEFAULT_BACKOFF_MS); - } - - /** - * Sets the backoff counter. - *

    - * This method should be called after a GCM call fails, passing an - * exponential value. - * - * @param context application's context. - * @param backoff new backoff counter, in milliseconds. - */ - static void setBackoff(Context context, int backoff) { - final SharedPreferences prefs = getGCMPreferences(context); - Editor editor = prefs.edit(); - editor.putInt(BACKOFF_MS, backoff); - editor.commit(); - } - - private static SharedPreferences getGCMPreferences(Context context) { - return context.getSharedPreferences(PREFERENCES, Context.MODE_PRIVATE); - } - - private GCMRegistrar() { - throw new UnsupportedOperationException(); - } -} diff --git a/src/android/com/plugin/GCM/PushHandlerActivity.java b/src/android/com/plugin/GCM/PushHandlerActivity.java index fc1fbfa7..338c2c50 100644 --- a/src/android/com/plugin/GCM/PushHandlerActivity.java +++ b/src/android/com/plugin/GCM/PushHandlerActivity.java @@ -1,19 +1,6 @@ -// -// PushHandlerActivity.java -// - -package com.plugin.GCM; - -import java.io.FileOutputStream; -import java.util.Iterator; - -import org.json.JSONArray; -import org.json.JSONException; -import org.json.JSONObject; +package com.plugin.gcm; import android.app.Activity; -import android.app.NotificationManager; -import android.content.Context; import android.content.Intent; import android.content.pm.PackageManager; import android.os.Bundle; @@ -21,159 +8,59 @@ public class PushHandlerActivity extends Activity { - public static final int NOTIFICATION_ID = 237; - public static boolean EXITED = false; - - // this activity will be started if the user touches a notification that we own. If returning from the background, - // we process it immediately. If from a cold start, we cache the payload and start the main activity which will then process the cached payload. - @Override - public void onCreate(Bundle savedInstanceState) - { - Log.v("onCreate:", "entry"); + private static String TAG = "PushHandlerActivity"; + + /* + * this activity will be started if the user touches a notification that we own. + * We send it's data off to the push plugin for processing. + * If needed, we boot up the main activity to kickstart the application. + * @see android.app.Activity#onCreate(android.os.Bundle) + */ + @Override + public void onCreate(Bundle savedInstanceState) + { + super.onCreate(savedInstanceState); + Log.v(TAG, "onCreate"); - super.onCreate(savedInstanceState); + boolean isPushPluginActive = PushPlugin.isActive(); + if (!isPushPluginActive) { + forceMainActivityReload(); + } + processPushBundle(isPushPluginActive); + + GCMIntentService.cancelNotification(this); - Bundle extras = getIntent().getExtras(); - if (extras != null) - { - Bundle originalExtras = extras.getBundle("pushBundle"); - if (originalExtras != null) - { - if (EXITED) - { - PackageManager pm = getPackageManager(); - Intent launchIntent = pm.getLaunchIntentForPackage(getApplicationContext().getPackageName()); - - // remember how we got here - originalExtras.putBoolean("coldstart", true); - - // serialize and cache the payload before starting the main activity. - String json = extrasToJSON(originalExtras).toString(); - try - { - FileOutputStream fos = openFileOutput("cached_payload", Context.MODE_PRIVATE); - fos.write(json.getBytes()); - fos.close(); - } - catch (Exception e) - { - e.printStackTrace(); - } + finish(); + } - // now fire up our main activity - startActivity(launchIntent); - } - else - { - // our main activity was already running (in the background), process the payload - sendToApp(originalExtras); - } + /** + * Takes the pushBundle extras from the intent, + * and sends it through to the PushPlugin for processing. + */ + private void processPushBundle(boolean isPushPluginActive) + { + Bundle extras = getIntent().getExtras(); - // Now that we've processed the notification, remove it from the tray - CharSequence appName = this.getPackageManager().getApplicationLabel(this.getApplicationInfo()); - if (null == (String)appName) - appName = ""; - - NotificationManager mNotificationManager = (NotificationManager) getSystemService(Context.NOTIFICATION_SERVICE); - mNotificationManager.cancel((String) appName, NOTIFICATION_ID); + if (extras != null) { + + Bundle originalExtras = extras.getBundle("pushBundle"); + + if ( !isPushPluginActive ) { + originalExtras.putBoolean("coldstart", true); } - } - - finish(); - } - - // surface the notification up to the JS layer - public static void sendToApp(Bundle extras) - { - JSONObject json = extrasToJSON(extras); - - PushPlugin.sendJavascript( json ); - } - - // serialize the bundle for caching or JS processing - private static JSONObject extrasToJSON(Bundle extras) - { - try - { - JSONObject json; - json = new JSONObject().put("event", "message"); - - JSONObject jsondata = new JSONObject(); - Iterator it = extras.keySet().iterator(); - while (it.hasNext()) - { - String key = it.next(); - String value = extras.getString(key); - - // System data from Android - if (key.equals("from") || key.equals("collapse_key")) - { - json.put(key, value); - } - else if (key.equals("foreground")) - { - json.put(key, extras.getBoolean("foreground")); - } - else if (key.equals("coldstart")) - { - json.put(key, extras.getBoolean("coldstart")); - } - else - { - // Maintain backwards compatibility - if (key.equals("message") || key.equals("msgcnt") || key.equals("soundname")) - { - json.put(key, value); - } - - // Try to figure out if the value is another JSON object - if (value.startsWith("{")) - { - try - { - JSONObject json2 = new JSONObject(value); - jsondata.put(key, json2); - } - catch (Exception e) - { - jsondata.put(key, value); - } - // Try to figure out if the value is another JSON array - } - else if (value.startsWith("[")) - { - try - { - JSONArray json2 = new JSONArray(value); - jsondata.put(key, json2); - } - catch (Exception e) - { - jsondata.put(key, value); - } - } - else - { - jsondata.put(key, value); - } - } - } // while - json.put("payload", jsondata); - - Log.v("extrasToJSON:", json.toString()); - return json; + PushPlugin.sendExtras(originalExtras); } - catch( JSONException e) - { - Log.e("extrasToJSON:", "JSON exception"); - } - return null; - } + } + + /** + * Forces the main activity to re-launch if it's unloaded. + */ + private void forceMainActivityReload() + { + PackageManager pm = getPackageManager(); + Intent launchIntent = pm.getLaunchIntentForPackage(getApplicationContext().getPackageName()); + startActivity(launchIntent); + } - @Override - protected void onNewIntent(Intent intent) - { - super.onNewIntent(intent); - } -} +} \ No newline at end of file diff --git a/src/android/com/plugin/GCM/PushPlugin.java b/src/android/com/plugin/GCM/PushPlugin.java index 60215223..65527c2a 100644 --- a/src/android/com/plugin/GCM/PushPlugin.java +++ b/src/android/com/plugin/GCM/PushPlugin.java @@ -1,143 +1,216 @@ -package com.plugin.GCM; +package com.plugin.gcm; -import java.io.BufferedReader; -import java.io.FileNotFoundException; -import java.io.IOException; -import java.io.InputStreamReader; +import java.util.Iterator; import org.json.JSONArray; import org.json.JSONException; import org.json.JSONObject; +import android.content.Context; +import android.os.Bundle; import android.util.Log; -import org.apache.cordova.api.Plugin; -import org.apache.cordova.api.PluginResult; -import org.apache.cordova.api.PluginResult.Status; -import com.google.android.gcm.*; +import org.apache.cordova.CordovaWebView; +import org.apache.cordova.api.CallbackContext; +import org.apache.cordova.api.CordovaPlugin; +import com.google.android.gcm.*; /** * @author awysocki - * */ -public class PushPlugin extends Plugin { - - public static final String ME="PushPlugin"; - - public static final String REGISTER="register"; - public static final String UNREGISTER="unregister"; - public static final String EXIT="exit"; - - public static Plugin gwebView; - private static String gECB; - private static String gSenderID; - - @SuppressWarnings("deprecation") - @Override - public PluginResult execute(String action, JSONArray data, String callbackId) - { - - PluginResult result = null; +public class PushPlugin extends CordovaPlugin { + public static final String TAG = "PushPlugin"; + + public static final String REGISTER = "register"; + public static final String UNREGISTER = "unregister"; + public static final String EXIT = "exit"; + + private static CordovaWebView gWebView; + private static String gECB; + private static String gSenderID; + private static Bundle gCachedExtras = null; + + /** + * Gets the application context from cordova's main activity. + * @return the application context + */ + private Context getApplicationContext() { + return this.cordova.getActivity().getApplicationContext(); + } - Log.v(ME + ":execute", "action=" + action); + @Override + public boolean execute(String action, JSONArray data, CallbackContext callbackContext) { - if (REGISTER.equals(action)) { + boolean result = false; - Log.v(ME + ":execute", "data=" + data.toString()); + Log.v(TAG, "execute: action=" + action); + if (REGISTER.equals(action)) { - try { + Log.v(TAG, "execute: data=" + data.toString()); - JSONObject jo= new JSONObject(data.toString().substring(1, data.toString().length()-1)); + try { + JSONObject jo = data.getJSONObject(0); + + gWebView = this.webView; + Log.v(TAG, "execute: jo=" + jo.toString()); - gwebView = this; + gECB = (String) jo.get("ecb"); + gSenderID = (String) jo.get("senderID"); - Log.v(ME + ":execute", "jo=" + jo.toString()); + Log.v(TAG, "execute: ECB=" + gECB + " senderID=" + gSenderID); - gECB = (String)jo.get("ecb"); - gSenderID = (String)jo.get("senderID"); + GCMRegistrar.register(getApplicationContext(), gSenderID); + result = true; + } catch (JSONException e) { + Log.e(TAG, "execute: Got JSON Exception " + e.getMessage()); + result = false; + } - Log.v(ME + ":execute", "ECB="+gECB+" senderID="+gSenderID ); + if ( gCachedExtras != null) { + Log.v(TAG, "sending cached extras"); + sendExtras(gCachedExtras); + gCachedExtras = null; + } + + } else if (UNREGISTER.equals(action)) { - GCMRegistrar.register(this.ctx.getContext(), gSenderID); + GCMRegistrar.unregister(getApplicationContext()); + Log.v(TAG, "UNREGISTER"); + result = true; + } else { + result = false; + Log.e(TAG, "Invalid action : " + action); + } - Log.v(ME + ":execute", "GCMRegistrar.register called "); + return result; + } - result = new PluginResult(Status.OK); - } - catch (JSONException e) { - Log.e(ME, "Got JSON Exception " + e.getMessage()); - result = new PluginResult(Status.JSON_EXCEPTION); - } - - // if a notification was touched while we were completely exited, process it now - try - { - BufferedReader inputReader = new BufferedReader(new InputStreamReader(ctx.getApplicationContext().openFileInput("cached_payload"))); - String inputString; - StringBuffer stringBuffer = new StringBuffer(); - while ((inputString = inputReader.readLine()) != null) - { - stringBuffer.append(inputString); - } + /* + * Sends a json object to the client as parameter to a method which is defined in gECB. + */ + public static void sendJavascript(JSONObject _json) { + String _d = "javascript:" + gECB + "(" + _json.toString() + ")"; + Log.v(TAG, "sendJavascript: " + _d); - // surface the cached payload - JSONObject jsonObj = new JSONObject(stringBuffer.toString()); - sendJavascript(jsonObj); - ctx.getApplicationContext().getFileStreamPath("cached_payload").delete(); - } - catch (FileNotFoundException fnf) - { - Log.e("REGISTER", fnf.getMessage()); - } - catch (IOException io) - { - io.printStackTrace(); - } - catch (JSONException j) - { - j.printStackTrace(); - } - - PushHandlerActivity.EXITED = false; - } - else if (UNREGISTER.equals(action)) { + if (gECB != null && gWebView != null) { + gWebView.sendJavascript(_d); + } + } - GCMRegistrar.unregister(this.ctx.getContext()); - - Log.v(ME + ":" + UNREGISTER, "GCMRegistrar.unregister called "); - result = new PluginResult(Status.OK); + /* + * Sends the pushbundle extras to the client application. + * If the client application isn't currently active, it is cached for later processing. + */ + public static void sendExtras(Bundle extras) + { + if (extras != null) { + if (gECB != null && gWebView != null) { + sendJavascript(convertBundleToJson(extras)); + } else { + Log.v(TAG, "sendExtras: caching extras to send at a later time."); + gCachedExtras = extras; + } + } + } + + /* + * serializes a bundle to JSON. + */ + private static JSONObject convertBundleToJson(Bundle extras) + { + try + { + JSONObject json; + json = new JSONObject().put("event", "message"); + + JSONObject jsondata = new JSONObject(); + Iterator it = extras.keySet().iterator(); + while (it.hasNext()) + { + String key = it.next(); + Object value = extras.get(key); + + // System data from Android + if (key.equals("from") || key.equals("collapse_key")) + { + json.put(key, value); + } + else if (key.equals("foreground")) + { + json.put(key, extras.getBoolean("foreground")); + } + else if (key.equals("coldstart")) + { + json.put(key, extras.getBoolean("coldstart")); + } + else + { + // Maintain backwards compatibility + if (key.equals("message") || key.equals("msgcnt") || key.equals("soundname")) + { + json.put(key, value); + } + + if ( value instanceof String ) { + // Try to figure out if the value is another JSON object + + String strValue = (String)value; + if (strValue.startsWith("{")) { + try { + JSONObject json2 = new JSONObject(strValue); + jsondata.put(key, json2); + } + catch (Exception e) { + jsondata.put(key, value); + } + // Try to figure out if the value is another JSON array + } + else if (strValue.startsWith("[")) + { + try + { + JSONArray json2 = new JSONArray(strValue); + jsondata.put(key, json2); + } + catch (Exception e) + { + jsondata.put(key, value); + } + } + else + { + jsondata.put(key, value); + } + } + } + } // while + json.put("payload", jsondata); + + Log.v(TAG, "extrasToJSON: " + json.toString()); + + return json; + } + catch( JSONException e) + { + Log.e(TAG, "extrasToJSON: JSON exception"); + } + return null; } - else + + public static boolean isActive() { - result = new PluginResult(Status.INVALID_ACTION); - Log.e(ME, "Invalid action : "+action); + return gWebView != null; } - - return result; - } - - - public static void sendJavascript( JSONObject _json ) - { - String _d = "javascript:"+gECB+"(" + _json.toString() + ")"; - Log.v(ME + ":sendJavascript", _d); - - if (gECB != null ) { - gwebView.sendJavascript( _d ); - } - } - - - public void onDestroy() + + public void onDestroy() { + GCMRegistrar.onDestroy(getApplicationContext()); + gWebView = null; + gECB = null; super.onDestroy(); - - // let the service know we are exiting so it can cache the next notification payload. - PushHandlerActivity.EXITED = true; - GCMRegistrar.onDestroy(cordova.getActivity()); } } diff --git a/src/android/com/plugin/gcm/CordovaGCMBroadcastReceiver.java b/src/android/com/plugin/gcm/CordovaGCMBroadcastReceiver.java new file mode 100644 index 00000000..e383f846 --- /dev/null +++ b/src/android/com/plugin/gcm/CordovaGCMBroadcastReceiver.java @@ -0,0 +1,19 @@ +package com.plugin.gcm; + +import android.content.Context; + +import com.google.android.gcm.GCMBroadcastReceiver; +import static com.google.android.gcm.GCMConstants.DEFAULT_INTENT_SERVICE_CLASS_NAME; + +/* + * Implementation of GCMBroadcastReceiver that hard-wires the intent service to be + * com.plugin.gcm.GCMIntentService, instead of your_package.GCMIntentService + */ +public class CordovaGCMBroadcastReceiver extends GCMBroadcastReceiver { + + @Override + protected String getGCMIntentServiceClassName(Context context) { + return "com.plugin.gcm" + DEFAULT_INTENT_SERVICE_CLASS_NAME; + } + +} \ No newline at end of file diff --git a/src/android/com/plugin/gcm/GCMIntentService.java b/src/android/com/plugin/gcm/GCMIntentService.java new file mode 100644 index 00000000..9a46aa4a --- /dev/null +++ b/src/android/com/plugin/gcm/GCMIntentService.java @@ -0,0 +1,163 @@ +package com.plugin.gcm; + +import java.util.List; + +import com.google.android.gcm.GCMBaseIntentService; +import org.json.JSONException; +import org.json.JSONObject; + +import android.annotation.SuppressLint; +import android.app.ActivityManager; +import android.app.ActivityManager.RunningTaskInfo; +import android.app.NotificationManager; +import android.app.PendingIntent; +import android.content.Context; +import android.content.Intent; +import android.media.Ringtone; +import android.media.RingtoneManager; +import android.net.Uri; +import android.os.Bundle; +import android.support.v4.app.NotificationCompat; +import android.util.Log; + +@SuppressLint("NewApi") +public class GCMIntentService extends GCMBaseIntentService { + + public static final int NOTIFICATION_ID = 237; + private static final String TAG = "GCMIntentService"; + + public GCMIntentService() { + super("GCMIntentService"); + } + + @Override + public void onRegistered(Context context, String regId) { + + Log.v(TAG, "onRegistered: "+ regId); + + JSONObject json; + + try + { + json = new JSONObject().put("event", "registered"); + json.put("regid", regId); + + Log.v(TAG, "onRegistered: " + json.toString()); + + // Send this JSON data to the JavaScript application above EVENT should be set to the msg type + // In this case this is the registration ID + PushPlugin.sendJavascript( json ); + + } + catch( JSONException e) + { + // No message to the user is sent, JSON failed + Log.e(TAG, "onRegistered: JSON exception"); + } + } + + @Override + public void onUnregistered(Context context, String regId) { + Log.d(TAG, "onUnregistered - regId: " + regId); + } + + @Override + protected void onMessage(Context context, Intent intent) { + Log.d(TAG, "onMessage - context: " + context); + + // Extract the payload from the message + Bundle extras = intent.getExtras(); + if (extras != null) + { + boolean foreground = this.isInForeground(); + + extras.putBoolean("foreground", foreground); + + if (foreground) + PushPlugin.sendExtras(extras); + else + createNotification(context, extras); + } + } + + public void createNotification(Context context, Bundle extras) + { + NotificationManager mNotificationManager = (NotificationManager) getSystemService(Context.NOTIFICATION_SERVICE); + String appName = getAppName(this); + + Intent notificationIntent = new Intent(this, PushHandlerActivity.class); + notificationIntent.addFlags(Intent.FLAG_ACTIVITY_SINGLE_TOP | Intent.FLAG_ACTIVITY_CLEAR_TOP); + notificationIntent.putExtra("pushBundle", extras); + + PendingIntent contentIntent = PendingIntent.getActivity(this, 0, notificationIntent, PendingIntent.FLAG_UPDATE_CURRENT); + + NotificationCompat.Builder mBuilder = + new NotificationCompat.Builder(context) + .setSmallIcon(context.getApplicationInfo().icon) + .setWhen(System.currentTimeMillis()) + .setContentTitle(appName) + .setTicker(appName) + .setContentIntent(contentIntent); + + String message = extras.getString("message"); + if (message != null) { + mBuilder.setContentText(message); + } else { + mBuilder.setContentText(""); + } + + String msgcnt = extras.getString("msgcnt"); + if (msgcnt != null) { + mBuilder.setNumber(Integer.parseInt(msgcnt)); + } + + mNotificationManager.notify((String) appName, NOTIFICATION_ID, mBuilder.build()); + tryPlayRingtone(); + } + + private void tryPlayRingtone() + { + try { + Uri notification = RingtoneManager.getDefaultUri(RingtoneManager.TYPE_NOTIFICATION); + Ringtone r = RingtoneManager.getRingtone(getApplicationContext(), notification); + r.play(); + } + catch (Exception e) { + Log.e(TAG, "failed to play notification ringtone"); + } + } + + public static void cancelNotification(Context context) + { + NotificationManager mNotificationManager = (NotificationManager) context.getSystemService(Context.NOTIFICATION_SERVICE); + mNotificationManager.cancel((String)getAppName(context), NOTIFICATION_ID); + } + + private static String getAppName(Context context) + { + CharSequence appName = + context + .getPackageManager() + .getApplicationLabel(context.getApplicationInfo()); + + return (String)appName; + } + + public boolean isInForeground() + { + ActivityManager activityManager = (ActivityManager) getApplicationContext().getSystemService(Context.ACTIVITY_SERVICE); + List services = activityManager + .getRunningTasks(Integer.MAX_VALUE); + + if (services.get(0).topActivity.getPackageName().toString().equalsIgnoreCase(getApplicationContext().getPackageName().toString())) + return true; + + return false; + } + + @Override + public void onError(Context context, String errorId) { + Log.e(TAG, "onError - errorId: " + errorId); + } + +} From 00a8a222bbead4c71a5b2e84efa9fb7862c5d2c8 Mon Sep 17 00:00:00 2001 From: Guido Smeets Date: Tue, 28 May 2013 14:38:32 +0200 Subject: [PATCH 035/133] moved libs/gcm.jar to src/android/libs/gcm.jar for plugman compatibility --- plugin.xml | 2 +- {libs => src/android/libs}/gcm.jar | Bin 2 files changed, 1 insertion(+), 1 deletion(-) rename {libs => src/android/libs}/gcm.jar (100%) diff --git a/plugin.xml b/plugin.xml index 2d501b41..9c9fb11d 100755 --- a/plugin.xml +++ b/plugin.xml @@ -39,7 +39,7 @@ - + diff --git a/libs/gcm.jar b/src/android/libs/gcm.jar similarity index 100% rename from libs/gcm.jar rename to src/android/libs/gcm.jar From 0eab86f51f40dce5461421206f717dd671a2afc8 Mon Sep 17 00:00:00 2001 From: Bob Easterday Date: Thu, 30 May 2013 13:29:51 -0700 Subject: [PATCH 036/133] bump version to deliniate 1st Plugman version --- plugin.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/plugin.xml b/plugin.xml index 3c75e40e..a4540fd6 100755 --- a/plugin.xml +++ b/plugin.xml @@ -2,7 +2,7 @@ + version="1.3.0"> PushPlugin From 2d599878f21b81174f971434ccbab962eddd8d7a Mon Sep 17 00:00:00 2001 From: Bob Easterday Date: Tue, 4 Jun 2013 08:40:46 -0700 Subject: [PATCH 037/133] Remove config file from spec for plugman compatibility --- spec/config.xml | 20 -------------------- 1 file changed, 20 deletions(-) delete mode 100644 spec/config.xml diff --git a/spec/config.xml b/spec/config.xml deleted file mode 100644 index 2f6b9eb7..00000000 --- a/spec/config.xml +++ /dev/null @@ -1,20 +0,0 @@ - - - cordovaExample - - - GenericPush Spec - - - - Bob Easterday - PhoneGap Team - - - - - - - From 720fb77197101253da7d03d26fedb14f382e011e Mon Sep 17 00:00:00 2001 From: Bob Easterday Date: Tue, 4 Jun 2013 14:34:21 -0700 Subject: [PATCH 038/133] Accept either Boolean or string argiuments to register method for iOS --- src/ios/PushPlugin.m | 28 +++++++++++++++++++++++----- 1 file changed, 23 insertions(+), 5 deletions(-) diff --git a/src/ios/PushPlugin.m b/src/ios/PushPlugin.m index ba1282d4..f4bbba64 100644 --- a/src/ios/PushPlugin.m +++ b/src/ios/PushPlugin.m @@ -56,14 +56,32 @@ - (void)register:(NSMutableArray *)arguments withDict:(NSMutableDictionary *)opt self.callbackId = [arguments pop]; UIRemoteNotificationType notificationTypes = UIRemoteNotificationTypeNone; + id badgeArg = [options objectForKey:@"badge"]; + id soundArg = [options objectForKey:@"sound"]; + id alertArg = [options objectForKey:@"alert"]; - if ([[options objectForKey:@"badge"] isEqualToString:@"true"]) + if ([badgeArg isKindOfClass:[NSString class]]) + { + if ([badgeArg isEqualToString:@"true"]) + notificationTypes |= UIRemoteNotificationTypeBadge; + } + else if ([badgeArg boolValue]) notificationTypes |= UIRemoteNotificationTypeBadge; - - if ([[options objectForKey:@"sound"] isEqualToString:@"true"]) + + if ([soundArg isKindOfClass:[NSString class]]) + { + if ([soundArg isEqualToString:@"true"]) + notificationTypes |= UIRemoteNotificationTypeSound; + } + else if ([soundArg boolValue]) notificationTypes |= UIRemoteNotificationTypeSound; - - if ([[options objectForKey:@"alert"] isEqualToString:@"true"]) + + if ([alertArg isKindOfClass:[NSString class]]) + { + if ([alertArg isEqualToString:@"true"]) + notificationTypes |= UIRemoteNotificationTypeAlert; + } + else if ([alertArg boolValue]) notificationTypes |= UIRemoteNotificationTypeAlert; self.callback = [options objectForKey:@"ecb"]; From 69fc815bb2b9a453879e51df16dcade02764996a Mon Sep 17 00:00:00 2001 From: Bob Easterday Date: Wed, 5 Jun 2013 11:35:48 -0700 Subject: [PATCH 039/133] Update documentation for pluginstall --- README.md | 55 ++++++++++++++++++++++++++++--------------------------- 1 file changed, 28 insertions(+), 27 deletions(-) diff --git a/README.md b/README.md index 9c59a147..132e33ef 100644 --- a/README.md +++ b/README.md @@ -43,6 +43,8 @@ This plugin is for use with [Cordova](http://incubator.apache.org/cordova/), and {project_folder} libs gcm.jar + android-support-v13.jar + cordova-2.7.0.jar src com plugin @@ -55,33 +57,32 @@ This plugin is for use with [Cordova](http://incubator.apache.org/cordova/), and {intent_name} {intent_name}.java -2) Modify your **AndroidManifest.xml** and add the following lines to your manifest tag, replacing **your_app_package** with your app's package path: +2) Modify your **AndroidManifest.xml** and add the following lines to your manifest tag: + + + + + + + - - - - - - - +3) Modify your **AndroidManifest.xml** and add the following **activity**, **receiver** and **service** tags to your **application** section. (See the Sample_AndroidManifest.xml file in the Example folder.) -3) Modify your **AndroidManifest.xml** and add the following **activity**, **receiver** and **service** tags to your **application** section, replacing **your_app_package** with your app's package path: (See the Sample_AndroidManifest.xml file in the Example folder.) - - - - - - - - - - + + + + + + + + + 4) Modify your **res/xml/config.xml** to include the following line in order to tell Cordova to include this plugin and where it can be found: (See the Sample_config.xml file in the Example folder) - + 5) Add the **PushNotification.js** script to your assets/www folder (or javascripts folder, wherever you want really) and reference it in your main index.html file. This file's usage is described in the **Plugin API** section below. @@ -96,27 +97,27 @@ Copy the following files to your project's Plugins folder: PushPlugin.h PushPlugin.m -Add a reference for this plugin to the plugins dictionary in **Cordove.plist**: +Add a reference for this plugin to the plugins section in **config.xml**: + + - PushPlugin - PushPlugin Add the **PushNotification.js** script to your assets/www folder (or javascripts folder, wherever you want really) and reference it in your main index.html file. ## Automatic Installation -This plugin is based on [pluginstall](https://github.com/alunny/pluginstall). to install it to your app, -simply execute pluginstall as follows; +This plugin is based on [plugman](https://github.com/apache/cordova-plugman). to install it to your app, +simply execute plugman as follows; - pluginstall [PLATFORM] [TARGET-PATH] [PLUGIN-PATH] + plugman --platform [PLATFORM] --project [TARGET-PATH] --plugin [PLUGIN-PATH] where [PLATFORM] = ios or android [TARGET-PATH] = path to folder containing your phonegap project [PLUGIN-PATH] = path to folder containing this plugin -For additional info, take a look at the [Cordova Pluginstall Specification](https://github.com/alunny/cordova-plugin-spec) +For additional info, take a look at the [Plugman Documentation](https://github.com/apache/cordova-plugman/blob/master/README.md) ## Plugin API From 06dc8cc553a8fc3115eb0556d06888e5cef128c0 Mon Sep 17 00:00:00 2001 From: Mikhail Benediktovich Date: Thu, 6 Jun 2013 16:40:17 +0300 Subject: [PATCH 040/133] error callback for setApplicationIconBadgeNumber --- README.md | 4 ++-- www/PushNotification.js | 2 +- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 132e33ef..be6547e1 100644 --- a/README.md +++ b/README.md @@ -183,7 +183,7 @@ In this example, be sure and substitute your own senderID. Get your senderID by } if (event.badge) { - pushNotification.setApplicationIconBadgeNumber(successHandler, event.badge); + pushNotification.setApplicationIconBadgeNumber(successHandler, errorHandler, event.badge); } } @@ -284,7 +284,7 @@ For the above to work, make sure the content for your home page is wrapped in an #### setApplicationIconBadgeNumber (iOS only) set the badge count visible when the app is not running - pushNotification.setApplicationIconBadgeNumber(successCallback, badgeCount); + pushNotification.setApplicationIconBadgeNumber(successCallback, errorCallback, badgeCount); **badgeCount** - an integer indicating what number should show up in the badge. Passing 0 will clear the badge. diff --git a/www/PushNotification.js b/www/PushNotification.js index 9bb6d5b0..a080e998 100644 --- a/www/PushNotification.js +++ b/www/PushNotification.js @@ -39,7 +39,7 @@ PushNotification.prototype.unregister = function(successCallback, errorCallback) // Call this to set the application icon badge -PushNotification.prototype.setApplicationIconBadgeNumber = function(successCallback, badge) { +PushNotification.prototype.setApplicationIconBadgeNumber = function(successCallback, errorCallback, badge) { if (errorCallback == null) { errorCallback = function() {}} if (typeof errorCallback != "function") { From 8e2c25ddb6979362327a0d3ab7e86e85695fa6f9 Mon Sep 17 00:00:00 2001 From: bobeast Date: Fri, 7 Jun 2013 13:31:49 -0700 Subject: [PATCH 041/133] surface payload when app is launched from incoming notification on iOS --- src/ios/AppDelegate+notification.m | 36 ++++++++++++++++++++++++++++-- src/ios/PushPlugin.m | 7 +++++- 2 files changed, 40 insertions(+), 3 deletions(-) diff --git a/src/ios/AppDelegate+notification.m b/src/ios/AppDelegate+notification.m index 4c71a58c..2ad5a271 100644 --- a/src/ios/AppDelegate+notification.m +++ b/src/ios/AppDelegate+notification.m @@ -19,6 +19,39 @@ - (id) getCommandInstance:(NSString*)className return [self.viewController getCommandInstance:className]; } +// its dangerous to override a method from within a category. +// Instead we will use method swizzling. we set this up in the load call. ++ (void)load +{ + Method original, swizzled; + + original = class_getInstanceMethod(self, @selector(init)); + swizzled = class_getInstanceMethod(self, @selector(swizzled_init)); + method_exchangeImplementations(original, swizzled); +} + +- (AppDelegate *)swizzled_init +{ + [[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(createNotificationChecker:) + name:@"UIApplicationDidFinishLaunchingNotification" object:nil]; + + // This actually calls the original init method over in AppDelegate. Equivilent to calling super + // on an overrided method, this is not recursive, although it appears that way. neat huh? + return [self swizzled_init]; +} + +// This code will be called immediately after application:didFinishLaunchingWithOptions:. We need +// to process notifications in cold-start situations +- (void)createNotificationChecker:(NSNotification *)notification +{ + if (notification) + { + NSDictionary *launchOptions = [notification userInfo]; + if (launchOptions) + self.launchNotification = [launchOptions objectForKey: @"UIApplicationLaunchOptionsRemoteNotificationKey"]; + } +} + - (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken { PushPlugin *pushHandler = [self getCommandInstance:@"PushPlugin"]; [pushHandler didRegisterForRemoteNotificationsWithDeviceToken:deviceToken]; @@ -58,10 +91,9 @@ - (void)applicationDidBecomeActive:(UIApplication *)application { if (![self.viewController.webView isLoading] && self.launchNotification) { PushPlugin *pushHandler = [self getCommandInstance:@"PushPlugin"]; + pushHandler.notificationMessage = self.launchNotification; - self.launchNotification = nil; - [pushHandler performSelectorOnMainThread:@selector(notificationReceived) withObject:pushHandler waitUntilDone:NO]; } } diff --git a/src/ios/PushPlugin.m b/src/ios/PushPlugin.m index f4bbba64..5ee569b0 100644 --- a/src/ios/PushPlugin.m +++ b/src/ios/PushPlugin.m @@ -92,6 +92,9 @@ - (void)register:(NSMutableArray *)arguments withDict:(NSMutableDictionary *)opt isInline = NO; [[UIApplication sharedApplication] registerForRemoteNotificationTypes:notificationTypes]; + + if (notificationMessage) // if there is a pending startup notification + [self notificationReceived]; // go ahead and process it } - (void)isEnabled:(NSMutableArray *)arguments withDict:(NSMutableDictionary *)options { @@ -174,7 +177,7 @@ - (void)didFailToRegisterForRemoteNotificationsWithError:(NSError *)error - (void)notificationReceived { NSLog(@"Notification received"); - if (notificationMessage) + if (notificationMessage && self.callback) { NSMutableString *jsonStr = [NSMutableString stringWithString:@"{"]; @@ -185,6 +188,8 @@ - (void)notificationReceived { [jsonStr appendFormat:@"foreground:'%d',", 1]; isInline = NO; } + else + [jsonStr appendFormat:@"foreground:'%d',", 0]; [jsonStr appendString:@"}"]; From 9baf9f769540f95f084743bed8fe59baa1448166 Mon Sep 17 00:00:00 2001 From: bobeast Date: Fri, 7 Jun 2013 13:34:35 -0700 Subject: [PATCH 042/133] Bump version --- plugin.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/plugin.xml b/plugin.xml index 83dd2615..0d5e0f4b 100755 --- a/plugin.xml +++ b/plugin.xml @@ -2,7 +2,7 @@ + version="1.3.1"> PushPlugin From c6ce167efff5136e2a7c826e19ce4f867170d367 Mon Sep 17 00:00:00 2001 From: Ryan Willoughby Date: Mon, 10 Jun 2013 13:45:44 -0700 Subject: [PATCH 043/133] [plugman] renaming GCM/ to gcm/ to make plugman work --- .../{GCM => gcm}/PushHandlerActivity.java | 130 +++--- .../com/plugin/{GCM => gcm}/PushPlugin.java | 432 +++++++++--------- 2 files changed, 281 insertions(+), 281 deletions(-) rename src/android/com/plugin/{GCM => gcm}/PushHandlerActivity.java (96%) rename src/android/com/plugin/{GCM => gcm}/PushPlugin.java (95%) diff --git a/src/android/com/plugin/GCM/PushHandlerActivity.java b/src/android/com/plugin/gcm/PushHandlerActivity.java similarity index 96% rename from src/android/com/plugin/GCM/PushHandlerActivity.java rename to src/android/com/plugin/gcm/PushHandlerActivity.java index 338c2c50..73846fb0 100644 --- a/src/android/com/plugin/GCM/PushHandlerActivity.java +++ b/src/android/com/plugin/gcm/PushHandlerActivity.java @@ -1,66 +1,66 @@ -package com.plugin.gcm; - -import android.app.Activity; -import android.content.Intent; -import android.content.pm.PackageManager; -import android.os.Bundle; -import android.util.Log; - -public class PushHandlerActivity extends Activity -{ - private static String TAG = "PushHandlerActivity"; - - /* - * this activity will be started if the user touches a notification that we own. - * We send it's data off to the push plugin for processing. - * If needed, we boot up the main activity to kickstart the application. - * @see android.app.Activity#onCreate(android.os.Bundle) - */ - @Override - public void onCreate(Bundle savedInstanceState) - { - super.onCreate(savedInstanceState); - Log.v(TAG, "onCreate"); - - boolean isPushPluginActive = PushPlugin.isActive(); - if (!isPushPluginActive) { - forceMainActivityReload(); - } - processPushBundle(isPushPluginActive); - - GCMIntentService.cancelNotification(this); - - finish(); - } - - /** - * Takes the pushBundle extras from the intent, - * and sends it through to the PushPlugin for processing. - */ - private void processPushBundle(boolean isPushPluginActive) - { - Bundle extras = getIntent().getExtras(); - - if (extras != null) { - - Bundle originalExtras = extras.getBundle("pushBundle"); - - if ( !isPushPluginActive ) { - originalExtras.putBoolean("coldstart", true); - } - - PushPlugin.sendExtras(originalExtras); - } - } - - /** - * Forces the main activity to re-launch if it's unloaded. - */ - private void forceMainActivityReload() - { - PackageManager pm = getPackageManager(); - Intent launchIntent = pm.getLaunchIntentForPackage(getApplicationContext().getPackageName()); - startActivity(launchIntent); - } - +package com.plugin.gcm; + +import android.app.Activity; +import android.content.Intent; +import android.content.pm.PackageManager; +import android.os.Bundle; +import android.util.Log; + +public class PushHandlerActivity extends Activity +{ + private static String TAG = "PushHandlerActivity"; + + /* + * this activity will be started if the user touches a notification that we own. + * We send it's data off to the push plugin for processing. + * If needed, we boot up the main activity to kickstart the application. + * @see android.app.Activity#onCreate(android.os.Bundle) + */ + @Override + public void onCreate(Bundle savedInstanceState) + { + super.onCreate(savedInstanceState); + Log.v(TAG, "onCreate"); + + boolean isPushPluginActive = PushPlugin.isActive(); + if (!isPushPluginActive) { + forceMainActivityReload(); + } + processPushBundle(isPushPluginActive); + + GCMIntentService.cancelNotification(this); + + finish(); + } + + /** + * Takes the pushBundle extras from the intent, + * and sends it through to the PushPlugin for processing. + */ + private void processPushBundle(boolean isPushPluginActive) + { + Bundle extras = getIntent().getExtras(); + + if (extras != null) { + + Bundle originalExtras = extras.getBundle("pushBundle"); + + if ( !isPushPluginActive ) { + originalExtras.putBoolean("coldstart", true); + } + + PushPlugin.sendExtras(originalExtras); + } + } + + /** + * Forces the main activity to re-launch if it's unloaded. + */ + private void forceMainActivityReload() + { + PackageManager pm = getPackageManager(); + Intent launchIntent = pm.getLaunchIntentForPackage(getApplicationContext().getPackageName()); + startActivity(launchIntent); + } + } \ No newline at end of file diff --git a/src/android/com/plugin/GCM/PushPlugin.java b/src/android/com/plugin/gcm/PushPlugin.java similarity index 95% rename from src/android/com/plugin/GCM/PushPlugin.java rename to src/android/com/plugin/gcm/PushPlugin.java index 65527c2a..75b30fcc 100644 --- a/src/android/com/plugin/GCM/PushPlugin.java +++ b/src/android/com/plugin/gcm/PushPlugin.java @@ -1,216 +1,216 @@ -package com.plugin.gcm; - -import java.util.Iterator; - -import org.json.JSONArray; -import org.json.JSONException; -import org.json.JSONObject; - -import android.content.Context; -import android.os.Bundle; -import android.util.Log; - -import org.apache.cordova.CordovaWebView; -import org.apache.cordova.api.CallbackContext; -import org.apache.cordova.api.CordovaPlugin; - -import com.google.android.gcm.*; - -/** - * @author awysocki - */ - -public class PushPlugin extends CordovaPlugin { - public static final String TAG = "PushPlugin"; - - public static final String REGISTER = "register"; - public static final String UNREGISTER = "unregister"; - public static final String EXIT = "exit"; - - private static CordovaWebView gWebView; - private static String gECB; - private static String gSenderID; - private static Bundle gCachedExtras = null; - - /** - * Gets the application context from cordova's main activity. - * @return the application context - */ - private Context getApplicationContext() { - return this.cordova.getActivity().getApplicationContext(); - } - - @Override - public boolean execute(String action, JSONArray data, CallbackContext callbackContext) { - - boolean result = false; - - Log.v(TAG, "execute: action=" + action); - - if (REGISTER.equals(action)) { - - Log.v(TAG, "execute: data=" + data.toString()); - - try { - JSONObject jo = data.getJSONObject(0); - - gWebView = this.webView; - Log.v(TAG, "execute: jo=" + jo.toString()); - - gECB = (String) jo.get("ecb"); - gSenderID = (String) jo.get("senderID"); - - Log.v(TAG, "execute: ECB=" + gECB + " senderID=" + gSenderID); - - GCMRegistrar.register(getApplicationContext(), gSenderID); - result = true; - } catch (JSONException e) { - Log.e(TAG, "execute: Got JSON Exception " + e.getMessage()); - result = false; - } - - if ( gCachedExtras != null) { - Log.v(TAG, "sending cached extras"); - sendExtras(gCachedExtras); - gCachedExtras = null; - } - - } else if (UNREGISTER.equals(action)) { - - GCMRegistrar.unregister(getApplicationContext()); - - Log.v(TAG, "UNREGISTER"); - result = true; - } else { - result = false; - Log.e(TAG, "Invalid action : " + action); - } - - return result; - } - - /* - * Sends a json object to the client as parameter to a method which is defined in gECB. - */ - public static void sendJavascript(JSONObject _json) { - String _d = "javascript:" + gECB + "(" + _json.toString() + ")"; - Log.v(TAG, "sendJavascript: " + _d); - - if (gECB != null && gWebView != null) { - gWebView.sendJavascript(_d); - } - } - - /* - * Sends the pushbundle extras to the client application. - * If the client application isn't currently active, it is cached for later processing. - */ - public static void sendExtras(Bundle extras) - { - if (extras != null) { - if (gECB != null && gWebView != null) { - sendJavascript(convertBundleToJson(extras)); - } else { - Log.v(TAG, "sendExtras: caching extras to send at a later time."); - gCachedExtras = extras; - } - } - } - - /* - * serializes a bundle to JSON. - */ - private static JSONObject convertBundleToJson(Bundle extras) - { - try - { - JSONObject json; - json = new JSONObject().put("event", "message"); - - JSONObject jsondata = new JSONObject(); - Iterator it = extras.keySet().iterator(); - while (it.hasNext()) - { - String key = it.next(); - Object value = extras.get(key); - - // System data from Android - if (key.equals("from") || key.equals("collapse_key")) - { - json.put(key, value); - } - else if (key.equals("foreground")) - { - json.put(key, extras.getBoolean("foreground")); - } - else if (key.equals("coldstart")) - { - json.put(key, extras.getBoolean("coldstart")); - } - else - { - // Maintain backwards compatibility - if (key.equals("message") || key.equals("msgcnt") || key.equals("soundname")) - { - json.put(key, value); - } - - if ( value instanceof String ) { - // Try to figure out if the value is another JSON object - - String strValue = (String)value; - if (strValue.startsWith("{")) { - try { - JSONObject json2 = new JSONObject(strValue); - jsondata.put(key, json2); - } - catch (Exception e) { - jsondata.put(key, value); - } - // Try to figure out if the value is another JSON array - } - else if (strValue.startsWith("[")) - { - try - { - JSONArray json2 = new JSONArray(strValue); - jsondata.put(key, json2); - } - catch (Exception e) - { - jsondata.put(key, value); - } - } - else - { - jsondata.put(key, value); - } - } - } - } // while - json.put("payload", jsondata); - - Log.v(TAG, "extrasToJSON: " + json.toString()); - - return json; - } - catch( JSONException e) - { - Log.e(TAG, "extrasToJSON: JSON exception"); - } - return null; - } - - public static boolean isActive() - { - return gWebView != null; - } - - public void onDestroy() - { - GCMRegistrar.onDestroy(getApplicationContext()); - gWebView = null; - gECB = null; - super.onDestroy(); - } -} +package com.plugin.gcm; + +import java.util.Iterator; + +import org.json.JSONArray; +import org.json.JSONException; +import org.json.JSONObject; + +import android.content.Context; +import android.os.Bundle; +import android.util.Log; + +import org.apache.cordova.CordovaWebView; +import org.apache.cordova.api.CallbackContext; +import org.apache.cordova.api.CordovaPlugin; + +import com.google.android.gcm.*; + +/** + * @author awysocki + */ + +public class PushPlugin extends CordovaPlugin { + public static final String TAG = "PushPlugin"; + + public static final String REGISTER = "register"; + public static final String UNREGISTER = "unregister"; + public static final String EXIT = "exit"; + + private static CordovaWebView gWebView; + private static String gECB; + private static String gSenderID; + private static Bundle gCachedExtras = null; + + /** + * Gets the application context from cordova's main activity. + * @return the application context + */ + private Context getApplicationContext() { + return this.cordova.getActivity().getApplicationContext(); + } + + @Override + public boolean execute(String action, JSONArray data, CallbackContext callbackContext) { + + boolean result = false; + + Log.v(TAG, "execute: action=" + action); + + if (REGISTER.equals(action)) { + + Log.v(TAG, "execute: data=" + data.toString()); + + try { + JSONObject jo = data.getJSONObject(0); + + gWebView = this.webView; + Log.v(TAG, "execute: jo=" + jo.toString()); + + gECB = (String) jo.get("ecb"); + gSenderID = (String) jo.get("senderID"); + + Log.v(TAG, "execute: ECB=" + gECB + " senderID=" + gSenderID); + + GCMRegistrar.register(getApplicationContext(), gSenderID); + result = true; + } catch (JSONException e) { + Log.e(TAG, "execute: Got JSON Exception " + e.getMessage()); + result = false; + } + + if ( gCachedExtras != null) { + Log.v(TAG, "sending cached extras"); + sendExtras(gCachedExtras); + gCachedExtras = null; + } + + } else if (UNREGISTER.equals(action)) { + + GCMRegistrar.unregister(getApplicationContext()); + + Log.v(TAG, "UNREGISTER"); + result = true; + } else { + result = false; + Log.e(TAG, "Invalid action : " + action); + } + + return result; + } + + /* + * Sends a json object to the client as parameter to a method which is defined in gECB. + */ + public static void sendJavascript(JSONObject _json) { + String _d = "javascript:" + gECB + "(" + _json.toString() + ")"; + Log.v(TAG, "sendJavascript: " + _d); + + if (gECB != null && gWebView != null) { + gWebView.sendJavascript(_d); + } + } + + /* + * Sends the pushbundle extras to the client application. + * If the client application isn't currently active, it is cached for later processing. + */ + public static void sendExtras(Bundle extras) + { + if (extras != null) { + if (gECB != null && gWebView != null) { + sendJavascript(convertBundleToJson(extras)); + } else { + Log.v(TAG, "sendExtras: caching extras to send at a later time."); + gCachedExtras = extras; + } + } + } + + /* + * serializes a bundle to JSON. + */ + private static JSONObject convertBundleToJson(Bundle extras) + { + try + { + JSONObject json; + json = new JSONObject().put("event", "message"); + + JSONObject jsondata = new JSONObject(); + Iterator it = extras.keySet().iterator(); + while (it.hasNext()) + { + String key = it.next(); + Object value = extras.get(key); + + // System data from Android + if (key.equals("from") || key.equals("collapse_key")) + { + json.put(key, value); + } + else if (key.equals("foreground")) + { + json.put(key, extras.getBoolean("foreground")); + } + else if (key.equals("coldstart")) + { + json.put(key, extras.getBoolean("coldstart")); + } + else + { + // Maintain backwards compatibility + if (key.equals("message") || key.equals("msgcnt") || key.equals("soundname")) + { + json.put(key, value); + } + + if ( value instanceof String ) { + // Try to figure out if the value is another JSON object + + String strValue = (String)value; + if (strValue.startsWith("{")) { + try { + JSONObject json2 = new JSONObject(strValue); + jsondata.put(key, json2); + } + catch (Exception e) { + jsondata.put(key, value); + } + // Try to figure out if the value is another JSON array + } + else if (strValue.startsWith("[")) + { + try + { + JSONArray json2 = new JSONArray(strValue); + jsondata.put(key, json2); + } + catch (Exception e) + { + jsondata.put(key, value); + } + } + else + { + jsondata.put(key, value); + } + } + } + } // while + json.put("payload", jsondata); + + Log.v(TAG, "extrasToJSON: " + json.toString()); + + return json; + } + catch( JSONException e) + { + Log.e(TAG, "extrasToJSON: JSON exception"); + } + return null; + } + + public static boolean isActive() + { + return gWebView != null; + } + + public void onDestroy() + { + GCMRegistrar.onDestroy(getApplicationContext()); + gWebView = null; + gECB = null; + super.onDestroy(); + } +} From 4c53bb3e706be7baa77a059e96e230f6e51d00c7 Mon Sep 17 00:00:00 2001 From: Ryan Willoughby Date: Mon, 10 Jun 2013 14:35:26 -0700 Subject: [PATCH 044/133] [1.3.2] upped version --- plugin.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/plugin.xml b/plugin.xml index 0d5e0f4b..a0daf0fb 100755 --- a/plugin.xml +++ b/plugin.xml @@ -2,7 +2,7 @@ + version="1.3.2"> PushPlugin From e7f8c81210e70afd8b9f92b60dada1b89907fd71 Mon Sep 17 00:00:00 2001 From: Bob Easterday Date: Tue, 18 Jun 2013 14:00:58 -0700 Subject: [PATCH 045/133] Add description tag --- plugin.xml | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/plugin.xml b/plugin.xml index a0daf0fb..4d9d1c29 100755 --- a/plugin.xml +++ b/plugin.xml @@ -2,9 +2,13 @@ + version="1.3.3"> PushPlugin + + + This plugin allows your application to receive push notifications on both Android and iOS devices. The Android implementation uses Google Cloud Messaging whereas the iOS version is based on Apple APNS Notifications + From b51d164a9216feeaca3852ec64d4335998073dc8 Mon Sep 17 00:00:00 2001 From: Florian Bachmann Date: Sun, 7 Jul 2013 19:28:37 +0200 Subject: [PATCH 046/133] made code more readable and better :-) --- src/ios/PushPlugin.m | 29 ++++++----------------------- 1 file changed, 6 insertions(+), 23 deletions(-) diff --git a/src/ios/PushPlugin.m b/src/ios/PushPlugin.m index 5ee569b0..406be8e0 100644 --- a/src/ios/PushPlugin.m +++ b/src/ios/PushPlugin.m @@ -128,31 +128,14 @@ - (void)didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken { // one is actually disabled. So we are literally checking to see if rnTypes matches what is turned on, instead of by number. The "tricky" part is that the // single notification types will only match if they are the ONLY one enabled. Likewise, when we are checking for a pair of notifications, it will only be // true if those two notifications are on. This is why the code is written this way - if(rntypes == UIRemoteNotificationTypeBadge){ - pushBadge = @"enabled"; + if(rntypes & UIRemoteNotificationTypeBadge){ + pushBadge = @"enabled"; } - else if(rntypes == UIRemoteNotificationTypeAlert){ - pushAlert = @"enabled"; + if(rntypes & UIRemoteNotificationTypeAlert) { + pushAlert = @"enabled"; } - else if(rntypes == UIRemoteNotificationTypeSound){ - pushSound = @"enabled"; - } - else if(rntypes == ( UIRemoteNotificationTypeBadge | UIRemoteNotificationTypeAlert)){ - pushBadge = @"enabled"; - pushAlert = @"enabled"; - } - else if(rntypes == ( UIRemoteNotificationTypeBadge | UIRemoteNotificationTypeSound)){ - pushBadge = @"enabled"; - pushSound = @"enabled"; - } - else if(rntypes == ( UIRemoteNotificationTypeAlert | UIRemoteNotificationTypeSound)){ - pushAlert = @"enabled"; - pushSound = @"enabled"; - } - else if(rntypes == ( UIRemoteNotificationTypeBadge | UIRemoteNotificationTypeAlert | UIRemoteNotificationTypeSound)){ - pushBadge = @"enabled"; - pushAlert = @"enabled"; - pushSound = @"enabled"; + if(rntypes & UIRemoteNotificationTypeSound) { + pushSound = @"enabled"; } [results setValue:pushBadge forKey:@"pushBadge"]; From 3a5229e94fdc0b335a8f350fe7bf7a8c441cd4d2 Mon Sep 17 00:00:00 2001 From: Brett Rudd Date: Tue, 9 Jul 2013 12:11:46 -0700 Subject: [PATCH 047/133] [plugin.xml] add license tag --- plugin.xml | 2 ++ 1 file changed, 2 insertions(+) diff --git a/plugin.xml b/plugin.xml index 4d9d1c29..fcb73323 100755 --- a/plugin.xml +++ b/plugin.xml @@ -10,6 +10,8 @@ This plugin allows your application to receive push notifications on both Android and iOS devices. The Android implementation uses Google Cloud Messaging whereas the iOS version is based on Apple APNS Notifications + MIT + From ed96570191f8a0471b6351dfbfbc34eb650ef3b3 Mon Sep 17 00:00:00 2001 From: Jason Farnsworth Date: Tue, 23 Jul 2013 00:57:15 -0700 Subject: [PATCH 048/133] Update plugin.xml --- plugin.xml | 41 ++++++++++++++++++++++------------------- 1 file changed, 22 insertions(+), 19 deletions(-) diff --git a/plugin.xml b/plugin.xml index fcb73323..212faf38 100755 --- a/plugin.xml +++ b/plugin.xml @@ -15,23 +15,26 @@ - + - - - + + + + + + - - - - - - - - - + + + + + + + + + @@ -56,13 +59,13 @@ - - - - - - + + + + + + From 2d17b4a4e87dd11beccbf0763fecb4e52fd3389c Mon Sep 17 00:00:00 2001 From: Jason Farnsworth Date: Tue, 23 Jul 2013 01:24:46 -0700 Subject: [PATCH 049/133] Clean up and formatting --- plugin.xml | 102 ++++++++++++++++++++++++++--------------------------- 1 file changed, 51 insertions(+), 51 deletions(-) diff --git a/plugin.xml b/plugin.xml index 212faf38..082b1109 100755 --- a/plugin.xml +++ b/plugin.xml @@ -1,11 +1,11 @@ + xmlns:android="http://schemas.android.com/apk/res/android" + id="com.adobe.plugins.PushPlugin" + version="1.3.3"> + + PushPlugin - PushPlugin - This plugin allows your application to receive push notifications on both Android and iOS devices. The Android implementation uses Google Cloud Messaging whereas the iOS version is based on Apple APNS Notifications @@ -14,38 +14,39 @@ - - - + + + + - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + - - - - - - - - + + + + + + + + @@ -53,25 +54,24 @@ - + - + - - - + + - - - - - - - - - - - + + + + + + + + + + + - + From 739476fa79aa24102fb58c7742305662e8aa2fe9 Mon Sep 17 00:00:00 2001 From: Jason Farnsworth Date: Tue, 23 Jul 2013 11:14:09 -0700 Subject: [PATCH 050/133] Updating java imports to work with the new Cordova 3.0 API --- src/android/com/plugin/gcm/PushPlugin.java | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/src/android/com/plugin/gcm/PushPlugin.java b/src/android/com/plugin/gcm/PushPlugin.java index 75b30fcc..fcdaf388 100644 --- a/src/android/com/plugin/gcm/PushPlugin.java +++ b/src/android/com/plugin/gcm/PushPlugin.java @@ -11,8 +11,8 @@ import android.util.Log; import org.apache.cordova.CordovaWebView; -import org.apache.cordova.api.CallbackContext; -import org.apache.cordova.api.CordovaPlugin; +import org.apache.cordova.CallbackContext; +import org.apache.cordova.CordovaPlugin; import com.google.android.gcm.*; From fe01c16612b03d983644df9d908fc3ef2ef256a5 Mon Sep 17 00:00:00 2001 From: Jason Farnsworth Date: Tue, 23 Jul 2013 13:25:33 -0700 Subject: [PATCH 051/133] Updating iOS PushPlugin for ARC builds (cordova-cli 3.0 default configuration) --- src/ios/AppDelegate+notification.m | 1 - src/ios/PushPlugin.h | 2 +- src/ios/PushPlugin.m | 8 -------- 3 files changed, 1 insertion(+), 10 deletions(-) diff --git a/src/ios/AppDelegate+notification.m b/src/ios/AppDelegate+notification.m index 2ad5a271..5859f191 100644 --- a/src/ios/AppDelegate+notification.m +++ b/src/ios/AppDelegate+notification.m @@ -113,7 +113,6 @@ - (void)setLaunchNotification:(NSDictionary *)aDictionary - (void)dealloc { self.launchNotification = nil; // clear the association and release the object - [super dealloc]; } @end diff --git a/src/ios/PushPlugin.h b/src/ios/PushPlugin.h index 9d7e4763..fdf65d3b 100644 --- a/src/ios/PushPlugin.h +++ b/src/ios/PushPlugin.h @@ -40,7 +40,7 @@ @property (nonatomic, copy) NSString *notificationCallbackId; @property (nonatomic, copy) NSString *callback; -@property (nonatomic, retain) NSDictionary *notificationMessage; +@property (nonatomic, strong) NSDictionary *notificationMessage; @property BOOL isInline; - (void)register:(NSMutableArray *)arguments withDict:(NSMutableDictionary *)options; diff --git a/src/ios/PushPlugin.m b/src/ios/PushPlugin.m index 5ee569b0..35c981b5 100644 --- a/src/ios/PushPlugin.m +++ b/src/ios/PushPlugin.m @@ -34,14 +34,6 @@ @implementation PushPlugin @synthesize notificationCallbackId; @synthesize callback; -- (void)dealloc -{ - [notificationMessage release]; - self.notificationCallbackId = nil; - self.callback = nil; - - [super dealloc]; -} - (void)unregister:(NSMutableArray *)arguments withDict:(NSMutableDictionary *)options { From a359fa588a164faeba29ba2af50140e1f0a9d4e3 Mon Sep 17 00:00:00 2001 From: Jason Farnsworth Date: Wed, 24 Jul 2013 15:40:39 -0700 Subject: [PATCH 052/133] Getting the plugin to register on iOS in a Cordova 3.0 environment The signature of all the methods callable from JavaScript had to change from: -- (void)register:(NSMutableArray *)arguments withDict:(NSMutableDictionary *)options; to +- (void)register:(CDVInvokedUrlCommand*)command; The old format was officially obsoleted in in Cordova 3.0, so there is no way around using the old one. 'arguments' and 'options' needed to use the new 'command' object. With this new format the plugin result interface was also broken, so it was changed to the new documented format. This code is _not_ well tested at this point, but I wanted to get it up for anyone having issues migrating to 3.0. --- src/ios/PushPlugin.h | 3 ++- src/ios/PushPlugin.m | 16 ++++++++++------ 2 files changed, 12 insertions(+), 7 deletions(-) diff --git a/src/ios/PushPlugin.h b/src/ios/PushPlugin.h index fdf65d3b..7e7ba4bc 100644 --- a/src/ios/PushPlugin.h +++ b/src/ios/PushPlugin.h @@ -25,6 +25,7 @@ #import #import +#import @interface PushPlugin : CDVPlugin { @@ -43,7 +44,7 @@ @property (nonatomic, strong) NSDictionary *notificationMessage; @property BOOL isInline; -- (void)register:(NSMutableArray *)arguments withDict:(NSMutableDictionary *)options; +- (void)register:(CDVInvokedUrlCommand*)command; - (void)didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken; - (void)didFailToRegisterForRemoteNotificationsWithError:(NSError *)error; diff --git a/src/ios/PushPlugin.m b/src/ios/PushPlugin.m index 35c981b5..05564ca6 100644 --- a/src/ios/PushPlugin.m +++ b/src/ios/PushPlugin.m @@ -35,17 +35,19 @@ @implementation PushPlugin @synthesize callback; -- (void)unregister:(NSMutableArray *)arguments withDict:(NSMutableDictionary *)options +- (void)unregister:(CDVInvokedUrlCommand*)command; { - self.callbackId = [arguments pop]; + self.callbackId = command.callbackId; [[UIApplication sharedApplication] unregisterForRemoteNotifications]; [self successWithMessage:@"unregistered"]; } -- (void)register:(NSMutableArray *)arguments withDict:(NSMutableDictionary *)options +- (void)register:(CDVInvokedUrlCommand*)command; { - self.callbackId = [arguments pop]; + self.callbackId = command.callbackId; + + NSMutableDictionary* options = [command.arguments objectAtIndex:0]; UIRemoteNotificationType notificationTypes = UIRemoteNotificationTypeNone; id badgeArg = [options objectForKey:@"badge"]; @@ -89,11 +91,13 @@ - (void)register:(NSMutableArray *)arguments withDict:(NSMutableDictionary *)opt [self notificationReceived]; // go ahead and process it } +/* - (void)isEnabled:(NSMutableArray *)arguments withDict:(NSMutableDictionary *)options { UIRemoteNotificationType type = [[UIApplication sharedApplication] enabledRemoteNotificationTypes]; NSString *jsStatement = [NSString stringWithFormat:@"navigator.PushPlugin.isEnabled = %d;", type != UIRemoteNotificationTypeNone]; NSLog(@"JSStatement %@",jsStatement); } +*/ - (void)didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken { @@ -226,7 +230,7 @@ -(void)successWithMessage:(NSString *)message { CDVPluginResult *commandResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsString:message]; - [self writeJavascript:[commandResult toSuccessCallbackString:self.callbackId]]; + [self.commandDelegate sendPluginResult:commandResult callbackId:self.callbackId]; } -(void)failWithMessage:(NSString *)message withError:(NSError *)error @@ -234,7 +238,7 @@ -(void)failWithMessage:(NSString *)message withError:(NSError *)error NSString *errorMessage = (error) ? [NSString stringWithFormat:@"%@ - %@", message, [error localizedDescription]] : message; CDVPluginResult *commandResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR messageAsString:errorMessage]; - [self writeJavascript:[commandResult toErrorCallbackString:self.callbackId]]; + [self.commandDelegate sendPluginResult:commandResult callbackId:self.callbackId]; } @end From b5640c6afdb195a6ace2dcc5a8f8391fd1be3649 Mon Sep 17 00:00:00 2001 From: "Robert (Jamie) Munro" Date: Fri, 23 Aug 2013 12:34:35 +0100 Subject: [PATCH 053/133] Fix typo: successCallback should be errorCallback Fix setApplicationIconBadgeNumber returning errors. --- www/PushNotification.js | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/www/PushNotification.js b/www/PushNotification.js index a080e998..aad81ad6 100644 --- a/www/PushNotification.js +++ b/www/PushNotification.js @@ -1,4 +1,3 @@ - var PushNotification = function() { }; @@ -52,7 +51,7 @@ PushNotification.prototype.setApplicationIconBadgeNumber = function(successCallb return } - cordova.exec(successCallback, successCallback, "PushPlugin", "setApplicationIconBadgeNumber", [{badge: badge}]); + cordova.exec(successCallback, errorCallback, "PushPlugin", "setApplicationIconBadgeNumber", [{badge: badge}]); }; //------------------------------------------------------------------- From 669c15f3b3d2c2af23b7abf0f62bb8bb7c96e0af Mon Sep 17 00:00:00 2001 From: Bob Easterday Date: Mon, 9 Sep 2013 08:50:56 -0700 Subject: [PATCH 054/133] Restrict current version of plugin to PG < 3.0 --- plugin.xml | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/plugin.xml b/plugin.xml index fcb73323..9fe64037 100755 --- a/plugin.xml +++ b/plugin.xml @@ -2,7 +2,7 @@ + version="1.3.4"> PushPlugin @@ -15,7 +15,8 @@ - + + From d91f7a2fa4a575a0ca0633573316d6552fc20ed4 Mon Sep 17 00:00:00 2001 From: Bob Easterday Date: Mon, 9 Sep 2013 09:29:01 -0700 Subject: [PATCH 055/133] remove trailing tab --- plugin.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/plugin.xml b/plugin.xml index 9fe64037..38a5bb83 100755 --- a/plugin.xml +++ b/plugin.xml @@ -17,7 +17,7 @@ - + From dc033386e4a98c02ffb280a71a41e340083e3eaa Mon Sep 17 00:00:00 2001 From: Bob Easterday Date: Mon, 9 Sep 2013 09:35:39 -0700 Subject: [PATCH 056/133] Add author element --- plugin.xml | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/plugin.xml b/plugin.xml index 38a5bb83..be426bb9 100755 --- a/plugin.xml +++ b/plugin.xml @@ -5,7 +5,8 @@ version="1.3.4"> PushPlugin - + Bob Easterday + This plugin allows your application to receive push notifications on both Android and iOS devices. The Android implementation uses Google Cloud Messaging whereas the iOS version is based on Apple APNS Notifications From 1660c4eeacc686ba64340e28864a194d85c0eaa5 Mon Sep 17 00:00:00 2001 From: Bob Easterday Date: Mon, 9 Sep 2013 10:22:31 -0700 Subject: [PATCH 057/133] Escape < and > in engines element --- plugin.xml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/plugin.xml b/plugin.xml index be426bb9..b18c311d 100755 --- a/plugin.xml +++ b/plugin.xml @@ -16,8 +16,8 @@ - - + + From 9beb8b2f57bc5454c3b5e98dbb8bd73acb953b65 Mon Sep 17 00:00:00 2001 From: Bob Easterday Date: Mon, 9 Sep 2013 11:06:30 -0700 Subject: [PATCH 058/133] Use canonical namespace prefix for plugin id --- plugin.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/plugin.xml b/plugin.xml index b18c311d..e06d9255 100755 --- a/plugin.xml +++ b/plugin.xml @@ -1,7 +1,7 @@ PushPlugin From 4dd9684621aba2b1e130aeaeb770bdabfc13ea07 Mon Sep 17 00:00:00 2001 From: Bob Easterday Date: Mon, 9 Sep 2013 16:21:16 -0700 Subject: [PATCH 059/133] Make fuzzy version matching a little less fuzzy --- plugin.xml | 1 - 1 file changed, 1 deletion(-) diff --git a/plugin.xml b/plugin.xml index e06d9255..74c4275a 100755 --- a/plugin.xml +++ b/plugin.xml @@ -16,7 +16,6 @@ - From ad19c709d2b0720d1b3f2ba837a62cde2ed9c4d6 Mon Sep 17 00:00:00 2001 From: Bob Easterday Date: Mon, 9 Sep 2013 16:27:20 -0700 Subject: [PATCH 060/133] Bump version to 1.3.5 --- plugin.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/plugin.xml b/plugin.xml index 74c4275a..67a30a8d 100755 --- a/plugin.xml +++ b/plugin.xml @@ -2,7 +2,7 @@ + version="1.3.5"> PushPlugin Bob Easterday From 99050b9c68e97a8104404fb84fe9345b83fad5e8 Mon Sep 17 00:00:00 2001 From: Bob Easterday Date: Tue, 10 Sep 2013 09:17:16 -0700 Subject: [PATCH 061/133] Try with explicit version matching --- plugin.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/plugin.xml b/plugin.xml index 67a30a8d..de8c47d8 100755 --- a/plugin.xml +++ b/plugin.xml @@ -16,7 +16,7 @@ - + From 8b23e047aa241f9373f8ae71357a6c6cb186d198 Mon Sep 17 00:00:00 2001 From: Bob Easterday Date: Tue, 10 Sep 2013 09:25:00 -0700 Subject: [PATCH 062/133] bump version plugin submission requires a version bump even if plugin was previously deleted (bug?) --- plugin.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/plugin.xml b/plugin.xml index de8c47d8..c75e4e64 100755 --- a/plugin.xml +++ b/plugin.xml @@ -2,7 +2,7 @@ + version="1.3.6"> PushPlugin Bob Easterday From 406d1389dae840436d0fc9b291a16f1ad52a2229 Mon Sep 17 00:00:00 2001 From: Bob Easterday Date: Tue, 10 Sep 2013 10:39:55 -0700 Subject: [PATCH 063/133] Return of fuzzy version matching --- plugin.xml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/plugin.xml b/plugin.xml index c75e4e64..23168935 100755 --- a/plugin.xml +++ b/plugin.xml @@ -2,7 +2,7 @@ + version="1.3.7"> PushPlugin Bob Easterday @@ -16,7 +16,7 @@ - + From 7a5d5fb4c046c5ead56f6d2bf68a90d0fbade741 Mon Sep 17 00:00:00 2001 From: Bob Easterday Date: Tue, 10 Sep 2013 11:35:19 -0700 Subject: [PATCH 064/133] Update the readme with new domain prefix and correct plugman instructions --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index be6547e1..beda22cc 100644 --- a/README.md +++ b/README.md @@ -99,7 +99,7 @@ Copy the following files to your project's Plugins folder: Add a reference for this plugin to the plugins section in **config.xml**: - + Add the **PushNotification.js** script to your assets/www folder (or javascripts folder, wherever you want really) and reference it in your main index.html file. @@ -110,7 +110,7 @@ Add the **PushNotification.js** script to your assets/www folder (or javascripts This plugin is based on [plugman](https://github.com/apache/cordova-plugman). to install it to your app, simply execute plugman as follows; - plugman --platform [PLATFORM] --project [TARGET-PATH] --plugin [PLUGIN-PATH] + plugman install --platform [PLATFORM] --project [TARGET-PATH] --plugin [PLUGIN-PATH] where [PLATFORM] = ios or android From 91e787817219b789ece5e25fe2dd67e9c81efd6b Mon Sep 17 00:00:00 2001 From: Bob Easterday Date: Tue, 10 Sep 2013 14:35:05 -0700 Subject: [PATCH 065/133] Bump version after some miner pull requests --- plugin.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/plugin.xml b/plugin.xml index d8579fd6..6bd9d925 100755 --- a/plugin.xml +++ b/plugin.xml @@ -2,7 +2,7 @@ + version="2.0.1"> PushPlugin Bob Easterday From 9f6465dcd5ab6ddf543c145de8bd4493a8b33589 Mon Sep 17 00:00:00 2001 From: "Robert (Jamie) Munro" Date: Tue, 10 Sep 2013 15:20:09 +0100 Subject: [PATCH 066/133] Eliminate need for GET_TASKS permission * Don't check if we are in the foreground - that happens anyway in the sendExtras() method (https://github.com/phonegap-build/PushPlugin/blob/master/src/android/com/plugin/gcm/PushPlugin.java#L111) * Only display a message if the message has text to be displayed Fixes #52 and undoes #3 --- README.md | 1 - plugin.xml | 1 - .../com/plugin/gcm/GCMIntentService.java | 22 ++++--------------- 3 files changed, 4 insertions(+), 20 deletions(-) diff --git a/README.md b/README.md index beda22cc..533950b8 100644 --- a/README.md +++ b/README.md @@ -59,7 +59,6 @@ This plugin is for use with [Cordova](http://incubator.apache.org/cordova/), and 2) Modify your **AndroidManifest.xml** and add the following lines to your manifest tag: - diff --git a/plugin.xml b/plugin.xml index 6bd9d925..4d3678d8 100755 --- a/plugin.xml +++ b/plugin.xml @@ -29,7 +29,6 @@ - diff --git a/src/android/com/plugin/gcm/GCMIntentService.java b/src/android/com/plugin/gcm/GCMIntentService.java index 9a46aa4a..9ea6748b 100644 --- a/src/android/com/plugin/gcm/GCMIntentService.java +++ b/src/android/com/plugin/gcm/GCMIntentService.java @@ -69,14 +69,12 @@ protected void onMessage(Context context, Intent intent) { Bundle extras = intent.getExtras(); if (extras != null) { - boolean foreground = this.isInForeground(); + PushPlugin.sendExtras(extras); - extras.putBoolean("foreground", foreground); - - if (foreground) - PushPlugin.sendExtras(extras); - else + // Send a notification if there is a message + if (extras.getString("message").length() != 0) { createNotification(context, extras); + } } } @@ -143,18 +141,6 @@ private static String getAppName(Context context) return (String)appName; } - public boolean isInForeground() - { - ActivityManager activityManager = (ActivityManager) getApplicationContext().getSystemService(Context.ACTIVITY_SERVICE); - List services = activityManager - .getRunningTasks(Integer.MAX_VALUE); - - if (services.get(0).topActivity.getPackageName().toString().equalsIgnoreCase(getApplicationContext().getPackageName().toString())) - return true; - - return false; - } - @Override public void onError(Context context, String errorId) { Log.e(TAG, "onError - errorId: " + errorId); From 9a89ce8ec3e68811d7131c76a93ea29489b4128b Mon Sep 17 00:00:00 2001 From: Sergio Morstabilini Date: Fri, 13 Sep 2013 16:47:16 +0200 Subject: [PATCH 067/133] added a missing comma after errorHanlder --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index beda22cc..134b40ae 100644 --- a/README.md +++ b/README.md @@ -140,9 +140,9 @@ For Android, If you have not already done so, you'll need to set up a Google API In this example, be sure and substitute your own senderID. Get your senderID by signing into to your [google dashboard](https://code.google.com/apis/console/). The senderID is found at **Overview->Dashboard->Project Number**. if (device.platform == 'android' || device.platform == 'Android') { - pushNotification.register(successHandler, errorHandler,{"senderID":"replace_with_sender_id","ecb":"onNotificationGCM"}); + pushNotification.register(successHandler, errorHandler, {"senderID":"replace_with_sender_id", "ecb":"onNotificationGCM"}); } else { - pushNotification.register(tokenHandler, errorHandler {"badge":"true","sound":"true","alert":"true","ecb":"onNotificationAPN"}); + pushNotification.register(tokenHandler, errorHandler, {"badge":"true", "sound":"true", "alert":"true", "ecb":"onNotificationAPN"}); } **successHandler** - called when a plugin method returns without error From 3a400752c583ce8e3f85b35c376946b2d10ad4fb Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Rub=C3=A9n=20Norte?= Date: Tue, 24 Sep 2013 15:20:37 +0200 Subject: [PATCH 068/133] Fixes Cordova error when trying to open the app from the notification bar. --- src/android/com/plugin/gcm/PushHandlerActivity.java | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/src/android/com/plugin/gcm/PushHandlerActivity.java b/src/android/com/plugin/gcm/PushHandlerActivity.java index 73846fb0..0c051f84 100644 --- a/src/android/com/plugin/gcm/PushHandlerActivity.java +++ b/src/android/com/plugin/gcm/PushHandlerActivity.java @@ -22,15 +22,16 @@ public void onCreate(Bundle savedInstanceState) super.onCreate(savedInstanceState); Log.v(TAG, "onCreate"); - boolean isPushPluginActive = PushPlugin.isActive(); - if (!isPushPluginActive) { - forceMainActivityReload(); - } + boolean isPushPluginActive = PushPlugin.isActive(); processPushBundle(isPushPluginActive); GCMIntentService.cancelNotification(this); finish(); + + if (!isPushPluginActive) { + forceMainActivityReload(); + } } /** From 82606aca656f96546fcb0d617561cf98e90e86bf Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Rub=C3=A9n=20Norte?= Date: Tue, 24 Sep 2013 16:45:10 +0200 Subject: [PATCH 069/133] Sets default notification sound, vibration and lights and removes useless method. --- .../com/plugin/gcm/GCMIntentService.java | 26 +++++-------------- 1 file changed, 6 insertions(+), 20 deletions(-) diff --git a/src/android/com/plugin/gcm/GCMIntentService.java b/src/android/com/plugin/gcm/GCMIntentService.java index 9a46aa4a..95f0124d 100644 --- a/src/android/com/plugin/gcm/GCMIntentService.java +++ b/src/android/com/plugin/gcm/GCMIntentService.java @@ -9,13 +9,11 @@ import android.annotation.SuppressLint; import android.app.ActivityManager; import android.app.ActivityManager.RunningTaskInfo; +import android.app.Notification; import android.app.NotificationManager; import android.app.PendingIntent; import android.content.Context; import android.content.Intent; -import android.media.Ringtone; -import android.media.RingtoneManager; -import android.net.Uri; import android.os.Bundle; import android.support.v4.app.NotificationCompat; import android.util.Log; @@ -89,10 +87,11 @@ public void createNotification(Context context, Bundle extras) notificationIntent.addFlags(Intent.FLAG_ACTIVITY_SINGLE_TOP | Intent.FLAG_ACTIVITY_CLEAR_TOP); notificationIntent.putExtra("pushBundle", extras); - PendingIntent contentIntent = PendingIntent.getActivity(this, 0, notificationIntent, PendingIntent.FLAG_UPDATE_CURRENT); - - NotificationCompat.Builder mBuilder = + PendingIntent contentIntent = PendingIntent.getActivity(this, 0, notificationIntent, PendingIntent.FLAG_UPDATE_CURRENT); + + NotificationCompat.Builder mBuilder = new NotificationCompat.Builder(context) + .setDefaults(Notification.DEFAULT_ALL) .setSmallIcon(context.getApplicationInfo().icon) .setWhen(System.currentTimeMillis()) .setContentTitle(appName) @@ -110,21 +109,8 @@ public void createNotification(Context context, Bundle extras) if (msgcnt != null) { mBuilder.setNumber(Integer.parseInt(msgcnt)); } - + mNotificationManager.notify((String) appName, NOTIFICATION_ID, mBuilder.build()); - tryPlayRingtone(); - } - - private void tryPlayRingtone() - { - try { - Uri notification = RingtoneManager.getDefaultUri(RingtoneManager.TYPE_NOTIFICATION); - Ringtone r = RingtoneManager.getRingtone(getApplicationContext(), notification); - r.play(); - } - catch (Exception e) { - Log.e(TAG, "failed to play notification ringtone"); - } } public static void cancelNotification(Context context) From a7a47ee910d70569638f23819badc30e0a6204c3 Mon Sep 17 00:00:00 2001 From: Armno Date: Thu, 26 Sep 2013 12:31:50 +0700 Subject: [PATCH 070/133] enable syntax highlighting for code examples --- README.md | 384 +++++++++++++++++++++++++++++++----------------------- 1 file changed, 220 insertions(+), 164 deletions(-) diff --git a/README.md b/README.md index 901c8c03..aac91c7c 100644 --- a/README.md +++ b/README.md @@ -11,20 +11,20 @@ This plugin is for use with [Cordova](http://incubator.apache.org/cordova/), and ## LICENSE The MIT License - + Copyright (c) 2012 Adobe Systems, inc. portions Copyright (c) 2012 Olivier Louvignes - + Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: - + The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. - + THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE @@ -36,7 +36,7 @@ This plugin is for use with [Cordova](http://incubator.apache.org/cordova/), and ## Manual Installation for Android -1) copy the contents of **src/android/com/** to your project's **src/com/** folder. +1) copy the contents of **src/android/com/** to your project's **src/com/** folder. copy the contents of **libs/** to your **libs/** folder. The final hirearchy will likely look something like this; @@ -52,69 +52,83 @@ This plugin is for use with [Cordova](http://incubator.apache.org/cordova/), and CordovaGCMBroadcastReceiver.java GCMIntentService.java PushHandlerActivity.java - PushPlugin.java + PushPlugin.java {company_name} {intent_name} - {intent_name}.java + {intent_name}.java 2) Modify your **AndroidManifest.xml** and add the following lines to your manifest tag: - - - - - - - +```xml + + + + + + +``` 3) Modify your **AndroidManifest.xml** and add the following **activity**, **receiver** and **service** tags to your **application** section. (See the Sample_AndroidManifest.xml file in the Example folder.) - - - - - - - - - +```xml + + + + + + + + + +``` 4) Modify your **res/xml/config.xml** to include the following line in order to tell Cordova to include this plugin and where it can be found: (See the Sample_config.xml file in the Example folder) - +```xml + +``` 5) Add the **PushNotification.js** script to your assets/www folder (or javascripts folder, wherever you want really) and reference it in your main index.html file. This file's usage is described in the **Plugin API** section below. - +```html + +``` ## Manual Installation for iOS Copy the following files to your project's Plugins folder: - AppDelegate+notification.h - AppDelegate+notification.m - PushPlugin.h - PushPlugin.m - -Add a reference for this plugin to the plugins section in **config.xml**: +``` +AppDelegate+notification.h +AppDelegate+notification.m +PushPlugin.h +PushPlugin.m +``` - +Add a reference for this plugin to the plugins section in **config.xml**: +```xml + +``` Add the **PushNotification.js** script to your assets/www folder (or javascripts folder, wherever you want really) and reference it in your main index.html file. - +```html + +``` ## Automatic Installation This plugin is based on [plugman](https://github.com/apache/cordova-plugman). to install it to your app, simply execute plugman as follows; - plugman install --platform [PLATFORM] --project [TARGET-PATH] --plugin [PLUGIN-PATH] - - where - [PLATFORM] = ios or android - [TARGET-PATH] = path to folder containing your phonegap project - [PLUGIN-PATH] = path to folder containing this plugin +```sh +plugman install --platform [PLATFORM] --project [TARGET-PATH] --plugin [PLUGIN-PATH] + +where + [PLATFORM] = ios or android + [TARGET-PATH] = path to folder containing your phonegap project + [PLUGIN-PATH] = path to folder containing this plugin +``` For additional info, take a look at the [Plugman Documentation](https://github.com/apache/cordova-plugman/blob/master/README.md) @@ -124,12 +138,16 @@ In the Examples folder you will find a sample implementation showing how to inte First create the plugin instance variable. - var pushNotification; - +```js +var pushNotification; +``` + When deviceReady fires, get the plugin reference - pushNotification = window.plugins.pushNotification; - +```js +pushNotification = window.plugins.pushNotification; +``` + #### register This should be called as soon as the device becomes ready. On success, you will get a call to tokenHandler (iOS), or onNotificationGCM (Android), allowing you to obtain the device token or registration ID, respectively. Those values will typically get posted to your intermediary push server so it knows who it can send notifications to. @@ -138,152 +156,190 @@ For Android, If you have not already done so, you'll need to set up a Google API In this example, be sure and substitute your own senderID. Get your senderID by signing into to your [google dashboard](https://code.google.com/apis/console/). The senderID is found at **Overview->Dashboard->Project Number**. - if (device.platform == 'android' || device.platform == 'Android') { - pushNotification.register(successHandler, errorHandler, {"senderID":"replace_with_sender_id", "ecb":"onNotificationGCM"}); - } else { - pushNotification.register(tokenHandler, errorHandler, {"badge":"true", "sound":"true", "alert":"true", "ecb":"onNotificationAPN"}); - } +```js +if ( device.platform == 'android' || device.platform == 'Android' ) +{ + pushNotification.register( + successHandler, + errorHandler, { + "senderID":"replace_with_sender_id", + "ecb":"onNotificationGCM" + }); +} +else +{ + pushNotification.register( + tokenHandler, + errorHandler, { + "badge":"true", + "sound":"true", + "alert":"true", + "ecb":"onNotificationAPN" + }); +} +``` **successHandler** - called when a plugin method returns without error - // result contains any message sent from the plugin call - function successHandler (result) { - alert('result = '+result) - } - +```js +// result contains any message sent from the plugin call +function successHandler (result) { + alert('result = ' + result); +} +``` + **errorHandler** - called when the plugin returns an error - // result contains any error description text returned from the plugin call - function errorHandler (error) { - alert('error = '+error) - } - +```js +// result contains any error description text returned from the plugin call +function errorHandler (error) { + alert('error = ' + error); +} +``` + **tokenHandler (iOS ony)** - called when the device has registeredwith a unique device token. - function tokenHandler (result) { - // Your iOS push server needs to know the token before it can push to this device - // here is where you might want to send it the token for later use. - alert('device token = '+result) - } +```js +function tokenHandler (result) { + // Your iOS push server needs to know the token before it can push to this device + // here is where you might want to send it the token for later use. + alert('device token = ' + result); +} +``` **senderID (Android only)** - This is the Google project ID you need to obtain by [registering your application](http://developer.android.com/guide/google/gcm/gs.html) for GCM **ecb** - event callback that gets called when your device receives a notification - - // iOS - function onNotificationAPN(event) { - if (event.alert) { - navigator.notification.alert(event.alert); + +```js +// iOS +function onNotificationAPN (event) { + if ( event.alert ) + { + navigator.notification.alert(event.alert); + } + + if ( event.sound ) + { + var snd = new Media(event.sound); + snd.play(); + } + + if ( event.badge ) + { + pushNotification.setApplicationIconBadgeNumber(successHandler, errorHandler, event.badge); + } +} + +// Android +function onNotificationGCM(e) { + $("#app-status-ul").append('

  • EVENT -> RECEIVED:' + e.event + '
    • '); + + switch( e.event ) + { + case 'registered': + if ( e.regid.length > 0 ) + { + $("#app-status-ul").append('
  • REGISTERED -> REGID:' + e.regid + "
    • "); + // Your GCM push server needs to know the regID before it can push to this device + // here is where you might want to send it the regID for later use. + console.log("regID = " + e.regID); } - - if (event.sound) { - var snd = new Media(event.sound); - snd.play(); + break; + + case 'message': + // if this flag is set, this notification happened while we were in the foreground. + // you might want to play a sound to get the user's attention, throw up a dialog, etc. + if ( e.foreground ) + { + $("#app-status-ul").append('
  • --INLINE NOTIFICATION--' + '
    • '); + + // if the notification contains a soundname, play it. + var my_media = new Media("/android_asset/www/"+e.soundname); + my_media.play(); } - - if (event.badge) { - pushNotification.setApplicationIconBadgeNumber(successHandler, errorHandler, event.badge); + else + { // otherwise we were launched because the user touched a notification in the notification tray. + if ( e.coldstart ) + { + $("#app-status-ul").append('
  • --COLDSTART NOTIFICATION--' + '
    • '); + } + else + { + $("#app-status-ul").append('
  • --BACKGROUND NOTIFICATION--' + '
    • '); + } } - } + $("#app-status-ul").append('
  • MESSAGE -> MSG: ' + e.payload.message + '
    • '); + $("#app-status-ul").append('
  • MESSAGE -> MSGCNT: ' + e.payload.msgcnt + '
    • '); + break; + + case 'error': + $("#app-status-ul").append('
  • ERROR -> MSG:' + e.msg + '
    • '); + break; + + default: + $("#app-status-ul").append('
  • EVENT -> Unknown, an event was received and we do not know what it is
    • '); + break; + } +} +``` - // Android - function onNotificationGCM(e) { - $("#app-status-ul").append('
  • EVENT -> RECEIVED:' + e.event + '
    • '); - - switch( e.event ) - { - case 'registered': - if ( e.regid.length > 0 ) - { - $("#app-status-ul").append('
  • REGISTERED -> REGID:' + e.regid + "
    • "); - // Your GCM push server needs to know the regID before it can push to this device - // here is where you might want to send it the regID for later use. - console.log("regID = " + e.regID); - } - break; - - case 'message': - // if this flag is set, this notification happened while we were in the foreground. - // you might want to play a sound to get the user's attention, throw up a dialog, etc. - if (e.foreground) - { - $("#app-status-ul").append('
  • --INLINE NOTIFICATION--' + '
    • '); - - // if the notification contains a soundname, play it. - var my_media = new Media("/android_asset/www/"+e.soundname); - my_media.play(); - } - else - { // otherwise we were launched because the user touched a notification in the notification tray. - if (e.coldstart) - $("#app-status-ul").append('
  • --COLDSTART NOTIFICATION--' + '
    • '); - else - $("#app-status-ul").append('
  • --BACKGROUND NOTIFICATION--' + '
    • '); - } - - $("#app-status-ul").append('
  • MESSAGE -> MSG: ' + e.payload.message + '
    • '); - $("#app-status-ul").append('
  • MESSAGE -> MSGCNT: ' + e.payload.msgcnt + '
    • '); - break; - - case 'error': - $("#app-status-ul").append('
  • ERROR -> MSG:' + e.msg + '
    • '); - break; - - default: - $("#app-status-ul").append('
  • EVENT -> Unknown, an event was received and we do not know what it is
    • '); - break; - } - } - Looking at the above message handling code for Android, a few things bear explaination. Your app may receive a notification while it is active (INLINE). If you background the app by hitting the Home button on your device, you may later receive a status bar notification. Selecting that notification from the status will bring your app to the front and allow you to process the notification (BACKGROUND). Finally, should you completely exit the app by hitting the back button from the home page, you may still receive a notification. Touching that notification in the notification tray will relaunch your app and allow you to process the notification (COLDSTART). In this case the **coldstart** flag will be set on the incoming event. You can look at the **foreground** flag on the event to determine whether you are processing a background or an in-line notification. You may choose, for example to play a sound or show a dialog only for inline or coldstart notifications since the user has already been alerted via the status bar. Also make note of the **payload** object. Since the Android notification data model is much more flexible than that of iOS, there may be additional elements beyond **message**, **soundname**, and **msgcnt**. You can access those elements and any additional ones via the **payload** element. This means that if your data model should change in the future, there will be no need to change and recompile the plugin. - + #### unregister You will typically call this when your app is exiting, to cleanup any used resources. Its not strictly necessary to call it, and indeed it may be desireable to NOT call it if you are debugging your intermediarry push server. When you call unregister(), the current token for a particular device will get invalidated, and the next call to register() will return a new token. If you do NOT call unregister(), the last token will remain in effect until it is invalidated for some reason at the GCM side. Since such invalidations are beyond your control, its recommended that, in a production environment, that you have a matching unregister() call, for every call to register(), and that your server updates the devices' records each time. - pushNotification.unregister(successHandler, errorHandler); - +```js +pushNotification.unregister(successHandler, errorHandler); +``` + You'll probably want to trap on the **backbutton** event and only call this when the home page is showing. Remember, the back button on android is not the same as the Home button. When you hit the back button from the home page, your activity gets dismissed. Here is an example of how to trap the backbutton event; - function onDeviceReady() { - $("#app-status-ul").append('
  • deviceready event received
    • '); - - document.addEventListener("backbutton", function(e) +```js +function onDeviceReady() { + $("#app-status-ul").append('
  • deviceready event received
    • '); + + document.addEventListener("backbutton", function(e) + { + $("#app-status-ul").append('
  • backbutton event received
    • '); + + if( $("#home").length > 0 ) { - $("#app-status-ul").append('
  • backbutton event received
    • '); - - if( $("#home").length > 0) - { - e.preventDefault(); - pushNotification.unregister(successHandler, errorHandler); - navigator.app.exitApp(); - } - else - { - navigator.app.backHistory(); - } - }, false); - - // aditional onDeviceReady work… - } + e.preventDefault(); + pushNotification.unregister(successHandler, errorHandler); + navigator.app.exitApp(); + } + else + { + navigator.app.backHistory(); + } + }, false); + + // aditional onDeviceReady work… +} +``` + For the above to work, make sure the content for your home page is wrapped in an element with an id of home, like this; -
    -
    -
      -
    • Cordova PushNotification Plugin Demo
      • -
    -
    +```html +
    +
    +
      +
    • Cordova PushNotification Plugin Demo
      • +
    +
    +``` - - #### setApplicationIconBadgeNumber (iOS only) set the badge count visible when the app is not running - - pushNotification.setApplicationIconBadgeNumber(successCallback, errorCallback, badgeCount); + +```js +pushNotification.setApplicationIconBadgeNumber(successCallback, errorCallback, badgeCount); +``` **badgeCount** - an integer indicating what number should show up in the badge. Passing 0 will clear the badge. @@ -294,7 +350,7 @@ The notification system consists of several interdependent components. 1) The client application which runs on a device and receives notifications. 2) The notification service provider (APNS for Apple, GCM for Google) 3) Intermediary servers that collect device IDs from clients and push notifications through APNS and/or GCM. - + This plugin and its target Cordova application comprise the client application.The APNS and GCM infrastructure are maintained by Apple and Google, respectively. In order to send push notifications to your users, you would typically run an intermediary server or employ a 3rd party push service. This is true for both GCM (Android) and APNS (iOS) notifications. However, when testing the notification client applications, it may be desirable to be able to push notifications directly from your desktop, without having to design and build those server's first. There are a number of solutions out there to allow you to push from a desktop machine, sans server. The easiest I've found to work with is a ruby gem called [pushmeup](http://rubygems.org/gems/pushmeup). I've only tried this on Mac, but it probably works fine on Windows as well. Here's a rough outline; **Prerequisites**. @@ -304,24 +360,24 @@ This plugin and its target Cordova application comprise the client application.T - You have successfully built a client with this plugin, on both iOS and Android and have installed them on a device. -#### 1) [Get the gem](https://github.com/NicosKaralis/pushmeup) +#### 1) [Get the gem](https://github.com/NicosKaralis/pushmeup) $ sudo gem install pushmeup - + #### 2) (iOS) [Follow this tutorial](http://www.raywenderlich.com/3443/apple-push-notification-services-tutorial-part-12) to create a file called ck.pem. Start at the section entitled "Generating the Certificate Signing Request (CSR)", and substitute your own Bundle Identifier, and Description. - + a) go the this plugin's Example/server folder and open pushAPNS.rb in the text editor of your choice. b) set the APNS.pem variable to the path of the ck.pem file you just created c) set APNS.pass to the password associated with the certificate you just created. (warning this is cleartext, so don't share this file) d) set device_token to the token for the device you want to send a push to. (you can run the Cordova app / plugin in Xcode and extract the token from the log messages) e) save your changes. - + #### 3) (Android) [Follow these steps](http://developer.android.com/guide/google/gcm/gs.html) to generate a project ID and a server based API key. a) go the this plugin's Example/server folder and open pushGCM.rb in the text editor of your choice. b) set the GCM.key variable to the API key you just generated. c) set the destination variable to the Registration ID of the device. (you can run the Cordova app / plugin in on a device via Eclipse and extract the regID from the log messages) - + #### 4) Push a notification a) cd to the directory containing the two .rb files we just edited. From a5ddf01d6920573e28ecf26de56d1b5dc12b710e Mon Sep 17 00:00:00 2001 From: Armno Date: Thu, 26 Sep 2013 12:49:33 +0700 Subject: [PATCH 071/133] use tabs instead of spaces for indentation (to be consistent) --- README.md | 50 +++++++++++++++++++++++++------------------------- 1 file changed, 25 insertions(+), 25 deletions(-) diff --git a/README.md b/README.md index aac91c7c..daae2298 100644 --- a/README.md +++ b/README.md @@ -215,72 +215,72 @@ function tokenHandler (result) { // iOS function onNotificationAPN (event) { if ( event.alert ) - { + { navigator.notification.alert(event.alert); } if ( event.sound ) - { + { var snd = new Media(event.sound); snd.play(); } if ( event.badge ) - { + { pushNotification.setApplicationIconBadgeNumber(successHandler, errorHandler, event.badge); } } // Android function onNotificationGCM(e) { - $("#app-status-ul").append('
  • EVENT -> RECEIVED:' + e.event + '
    • '); + $("#app-status-ul").append('
  • EVENT -> RECEIVED:' + e.event + '
    • '); - switch( e.event ) - { - case 'registered': + switch( e.event ) + { + case 'registered': if ( e.regid.length > 0 ) - { + { $("#app-status-ul").append('
  • REGISTERED -> REGID:' + e.regid + "
    • "); // Your GCM push server needs to know the regID before it can push to this device // here is where you might want to send it the regID for later use. console.log("regID = " + e.regID); } - break; + break; - case 'message': - // if this flag is set, this notification happened while we were in the foreground. - // you might want to play a sound to get the user's attention, throw up a dialog, etc. - if ( e.foreground ) - { + case 'message': + // if this flag is set, this notification happened while we were in the foreground. + // you might want to play a sound to get the user's attention, throw up a dialog, etc. + if ( e.foreground ) + { $("#app-status-ul").append('
  • --INLINE NOTIFICATION--' + '
    • '); // if the notification contains a soundname, play it. var my_media = new Media("/android_asset/www/"+e.soundname); my_media.play(); } - else - { // otherwise we were launched because the user touched a notification in the notification tray. + else + { // otherwise we were launched because the user touched a notification in the notification tray. if ( e.coldstart ) - { + { $("#app-status-ul").append('
  • --COLDSTART NOTIFICATION--' + '
    • '); - } - else - { + } + else + { $("#app-status-ul").append('
  • --BACKGROUND NOTIFICATION--' + '
    • '); - } + } } $("#app-status-ul").append('
  • MESSAGE -> MSG: ' + e.payload.message + '
    • '); $("#app-status-ul").append('
  • MESSAGE -> MSGCNT: ' + e.payload.msgcnt + '
    • '); - break; + break; case 'error': $("#app-status-ul").append('
  • ERROR -> MSG:' + e.msg + '
    • '); - break; + break; - default: + default: $("#app-status-ul").append('
  • EVENT -> Unknown, an event was received and we do not know what it is
    • '); - break; + break; } } ``` From 9a745a64f08f43b9022eacd3a11202ae5c3ee0f5 Mon Sep 17 00:00:00 2001 From: madebycm Date: Tue, 1 Oct 2013 14:55:14 +0200 Subject: [PATCH 072/133] Added getString method to setContentTitle and setTicker ContentTitle and Ticker can now be set from the GCM server via the "title" field in the "data" parameter (appName is no longer hard coded). --- src/android/com/plugin/gcm/GCMIntentService.java | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/src/android/com/plugin/gcm/GCMIntentService.java b/src/android/com/plugin/gcm/GCMIntentService.java index f21c5c2a..ebec4de9 100644 --- a/src/android/com/plugin/gcm/GCMIntentService.java +++ b/src/android/com/plugin/gcm/GCMIntentService.java @@ -92,8 +92,8 @@ public void createNotification(Context context, Bundle extras) .setDefaults(Notification.DEFAULT_ALL) .setSmallIcon(context.getApplicationInfo().icon) .setWhen(System.currentTimeMillis()) - .setContentTitle(appName) - .setTicker(appName) + .setContentTitle(getString("title")) + .setTicker(getString("title")) .setContentIntent(contentIntent); String message = extras.getString("message"); From 860bca69c660767d034dd403a3a70d6177678f62 Mon Sep 17 00:00:00 2001 From: Erik Jan de Wit Date: Fri, 4 Oct 2013 14:52:44 +0200 Subject: [PATCH 073/133] added foreground boolean --- src/android/com/plugin/gcm/PushPlugin.java | 22 ++++++++++++++++++---- 1 file changed, 18 insertions(+), 4 deletions(-) diff --git a/src/android/com/plugin/gcm/PushPlugin.java b/src/android/com/plugin/gcm/PushPlugin.java index fcdaf388..c25d8629 100644 --- a/src/android/com/plugin/gcm/PushPlugin.java +++ b/src/android/com/plugin/gcm/PushPlugin.java @@ -31,6 +31,7 @@ public class PushPlugin extends CordovaPlugin { private static String gECB; private static String gSenderID; private static Bundle gCachedExtras = null; + private static boolean gForeground; /** * Gets the application context from cordova's main activity. @@ -108,6 +109,7 @@ public static void sendJavascript(JSONObject _json) { public static void sendExtras(Bundle extras) { if (extras != null) { + extras.putBoolean("foreground", gForeground); if (gECB != null && gWebView != null) { sendJavascript(convertBundleToJson(extras)); } else { @@ -116,10 +118,22 @@ public static void sendExtras(Bundle extras) } } } - - /* - * serializes a bundle to JSON. - */ + + @Override + public void onPause(boolean multitasking) { + super.onPause(multitasking); + gForeground = false; + } + + @Override + public void onResume(boolean multitasking) { + super.onResume(multitasking); + gForeground = true; + } + + /* + * serializes a bundle to JSON. + */ private static JSONObject convertBundleToJson(Bundle extras) { try From a5aa12d096b2875a7343c351294415dc26971eff Mon Sep 17 00:00:00 2001 From: Erik Jan de Wit Date: Fri, 4 Oct 2013 15:23:22 +0200 Subject: [PATCH 074/133] initially app is in foreground --- src/android/com/plugin/gcm/PushPlugin.java | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/android/com/plugin/gcm/PushPlugin.java b/src/android/com/plugin/gcm/PushPlugin.java index c25d8629..203714d6 100644 --- a/src/android/com/plugin/gcm/PushPlugin.java +++ b/src/android/com/plugin/gcm/PushPlugin.java @@ -31,7 +31,7 @@ public class PushPlugin extends CordovaPlugin { private static String gECB; private static String gSenderID; private static Bundle gCachedExtras = null; - private static boolean gForeground; + private static boolean gForeground = true; /** * Gets the application context from cordova's main activity. From f0b66123f58195ce0ba9508b26ace5d48a4936ae Mon Sep 17 00:00:00 2001 From: Erik Jan de Wit Date: Fri, 4 Oct 2013 15:27:51 +0200 Subject: [PATCH 075/133] do not add notification if application in foreground --- src/android/com/plugin/gcm/GCMIntentService.java | 4 ++-- src/android/com/plugin/gcm/PushPlugin.java | 7 ++++++- 2 files changed, 8 insertions(+), 3 deletions(-) diff --git a/src/android/com/plugin/gcm/GCMIntentService.java b/src/android/com/plugin/gcm/GCMIntentService.java index f21c5c2a..9d45806f 100644 --- a/src/android/com/plugin/gcm/GCMIntentService.java +++ b/src/android/com/plugin/gcm/GCMIntentService.java @@ -69,8 +69,8 @@ protected void onMessage(Context context, Intent intent) { { PushPlugin.sendExtras(extras); - // Send a notification if there is a message - if (extras.getString("message").length() != 0) { + // Send a notification if there is a message and not in foreground + if (!PushPlugin.isInForeground() && extras.getString("message").length() != 0) { createNotification(context, extras); } } diff --git a/src/android/com/plugin/gcm/PushPlugin.java b/src/android/com/plugin/gcm/PushPlugin.java index 203714d6..0da75aab 100644 --- a/src/android/com/plugin/gcm/PushPlugin.java +++ b/src/android/com/plugin/gcm/PushPlugin.java @@ -214,7 +214,12 @@ else if (strValue.startsWith("[")) } return null; } - + + public static boolean isInForeground() + { + return gForeground; + } + public static boolean isActive() { return gWebView != null; From 3b7e92495f0f1885d34374a790a83622be9ff10d Mon Sep 17 00:00:00 2001 From: Bob Easterday Date: Fri, 4 Oct 2013 08:58:16 -0700 Subject: [PATCH 076/133] Don't use two different bundle ids --- plugin.xml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/plugin.xml b/plugin.xml index 4d3678d8..117bbfe4 100755 --- a/plugin.xml +++ b/plugin.xml @@ -1,8 +1,8 @@ + id="com.adobe.plugins.PushPlugin" + version="2.0.2"> PushPlugin Bob Easterday From 1bbc0a2d00479dce3b365f9077fce2093011bb1a Mon Sep 17 00:00:00 2001 From: Bob Easterday Date: Fri, 4 Oct 2013 11:16:13 -0700 Subject: [PATCH 077/133] Death of a bad idea --- plugin.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/plugin.xml b/plugin.xml index 117bbfe4..b10856da 100755 --- a/plugin.xml +++ b/plugin.xml @@ -1,7 +1,7 @@ PushPlugin From 8c8db7bb2a1ca9a7dd058d96795051192688a75f Mon Sep 17 00:00:00 2001 From: Bob Easterday Date: Fri, 4 Oct 2013 12:30:30 -0700 Subject: [PATCH 078/133] Fix Application badge number issue for >3.0 --- plugin.xml | 2 +- src/ios/PushPlugin.m | 14 +++++++------- 2 files changed, 8 insertions(+), 8 deletions(-) diff --git a/plugin.xml b/plugin.xml index b10856da..c8c4f8cb 100755 --- a/plugin.xml +++ b/plugin.xml @@ -2,7 +2,7 @@ + version="2.0.3"> PushPlugin Bob Easterday diff --git a/src/ios/PushPlugin.m b/src/ios/PushPlugin.m index 6ba090d7..2e4c2162 100644 --- a/src/ios/PushPlugin.m +++ b/src/ios/PushPlugin.m @@ -198,17 +198,17 @@ -(void)parseDictionary:(NSDictionary *)inDictionary intoJSON:(NSMutableString *) } } -- (void)setApplicationIconBadgeNumber:(NSMutableArray *)arguments withDict:(NSMutableDictionary *)options { - DLog(@"setApplicationIconBadgeNumber:%@\n withDict:%@", arguments, options); - - self.callbackId = [arguments pop]; - +- (void)setApplicationIconBadgeNumber:(CDVInvokedUrlCommand *)command { + + self.callbackId = command.callbackId; + + NSMutableDictionary* options = [command.arguments objectAtIndex:0]; int badge = [[options objectForKey:@"badge"] intValue] ?: 0; + [[UIApplication sharedApplication] setApplicationIconBadgeNumber:badge]; - + [self successWithMessage:[NSString stringWithFormat:@"app badge count set to %d", badge]]; } - -(void)successWithMessage:(NSString *)message { CDVPluginResult *commandResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsString:message]; From 22ad59f02f8e4d2dc75f81b0e6edb32a87bdb525 Mon Sep 17 00:00:00 2001 From: Marco Silva Date: Mon, 7 Oct 2013 17:32:43 +0200 Subject: [PATCH 079/133] getString should be extras.getString --- src/android/com/plugin/gcm/GCMIntentService.java | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/src/android/com/plugin/gcm/GCMIntentService.java b/src/android/com/plugin/gcm/GCMIntentService.java index bfefa8f2..1b5b7a22 100644 --- a/src/android/com/plugin/gcm/GCMIntentService.java +++ b/src/android/com/plugin/gcm/GCMIntentService.java @@ -92,8 +92,8 @@ public void createNotification(Context context, Bundle extras) .setDefaults(Notification.DEFAULT_ALL) .setSmallIcon(context.getApplicationInfo().icon) .setWhen(System.currentTimeMillis()) - .setContentTitle(getString("title")) - .setTicker(getString("title")) + .setContentTitle(extras.getString("title")) + .setTicker(extras.getString("title")) .setContentIntent(contentIntent); String message = extras.getString("message"); From c5dfcb1acb5d843b3024477a508cef84e59fb176 Mon Sep 17 00:00:00 2001 From: Michal Kuklis Date: Sat, 12 Oct 2013 13:17:18 +0200 Subject: [PATCH 080/133] Added clobbers --- plugin.xml | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/plugin.xml b/plugin.xml index c8c4f8cb..fc85bc2d 100755 --- a/plugin.xml +++ b/plugin.xml @@ -12,8 +12,10 @@ MIT - - + + + + From 9852a6c70a9b051d2182f7092de3d4ca91ce3504 Mon Sep 17 00:00:00 2001 From: Michal Kuklis Date: Sat, 12 Oct 2013 13:30:53 +0200 Subject: [PATCH 081/133] Added PushNotification to module.exports. --- www/PushNotification.js | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/www/PushNotification.js b/www/PushNotification.js index aad81ad6..f4d800f4 100644 --- a/www/PushNotification.js +++ b/www/PushNotification.js @@ -62,3 +62,7 @@ if(!window.plugins) { if (!window.plugins.pushNotification) { window.plugins.pushNotification = new PushNotification(); } + +if (module.exports) { + module.exports = PushNotification; +} \ No newline at end of file From 2c20456e3ea23f5d704c92eb4ddf8cb6a872224e Mon Sep 17 00:00:00 2001 From: Michal Kuklis Date: Sat, 12 Oct 2013 14:43:47 +0200 Subject: [PATCH 082/133] Fixed clobbers --- plugin.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/plugin.xml b/plugin.xml index fc85bc2d..923fbbdd 100755 --- a/plugin.xml +++ b/plugin.xml @@ -14,7 +14,7 @@ MIT - + From 80735f0aff34321095584437e89d5570e79ab255 Mon Sep 17 00:00:00 2001 From: Chris Wiggins Date: Wed, 16 Oct 2013 14:45:34 +1300 Subject: [PATCH 083/133] Encapsulating strings in single quotes is not valid JSON. Change to double quotes --- src/ios/PushPlugin.m | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/ios/PushPlugin.m b/src/ios/PushPlugin.m index 2e4c2162..622f8872 100644 --- a/src/ios/PushPlugin.m +++ b/src/ios/PushPlugin.m @@ -194,7 +194,7 @@ -(void)parseDictionary:(NSDictionary *)inDictionary intoJSON:(NSMutableString *) if ([thisObject isKindOfClass:[NSDictionary class]]) [self parseDictionary:thisObject intoJSON:jsonString]; else - [jsonString appendFormat:@"%@:'%@',", key, [inDictionary objectForKey:key]]; + [jsonString appendFormat:@"%@:\"%@\",", key, [inDictionary objectForKey:key]]; } } From 89477f1e40baa4a8c5f09655c2b260cceb20c8b4 Mon Sep 17 00:00:00 2001 From: Chris Wiggins Date: Wed, 16 Oct 2013 14:47:42 +1300 Subject: [PATCH 084/133] Remove trailing comma for foreground flag and convert to double quotes --- src/ios/PushPlugin.m | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/src/ios/PushPlugin.m b/src/ios/PushPlugin.m index 622f8872..a7bfa2dd 100644 --- a/src/ios/PushPlugin.m +++ b/src/ios/PushPlugin.m @@ -164,11 +164,11 @@ - (void)notificationReceived { if (isInline) { - [jsonStr appendFormat:@"foreground:'%d',", 1]; + [jsonStr appendFormat:@"foreground:\"%d\"", 1]; isInline = NO; } else - [jsonStr appendFormat:@"foreground:'%d',", 0]; + [jsonStr appendFormat:@"foreground:\"%d\"", 0]; [jsonStr appendString:@"}"]; From 504a8b457f7db91aa624ee540d2694625e3abbbf Mon Sep 17 00:00:00 2001 From: Erik Jan de Wit Date: Fri, 25 Oct 2013 09:38:13 +0200 Subject: [PATCH 085/133] call callbacks --- src/android/com/plugin/gcm/PushPlugin.java | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/src/android/com/plugin/gcm/PushPlugin.java b/src/android/com/plugin/gcm/PushPlugin.java index 0da75aab..cb325f38 100644 --- a/src/android/com/plugin/gcm/PushPlugin.java +++ b/src/android/com/plugin/gcm/PushPlugin.java @@ -65,9 +65,11 @@ public boolean execute(String action, JSONArray data, CallbackContext callbackCo GCMRegistrar.register(getApplicationContext(), gSenderID); result = true; + callbackContext.success(); } catch (JSONException e) { Log.e(TAG, "execute: Got JSON Exception " + e.getMessage()); result = false; + callbackContext.error(e.getMessage()); } if ( gCachedExtras != null) { @@ -82,9 +84,11 @@ public boolean execute(String action, JSONArray data, CallbackContext callbackCo Log.v(TAG, "UNREGISTER"); result = true; + callbackContext.success(); } else { result = false; Log.e(TAG, "Invalid action : " + action); + callbackContext.error("Invalid action : " + action); } return result; From 09570c493e44d69123938c89cf4ac96d3a087aae Mon Sep 17 00:00:00 2001 From: scotthooker Date: Thu, 31 Oct 2013 17:21:04 +0000 Subject: [PATCH 086/133] #85 No notifications in android when the app is closed Allow the plugin to know when the app is no longer in foreground so that it may receive push notifications --- src/android/com/plugin/gcm/PushPlugin.java | 1 + 1 file changed, 1 insertion(+) diff --git a/src/android/com/plugin/gcm/PushPlugin.java b/src/android/com/plugin/gcm/PushPlugin.java index cb325f38..36e15e47 100644 --- a/src/android/com/plugin/gcm/PushPlugin.java +++ b/src/android/com/plugin/gcm/PushPlugin.java @@ -234,6 +234,7 @@ public void onDestroy() GCMRegistrar.onDestroy(getApplicationContext()); gWebView = null; gECB = null; + gForeground = false; super.onDestroy(); } } From 8d91c7d8268b3a8f07b64f4bd50e88283e055154 Mon Sep 17 00:00:00 2001 From: Bob Easterday Date: Thu, 31 Oct 2013 11:09:38 -0700 Subject: [PATCH 087/133] bump version for cold-start notification fix --- plugin.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/plugin.xml b/plugin.xml index 923fbbdd..262cf5c8 100755 --- a/plugin.xml +++ b/plugin.xml @@ -2,7 +2,7 @@ + version="2.0.4"> PushPlugin Bob Easterday From 069c728a19bd511207167e01f68703eec67908e7 Mon Sep 17 00:00:00 2001 From: scotthooker Date: Thu, 31 Oct 2013 21:07:34 +0000 Subject: [PATCH 088/133] Initially the app is not inforeground We can rely on the the other activity functions setting foreground to be true --- src/android/com/plugin/gcm/PushPlugin.java | 21 ++++++++++++++++++++- 1 file changed, 20 insertions(+), 1 deletion(-) diff --git a/src/android/com/plugin/gcm/PushPlugin.java b/src/android/com/plugin/gcm/PushPlugin.java index 36e15e47..2708763a 100644 --- a/src/android/com/plugin/gcm/PushPlugin.java +++ b/src/android/com/plugin/gcm/PushPlugin.java @@ -31,7 +31,7 @@ public class PushPlugin extends CordovaPlugin { private static String gECB; private static String gSenderID; private static Bundle gCachedExtras = null; - private static boolean gForeground = true; + private static boolean gForeground = false; /** * Gets the application context from cordova's main activity. @@ -122,6 +122,25 @@ public static void sendExtras(Bundle extras) } } } + + @Override + public void onStart(boolean multitasking) { + super.onStart(multitasking); + gForeground = true; + } + + @Override + public void onRestart(boolean multitasking) { + super.onRestart(multitasking); + gForeground = true; + } + + @Override + public void onStop(boolean multitasking) { + super.onStop(multitasking); + gForeground = false; + } + @Override public void onPause(boolean multitasking) { From a6d966892d3cc8214f75cef11531582964e4a105 Mon Sep 17 00:00:00 2001 From: scotthooker Date: Fri, 1 Nov 2013 15:27:32 +0000 Subject: [PATCH 089/133] remove changes --- src/android/com/plugin/gcm/PushPlugin.java | 22 +--------------------- 1 file changed, 1 insertion(+), 21 deletions(-) diff --git a/src/android/com/plugin/gcm/PushPlugin.java b/src/android/com/plugin/gcm/PushPlugin.java index 2708763a..f6e85bd5 100644 --- a/src/android/com/plugin/gcm/PushPlugin.java +++ b/src/android/com/plugin/gcm/PushPlugin.java @@ -31,7 +31,7 @@ public class PushPlugin extends CordovaPlugin { private static String gECB; private static String gSenderID; private static Bundle gCachedExtras = null; - private static boolean gForeground = false; + private static boolean gForeground = true; /** * Gets the application context from cordova's main activity. @@ -123,25 +123,6 @@ public static void sendExtras(Bundle extras) } } - @Override - public void onStart(boolean multitasking) { - super.onStart(multitasking); - gForeground = true; - } - - @Override - public void onRestart(boolean multitasking) { - super.onRestart(multitasking); - gForeground = true; - } - - @Override - public void onStop(boolean multitasking) { - super.onStop(multitasking); - gForeground = false; - } - - @Override public void onPause(boolean multitasking) { super.onPause(multitasking); @@ -253,7 +234,6 @@ public void onDestroy() GCMRegistrar.onDestroy(getApplicationContext()); gWebView = null; gECB = null; - gForeground = false; super.onDestroy(); } } From fb22a6980a08f9782f26ba52083004aa94a3158a Mon Sep 17 00:00:00 2001 From: scotthooker Date: Fri, 1 Nov 2013 15:27:50 +0000 Subject: [PATCH 090/133] this is the best case We should always send a notification this is better than never sending one --- src/android/com/plugin/gcm/GCMIntentService.java | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/src/android/com/plugin/gcm/GCMIntentService.java b/src/android/com/plugin/gcm/GCMIntentService.java index 1b5b7a22..b84b43d2 100644 --- a/src/android/com/plugin/gcm/GCMIntentService.java +++ b/src/android/com/plugin/gcm/GCMIntentService.java @@ -69,8 +69,8 @@ protected void onMessage(Context context, Intent intent) { { PushPlugin.sendExtras(extras); - // Send a notification if there is a message and not in foreground - if (!PushPlugin.isInForeground() && extras.getString("message").length() != 0) { + // Send a notification if there is a message + if (extras.getString("message").length() != 0) { createNotification(context, extras); } } From 5bc371c4d62b14fba8046b48edcd92a0e13de971 Mon Sep 17 00:00:00 2001 From: Bob Easterday Date: Fri, 1 Nov 2013 17:09:07 -0700 Subject: [PATCH 091/133] Make notifications more consistent when not in the foreground --- plugin.xml | 2 +- src/android/com/plugin/gcm/PushPlugin.java | 4 +++- 2 files changed, 4 insertions(+), 2 deletions(-) diff --git a/plugin.xml b/plugin.xml index 262cf5c8..1f1f69d9 100755 --- a/plugin.xml +++ b/plugin.xml @@ -2,7 +2,7 @@ + version="2.0.5"> PushPlugin Bob Easterday diff --git a/src/android/com/plugin/gcm/PushPlugin.java b/src/android/com/plugin/gcm/PushPlugin.java index f6e85bd5..f19e8ed2 100644 --- a/src/android/com/plugin/gcm/PushPlugin.java +++ b/src/android/com/plugin/gcm/PushPlugin.java @@ -31,7 +31,7 @@ public class PushPlugin extends CordovaPlugin { private static String gECB; private static String gSenderID; private static Bundle gCachedExtras = null; - private static boolean gForeground = true; + private static boolean gForeground = false; /** * Gets the application context from cordova's main activity. @@ -234,6 +234,8 @@ public void onDestroy() GCMRegistrar.onDestroy(getApplicationContext()); gWebView = null; gECB = null; + gForeground = false; + super.onDestroy(); } } From 158f755c82d790f705feb1b1426b37d080c94f3a Mon Sep 17 00:00:00 2001 From: keiichi matsunaga Date: Wed, 13 Nov 2013 13:03:05 +0900 Subject: [PATCH 092/133] json key should be surrounded by quotation --- src/ios/PushPlugin.m | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/ios/PushPlugin.m b/src/ios/PushPlugin.m index a7bfa2dd..c44e9283 100644 --- a/src/ios/PushPlugin.m +++ b/src/ios/PushPlugin.m @@ -194,7 +194,7 @@ -(void)parseDictionary:(NSDictionary *)inDictionary intoJSON:(NSMutableString *) if ([thisObject isKindOfClass:[NSDictionary class]]) [self parseDictionary:thisObject intoJSON:jsonString]; else - [jsonString appendFormat:@"%@:\"%@\",", key, [inDictionary objectForKey:key]]; + [jsonString appendFormat:@"\"%@\":\"%@\",", key, [inDictionary objectForKey:key]]; } } From 4a50133e6bc07f47efc84820eea42a3cdf381f90 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Jorge=20Mart=C3=ADnez=20Mauricio?= Date: Wed, 13 Nov 2013 11:43:17 -0600 Subject: [PATCH 093/133] Update plugin.xml adds android.permission.VIBRATE needed for android 2.3.x --- plugin.xml | 1 + 1 file changed, 1 insertion(+) diff --git a/plugin.xml b/plugin.xml index 1f1f69d9..9ac2ebef 100755 --- a/plugin.xml +++ b/plugin.xml @@ -34,6 +34,7 @@ + From cd8bae93a60e12f068d675d7f18950063e9d03d1 Mon Sep 17 00:00:00 2001 From: keiichi matsunaga Date: Tue, 19 Nov 2013 16:19:30 +0900 Subject: [PATCH 094/133] escape newlines, double-quotes and back-slashes of push message --- src/ios/PushPlugin.m | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/src/ios/PushPlugin.m b/src/ios/PushPlugin.m index c44e9283..1ae5dcd7 100644 --- a/src/ios/PushPlugin.m +++ b/src/ios/PushPlugin.m @@ -194,7 +194,12 @@ -(void)parseDictionary:(NSDictionary *)inDictionary intoJSON:(NSMutableString *) if ([thisObject isKindOfClass:[NSDictionary class]]) [self parseDictionary:thisObject intoJSON:jsonString]; else - [jsonString appendFormat:@"\"%@\":\"%@\",", key, [inDictionary objectForKey:key]]; + [jsonString appendFormat:@"\"%@\":\"%@\",", + key, + [[[[inDictionary objectForKey:key] + stringByReplacingOccurrencesOfString:@"\\" withString:@"\\\\"] + stringByReplacingOccurrencesOfString:@"\"" withString:@"\\\""] + stringByReplacingOccurrencesOfString:@"\n" withString:@"\\n"]]; } } From 0eabba592372aacd833a10affda306e8c4ca602f Mon Sep 17 00:00:00 2001 From: Bob Easterday Date: Fri, 22 Nov 2013 18:10:40 -0800 Subject: [PATCH 095/133] On Android, don't post notification twice if in the foreground --- plugin.xml | 2 +- .../com/plugin/gcm/GCMIntentService.java | 19 ++++++++++----- .../com/plugin/gcm/PushHandlerActivity.java | 8 +++---- src/android/com/plugin/gcm/PushPlugin.java | 24 ++++++++++--------- 4 files changed, 30 insertions(+), 23 deletions(-) diff --git a/plugin.xml b/plugin.xml index 9ac2ebef..eba7618d 100755 --- a/plugin.xml +++ b/plugin.xml @@ -2,7 +2,7 @@ + version="2.1.0"> PushPlugin Bob Easterday diff --git a/src/android/com/plugin/gcm/GCMIntentService.java b/src/android/com/plugin/gcm/GCMIntentService.java index b84b43d2..f5b64e86 100644 --- a/src/android/com/plugin/gcm/GCMIntentService.java +++ b/src/android/com/plugin/gcm/GCMIntentService.java @@ -67,13 +67,20 @@ protected void onMessage(Context context, Intent intent) { Bundle extras = intent.getExtras(); if (extras != null) { - PushPlugin.sendExtras(extras); - - // Send a notification if there is a message - if (extras.getString("message").length() != 0) { - createNotification(context, extras); + // if we are in the foreground, just surface the payload, else post it to the statusbar + if (PushPlugin.isInForeground()) { + extras.putBoolean("foreground", true); + PushPlugin.sendExtras(extras); } - } + else { + extras.putBoolean("foreground", false); + + // Send a notification if there is a message + if (extras.getString("message").length() != 0) { + createNotification(context, extras); + } + } + } } public void createNotification(Context context, Bundle extras) diff --git a/src/android/com/plugin/gcm/PushHandlerActivity.java b/src/android/com/plugin/gcm/PushHandlerActivity.java index 0c051f84..3d79abdd 100644 --- a/src/android/com/plugin/gcm/PushHandlerActivity.java +++ b/src/android/com/plugin/gcm/PushHandlerActivity.java @@ -43,12 +43,10 @@ private void processPushBundle(boolean isPushPluginActive) Bundle extras = getIntent().getExtras(); if (extras != null) { - Bundle originalExtras = extras.getBundle("pushBundle"); - - if ( !isPushPluginActive ) { - originalExtras.putBoolean("coldstart", true); - } + + originalExtras.putBoolean("foreground", false); + originalExtras.putBoolean("coldstart", !isPushPluginActive); PushPlugin.sendExtras(originalExtras); } diff --git a/src/android/com/plugin/gcm/PushPlugin.java b/src/android/com/plugin/gcm/PushPlugin.java index f19e8ed2..10d1aa43 100644 --- a/src/android/com/plugin/gcm/PushPlugin.java +++ b/src/android/com/plugin/gcm/PushPlugin.java @@ -10,6 +10,7 @@ import android.os.Bundle; import android.util.Log; +import org.apache.cordova.CordovaInterface; import org.apache.cordova.CordovaWebView; import org.apache.cordova.CallbackContext; import org.apache.cordova.CordovaPlugin; @@ -113,7 +114,6 @@ public static void sendJavascript(JSONObject _json) { public static void sendExtras(Bundle extras) { if (extras != null) { - extras.putBoolean("foreground", gForeground); if (gECB != null && gWebView != null) { sendJavascript(convertBundleToJson(extras)); } else { @@ -124,6 +124,12 @@ public static void sendExtras(Bundle extras) } @Override + public void initialize(CordovaInterface cordova, CordovaWebView webView) { + super.initialize(cordova, webView); + gForeground = true; + } + + @Override public void onPause(boolean multitasking) { super.onPause(multitasking); gForeground = false; @@ -135,6 +141,12 @@ public void onResume(boolean multitasking) { gForeground = true; } + @Override + public void onDestroy() { + super.onDestroy(); + gForeground = false; + } + /* * serializes a bundle to JSON. */ @@ -228,14 +240,4 @@ public static boolean isActive() { return gWebView != null; } - - public void onDestroy() - { - GCMRegistrar.onDestroy(getApplicationContext()); - gWebView = null; - gECB = null; - gForeground = false; - - super.onDestroy(); - } } From b0c03272a695d83564a6e2259a205f046572c2e8 Mon Sep 17 00:00:00 2001 From: Bob Easterday Date: Fri, 22 Nov 2013 18:23:02 -0800 Subject: [PATCH 096/133] Capitalization error in example --- Example/www/index.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Example/www/index.html b/Example/www/index.html index 49d95707..681e9e72 100755 --- a/Example/www/index.html +++ b/Example/www/index.html @@ -81,7 +81,7 @@ $("#app-status-ul").append('
  • REGISTERED -> REGID:' + e.regid + "
    • "); // Your GCM push server needs to know the regID before it can push to this device // here is where you might want to send it the regID for later use. - console.log("regID = " + e.regID); + console.log("regID = " + e.regid); } break; From 361e9575ea136f1ddd7fde3b6c6c1aac1a19d259 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Jorge=20Mart=C3=ADnez=20Mauricio?= Date: Sat, 23 Nov 2013 13:18:18 -0600 Subject: [PATCH 097/133] fix e.regid in README --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index daae2298..292eb65b 100644 --- a/README.md +++ b/README.md @@ -243,7 +243,7 @@ function onNotificationGCM(e) { $("#app-status-ul").append('
  • REGISTERED -> REGID:' + e.regid + "
    • "); // Your GCM push server needs to know the regID before it can push to this device // here is where you might want to send it the regID for later use. - console.log("regID = " + e.regID); + console.log("regID = " + e.regid); } break; From 8f11b3162c6e2f6232c6ffb0e125574f425a58ba Mon Sep 17 00:00:00 2001 From: keab42 Date: Mon, 25 Nov 2013 16:23:21 +0000 Subject: [PATCH 098/133] Update README.md --- README.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/README.md b/README.md index daae2298..7f860d6a 100644 --- a/README.md +++ b/README.md @@ -130,6 +130,18 @@ where [PLUGIN-PATH] = path to folder containing this plugin ``` +Alternatively this plugin can be installed using the Phonegap CLI. + +1) Navigaate to the root folder for your phonegap project. +2) Run the command. + +```sh + +phonegap local plugin add https://github.com/phonegap-build/PushPlugin.git + + +``` + For additional info, take a look at the [Plugman Documentation](https://github.com/apache/cordova-plugman/blob/master/README.md) ## Plugin API From e71da3d7012a7f19c9da7b177c2bce7df76059e7 Mon Sep 17 00:00:00 2001 From: Sergey Protko Date: Sat, 30 Nov 2013 14:08:29 +0200 Subject: [PATCH 099/133] Fixed quoute unescaping for non string values --- src/ios/PushPlugin.m | 17 ++++++++++------- 1 file changed, 10 insertions(+), 7 deletions(-) diff --git a/src/ios/PushPlugin.m b/src/ios/PushPlugin.m index 1ae5dcd7..9c29d569 100644 --- a/src/ios/PushPlugin.m +++ b/src/ios/PushPlugin.m @@ -193,13 +193,16 @@ -(void)parseDictionary:(NSDictionary *)inDictionary intoJSON:(NSMutableString *) if ([thisObject isKindOfClass:[NSDictionary class]]) [self parseDictionary:thisObject intoJSON:jsonString]; - else - [jsonString appendFormat:@"\"%@\":\"%@\",", - key, - [[[[inDictionary objectForKey:key] - stringByReplacingOccurrencesOfString:@"\\" withString:@"\\\\"] - stringByReplacingOccurrencesOfString:@"\"" withString:@"\\\""] - stringByReplacingOccurrencesOfString:@"\n" withString:@"\\n"]]; + else if ([thisObject isKindOfClass:[NSString class]]) + [jsonString appendFormat:@"\"%@\":\"%@\",", + key, + [[[[inDictionary objectForKey:key] + stringByReplacingOccurrencesOfString:@"\\" withString:@"\\\\"] + stringByReplacingOccurrencesOfString:@"\"" withString:@"\\\""] + stringByReplacingOccurrencesOfString:@"\n" withString:@"\\n"]]; + else { + [jsonString appendFormat:@"\"%@\":\"%@\",", key, [inDictionary objectForKey:key]]; + } } } From e42c659635a90725f84ada99b8b7909a2762bdd8 Mon Sep 17 00:00:00 2001 From: Sebastian Sierra Date: Sun, 1 Dec 2013 11:17:47 -0200 Subject: [PATCH 100/133] Added instrucction to Android manual installation --- README.md | 1 + 1 file changed, 1 insertion(+) diff --git a/README.md b/README.md index daae2298..1923207f 100644 --- a/README.md +++ b/README.md @@ -38,6 +38,7 @@ This plugin is for use with [Cordova](http://incubator.apache.org/cordova/), and 1) copy the contents of **src/android/com/** to your project's **src/com/** folder. copy the contents of **libs/** to your **libs/** folder. + copy **{android_sdk_path}/extras/android/support/v13/android-support-v13.jar** to your **libs/** folder. The final hirearchy will likely look something like this; {project_folder} From cf88ef41e97f51036849556e0fbce32ddc0b69db Mon Sep 17 00:00:00 2001 From: Bob Easterday Date: Tue, 3 Dec 2013 08:19:38 -0800 Subject: [PATCH 101/133] Fix some assumptions about payload content. --- plugin.xml | 2 +- src/android/com/plugin/gcm/GCMIntentService.java | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/plugin.xml b/plugin.xml index eba7618d..1a1cfb28 100755 --- a/plugin.xml +++ b/plugin.xml @@ -2,7 +2,7 @@ + version="2.1.1"> PushPlugin Bob Easterday diff --git a/src/android/com/plugin/gcm/GCMIntentService.java b/src/android/com/plugin/gcm/GCMIntentService.java index f5b64e86..7b01400f 100644 --- a/src/android/com/plugin/gcm/GCMIntentService.java +++ b/src/android/com/plugin/gcm/GCMIntentService.java @@ -76,7 +76,7 @@ protected void onMessage(Context context, Intent intent) { extras.putBoolean("foreground", false); // Send a notification if there is a message - if (extras.getString("message").length() != 0) { + if (extras.getString("message") != null && extras.getString("message").length() != 0) { createNotification(context, extras); } } From dc9d49527498cfb6bdac415e651524197d4e128e Mon Sep 17 00:00:00 2001 From: Bob Easterday Date: Mon, 9 Dec 2013 14:24:20 -0800 Subject: [PATCH 102/133] shutdown cleanup --- src/android/com/plugin/gcm/PushPlugin.java | 2 ++ 1 file changed, 2 insertions(+) diff --git a/src/android/com/plugin/gcm/PushPlugin.java b/src/android/com/plugin/gcm/PushPlugin.java index 10d1aa43..f5521cdf 100644 --- a/src/android/com/plugin/gcm/PushPlugin.java +++ b/src/android/com/plugin/gcm/PushPlugin.java @@ -145,6 +145,8 @@ public void onResume(boolean multitasking) { public void onDestroy() { super.onDestroy(); gForeground = false; + gECB = null; + gWebView = null; } /* From e5ecdc651c1ad6d4c2efc250d17c94f9c2a4b0b3 Mon Sep 17 00:00:00 2001 From: EddyVerbruggen Date: Fri, 14 Mar 2014 21:18:01 +0100 Subject: [PATCH 103/133] Added WP8 support --- .gitignore | 3 +- README.md | 89 +++++++++++++++++++--- plugin.xml | 39 +++++++--- src/wp8/PushPlugin.cs | 169 ++++++++++++++++++++++++++++++++++++++++++ 4 files changed, 279 insertions(+), 21 deletions(-) create mode 100644 src/wp8/PushPlugin.cs diff --git a/.gitignore b/.gitignore index 9bea4330..d3f7b6dd 100644 --- a/.gitignore +++ b/.gitignore @@ -1,2 +1,3 @@ - +*.iml +.idea .DS_Store diff --git a/README.md b/README.md index 6cebd9d4..d644250e 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,4 @@ -# Cordova Push Notifications Plugin for Android and iOS +# Cordova Push Notifications Plugin for Android, iOS and WP8 --- @@ -39,13 +39,13 @@ This plugin is for use with [Cordova](http://incubator.apache.org/cordova/), and 1) copy the contents of **src/android/com/** to your project's **src/com/** folder. copy the contents of **libs/** to your **libs/** folder. copy **{android_sdk_path}/extras/android/support/v13/android-support-v13.jar** to your **libs/** folder. - The final hirearchy will likely look something like this; + The final hierarchy will likely look something like this: {project_folder} libs gcm.jar android-support-v13.jar - cordova-2.7.0.jar + cordova-3.4.0.jar src com plugin @@ -86,7 +86,9 @@ This plugin is for use with [Cordova](http://incubator.apache.org/cordova/), and 4) Modify your **res/xml/config.xml** to include the following line in order to tell Cordova to include this plugin and where it can be found: (See the Sample_config.xml file in the Example folder) ```xml - + + + ``` 5) Add the **PushNotification.js** script to your assets/www folder (or javascripts folder, wherever you want really) and reference it in your main index.html file. This file's usage is described in the **Plugin API** section below. @@ -109,7 +111,9 @@ PushPlugin.m Add a reference for this plugin to the plugins section in **config.xml**: ```xml - + + + ``` Add the **PushNotification.js** script to your assets/www folder (or javascripts folder, wherever you want really) and reference it in your main index.html file. @@ -118,6 +122,27 @@ Add the **PushNotification.js** script to your assets/www folder (or javascripts ``` +## Manual Installation for WP8 + +Copy the following files to your project's Commands folder and add it to the VS project: + +``` +PushPlugin.cs +``` + +Add a reference to this plugin in **config.xml**: + +```xml + + + +``` + +Add the **PushNotification.js** script to your assets/www folder (or javascripts folder, wherever you want really) and reference it in your main index.html file. +```html + +``` + ## Automatic Installation This plugin is based on [plugman](https://github.com/apache/cordova-plugman). to install it to your app, simply execute plugman as follows; @@ -131,15 +156,17 @@ where [PLUGIN-PATH] = path to folder containing this plugin ``` -Alternatively this plugin can be installed using the Phonegap CLI. - -1) Navigaate to the root folder for your phonegap project. -2) Run the command. +Alternatively this plugin can be installed using the Phonegap CLI: ```sh - phonegap local plugin add https://github.com/phonegap-build/PushPlugin.git +``` + +or the Cordova CLI: + +```sh +cordova plugin add https://github.com/phonegap-build/PushPlugin.git ``` @@ -210,7 +237,7 @@ function errorHandler (error) { } ``` -**tokenHandler (iOS ony)** - called when the device has registeredwith a unique device token. +**tokenHandler (iOS only)** - called when the device has registered with a unique device token. ```js function tokenHandler (result) { @@ -302,6 +329,46 @@ Looking at the above message handling code for Android, a few things bear explai Also make note of the **payload** object. Since the Android notification data model is much more flexible than that of iOS, there may be additional elements beyond **message**, **soundname**, and **msgcnt**. You can access those elements and any additional ones via the **payload** element. This means that if your data model should change in the future, there will be no need to change and recompile the plugin. +##### wp8 +Register as + +```js +pushNotification = window.plugins.pushNotification; +pushNotification.register(successHandler, errorHandler, {"channelName":"your_channel_name","ecb":"onNotification"}); + +function successHandler(result) { + console.log('registered###' + result.uri); + // send uri to your notification server +} +``` + +onNotification is fired if the app is running when you receive the toast notification + +```js +function onNotification (e) { + navigator.notification.alert(e.text2, function(){}, e.text1); +} +``` + +When not using PhoneGap Build, you can control the launch page when the user taps on your toast notification when the app is not running. Add the following code to your MainPage.xaml.cs: + +``` + protected override void OnNavigatedTo(System.Windows.Navigation.NavigationEventArgs e) + { + base.OnNavigatedTo(e); + try + { + if (this.NavigationContext.QueryString["NavigatedFrom"] == "toast") // this is set on the server + { + this.CordovaView.StartPageUri = new Uri("//www/index.html#notification-page", UriKind.Relative); + } + } + catch (KeyNotFoundException) + { + } + } +``` + #### unregister You will typically call this when your app is exiting, to cleanup any used resources. Its not strictly necessary to call it, and indeed it may be desireable to NOT call it if you are debugging your intermediarry push server. When you call unregister(), the current token for a particular device will get invalidated, and the next call to register() will return a new token. If you do NOT call unregister(), the last token will remain in effect until it is invalidated for some reason at the GCM side. Since such invalidations are beyond your control, its recommended that, in a production environment, that you have a matching unregister() call, for every call to register(), and that your server updates the devices' records each time. diff --git a/plugin.xml b/plugin.xml index 1a1cfb28..61873231 100755 --- a/plugin.xml +++ b/plugin.xml @@ -2,25 +2,28 @@ + version="2.2.0"> - PushPlugin + PushPlugin Bob Easterday - + - This plugin allows your application to receive push notifications on both Android and iOS devices. The Android implementation uses Google Cloud Messaging whereas the iOS version is based on Apple APNS Notifications + This plugin allows your application to receive push notifications on Android, iOS and WP8 devices. + Android uses Google Cloud Messaging. + iOS uses Apple APNS Notifications. + WP8 uses Microsoft MPNS Notifications. MIT - + - - +     + @@ -58,12 +61,12 @@ - + - + @@ -77,4 +80,22 @@ + + + + + + + + + + + + + + + + + +     diff --git a/src/wp8/PushPlugin.cs b/src/wp8/PushPlugin.cs new file mode 100644 index 00000000..724f2bf9 --- /dev/null +++ b/src/wp8/PushPlugin.cs @@ -0,0 +1,169 @@ +using Microsoft.Phone.Controls; +using Microsoft.Phone.Notification; +using System; +using System.Diagnostics; +using System.Text; +using System.Threading; +using System.Runtime.Serialization; +using System.Windows; + +namespace WPCordovaClassLib.Cordova.Commands +{ + public class PushPlugin : BaseCommand + { + private HttpNotificationChannel pushChannel; + private string channelName; + private string toastCallback; + + public void register(string options) + { + Options pushOptions; + + try + { + string[] args = JSON.JsonHelper.Deserialize(options); + pushOptions = JSON.JsonHelper.Deserialize(args[0]); + this.channelName = pushOptions.ChannelName; + this.toastCallback = pushOptions.NotificationCallback; + } + catch (Exception) + { + DispatchCommandResult(new PluginResult(PluginResult.Status.JSON_EXCEPTION)); + return; + } + + pushChannel = HttpNotificationChannel.Find(channelName); + if (pushChannel == null) + { + pushChannel = new HttpNotificationChannel(channelName); + pushChannel.ChannelUriUpdated += new EventHandler(PushChannel_ChannelUriUpdated); + pushChannel.ErrorOccurred += new EventHandler(PushChannel_ErrorOccurred); + pushChannel.ShellToastNotificationReceived += new EventHandler(PushChannel_ShellToastNotificationReceived); + pushChannel.Open(); + pushChannel.BindToShellToast(); + } + else + { + pushChannel.ChannelUriUpdated += new EventHandler(PushChannel_ChannelUriUpdated); + pushChannel.ErrorOccurred += new EventHandler(PushChannel_ErrorOccurred); + pushChannel.ShellToastNotificationReceived += new EventHandler(PushChannel_ShellToastNotificationReceived); + + RegisterResult result = new RegisterResult(); + result.ChannelName = this.channelName; + result.Uri = pushChannel.ChannelUri.ToString(); + this.DispatchCommandResult(new PluginResult(PluginResult.Status.OK, result)); + } + } + + void PushChannel_ChannelUriUpdated(object sender, NotificationChannelUriEventArgs e) + { + // return uri to js + RegisterResult result = new RegisterResult(); + result.ChannelName = this.channelName; + result.Uri = pushChannel.ChannelUri.ToString(); + this.DispatchCommandResult(new PluginResult(PluginResult.Status.OK, result)); + } + + void PushChannel_ErrorOccurred(object sender, NotificationChannelErrorEventArgs e) + { + // call error handler and return uri + RegisterError err = new RegisterError(); + err.Code = e.ErrorCode.ToString(); + err.Message = e.Message; + this.DispatchCommandResult(new PluginResult(PluginResult.Status.ERROR, err)); + } + + void PushChannel_ShellToastNotificationReceived(object sender, NotificationEventArgs e) + { + StringBuilder message = new StringBuilder(); + string relativeUri = string.Empty; + + Toast toast = new Toast(); + if (e.Collection.ContainsKey("wp:Text1")) + { + toast.Title = e.Collection["wp:Text1"]; + } + if (e.Collection.ContainsKey("wp:Text2")) + { + toast.Subtitle = e.Collection["wp:Text2"]; + } + if (e.Collection.ContainsKey("wp:Param")) + { + toast.Param = e.Collection["wp:Param"]; + } + + PluginResult result = new PluginResult(PluginResult.Status.OK, toast); + + Deployment.Current.Dispatcher.BeginInvoke(() => + { + PhoneApplicationFrame frame = Application.Current.RootVisual as PhoneApplicationFrame; + if (frame != null) + { + PhoneApplicationPage page = frame.Content as PhoneApplicationPage; + if (page != null) + { + CordovaView cView = page.FindName("CordovaView") as CordovaView; // was: PGView + if (cView != null) + { + cView.Browser.Dispatcher.BeginInvoke((ThreadStart)delegate() + { + try + { + cView.Browser.InvokeScript("execScript", this.toastCallback + "(" + result.Message + ")"); + } + catch (Exception ex) + { + Debug.WriteLine("ERROR: Exception in InvokeScriptCallback :: " + ex.Message); + } + + }); + } + } + } + }); + } + + [DataContract] + public class Toast + { + [DataMember(Name = "text1", IsRequired = false)] + public string Title { get; set; } + + [DataMember(Name = "text2", IsRequired = false)] + public string Subtitle { get; set; } + + [DataMember(Name = "param", IsRequired = false)] + public string Param { get; set; } + } + + [DataContract] + public class Options + { + [DataMember(Name = "channelName", IsRequired = true)] + public string ChannelName { get; set; } + + [DataMember(Name = "ecb", IsRequired = false)] + public string NotificationCallback { get; set; } + } + + [DataContract] + public class RegisterResult + { + [DataMember(Name = "uri", IsRequired = true)] + public string Uri { get; set; } + + [DataMember(Name = "channel", IsRequired = true)] + public string ChannelName { get; set; } + } + + [DataContract] + public class RegisterError + { + [DataMember(Name = "code", IsRequired = true)] + public string Code { get; set; } + + [DataMember(Name = "message", IsRequired = true)] + public string Message { get; set; } + } + } +} \ No newline at end of file From b948db38920c2fedb2a28fc82222bdd2e50e3f23 Mon Sep 17 00:00:00 2001 From: Archana Naik Date: Fri, 21 Mar 2014 14:03:21 -0700 Subject: [PATCH 104/133] Added amazon-fireos platform. --- plugin.xml | 46 +++- src/amazon/ADMHandlerActivity.java | 69 +++++ src/amazon/ADMMessageHandler.java | 217 +++++++++++++++ src/amazon/PushPlugin.java | 420 +++++++++++++++++++++++++++++ 4 files changed, 751 insertions(+), 1 deletion(-) create mode 100644 src/amazon/ADMHandlerActivity.java create mode 100644 src/amazon/ADMMessageHandler.java create mode 100644 src/amazon/PushPlugin.java diff --git a/plugin.xml b/plugin.xml index 1a1cfb28..888b93f8 100755 --- a/plugin.xml +++ b/plugin.xml @@ -14,7 +14,7 @@ MIT - + @@ -61,6 +61,50 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/src/amazon/ADMHandlerActivity.java b/src/amazon/ADMHandlerActivity.java new file mode 100644 index 00000000..14ceece2 --- /dev/null +++ b/src/amazon/ADMHandlerActivity.java @@ -0,0 +1,69 @@ +/* + * Copyright 2014 Amazon.com, Inc. or its affiliates. All Rights Reserved. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package com.amazon.cordova.plugin; + +import android.app.Activity; +import android.content.Intent; +import android.content.pm.PackageManager; +import android.os.Bundle; + +public class ADMHandlerActivity extends Activity { + + /* + * this activity will be started if the user touches a notification that we own. We send it's data off to the push + * plugin for processing. If needed, we boot up the main activity to kickstart the application. + * @see android.app.Activity#onCreate(android.os.Bundle) + */ + @Override + public void onCreate(Bundle savedInstanceState) { + super.onCreate(savedInstanceState); + boolean isPushPluginActive = PushPlugin.isActive(); + processPushBundle(isPushPluginActive); + finish(); + if (!isPushPluginActive) { + forceMainActivityReload(); + } + } + + /** + * Takes the pushBundle extras from the intent, and sends it through to the PushPlugin for processing. + */ + private void processPushBundle(boolean isCordovaActive) { + Bundle extras = getIntent().getExtras(); + + if (extras != null) { + Bundle originalExtras = extras + .getBundle(ADMMessageHandler.PUSH_BUNDLE); + ADMMessageHandler.cancelNotification(this); + PushPlugin.sendExtras(originalExtras); + // clean up the noticiationIntent extra + ADMMessageHandler.cleanupNotificationIntent(); + } + } + + /** + * Forces the main activity to re-launch if it's unloaded. + */ + private void forceMainActivityReload(/* Bundle extras */) { + PackageManager pm = getPackageManager(); + Intent launchIntent = pm + .getLaunchIntentForPackage(getApplicationContext() + .getPackageName()); + startActivity(launchIntent); + } + +} diff --git a/src/amazon/ADMMessageHandler.java b/src/amazon/ADMMessageHandler.java new file mode 100644 index 00000000..d1852c6d --- /dev/null +++ b/src/amazon/ADMMessageHandler.java @@ -0,0 +1,217 @@ +/* + * Copyright 2014 Amazon.com, Inc. or its affiliates. All Rights Reserved. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package com.amazon.cordova.plugin; + +import org.json.JSONObject; +import android.app.Notification; +import android.app.NotificationManager; +import android.app.PendingIntent; +import android.content.Context; +import android.content.Intent; +import android.os.Bundle; +import android.util.Log; +import android.app.Notification.Builder; + +import com.amazon.device.messaging.ADMMessageHandlerBase; +import com.amazon.device.messaging.ADMMessageReceiver; + +/** + * The ADMMessageHandler class receives messages sent by ADM via the receiver. + */ + +public class ADMMessageHandler extends ADMMessageHandlerBase { + + private static final String TAG = "ADMMessageHandler"; + private static final String ERROR_EVENT = "error"; + public static final String PUSH_BUNDLE = "pushBundle"; + + // An identifier for ADM notification unique within your application + // It allows you to update the same notification later on + public static final int NOTIFICATION_ID = 519; + static Intent notificationIntent = null; + + /** + * Class constructor. + */ + public ADMMessageHandler() { + super(ADMMessageHandler.class.getName()); + } + + /** + * Class constructor, including the className argument. + * + * @param className + * The name of the class. + */ + public ADMMessageHandler(final String className) { + super(className); + } + + /** + * The Receiver class listens for messages from ADM and forwards them to the ADMMessageHandler class. + */ + public static class Receiver extends ADMMessageReceiver { + public Receiver() { + super(ADMMessageHandler.class); + + } + + // Nothing else is required here; your broadcast receiver automatically + // forwards intents to your service for processing. + } + + /** {@inheritDoc} */ + @Override + protected void onRegistered(final String newRegistrationId) { + // You start the registration process by calling startRegister() in your Main Activity. + // When the registration ID is ready, ADM calls onRegistered() + // on your app. Transmit the passed-in registration ID to your server, so + // your server can send messages to this app instance. onRegistered() is also + // called if your registration ID is rotated or changed for any reason; + // your app should pass the new registration ID to your server if this occurs. + + // we fire the register event in the web app, register handler should + // fire to send the registration ID to your server via a header key/value pair over HTTP.(AJAX) + PushPlugin.sendRegistrationIdWithEvent(PushPlugin.REGISTER, + newRegistrationId); + } + + /** {@inheritDoc} */ + @Override + protected void onUnregistered(final String registrationId) { + // If your app is unregistered on this device, inform your server that + // this app instance is no longer a valid target for messages. + PushPlugin.sendRegistrationIdWithEvent(PushPlugin.UNREGISTER, + registrationId); + } + + /** {@inheritDoc} */ + @Override + protected void onRegistrationError(final String errorId) { + // You should consider a registration error fatal. In response, your app + // may degrade gracefully, or you may wish to notify the user that this part + // of your app's functionality is not available. + try { + JSONObject json; + json = new JSONObject().put(PushPlugin.EVENT, ERROR_EVENT); + json.put(PushPlugin.REG_ID, errorId); + + PushPlugin.sendJavascript(json); + } catch (Exception e) { + Log.getStackTraceString(e); + } + } + + /** {@inheritDoc} */ + @Override + protected void onMessage(final Intent intent) { + // Extract the message content from the set of extras attached to + // the com.amazon.device.messaging.intent.RECEIVE intent. + + // Extract the payload from the message + Bundle extras = intent.getExtras(); + if (extras != null) { + // if we are in the foreground, just surface the payload, else post + // it to the statusbar + if (PushPlugin.isInForeground()) { + extras.putBoolean(PushPlugin.FOREGROUND, true); + PushPlugin.sendExtras(extras); + } else { + extras.putBoolean(PushPlugin.FOREGROUND, false); + createNotification(this, extras); + } + } + } + + /** + * Creates a notification when app is not running or is not in foreground. It puts the message info into the Intent + * extra + * + * @param context + * @param extras + */ + public void createNotification(Context context, Bundle extras) { + NotificationManager mNotificationManager = (NotificationManager) getSystemService(Context.NOTIFICATION_SERVICE); + String appName = getAppName(this); + + // reuse the intent so that we can combine multiple messages into extra + if (notificationIntent == null) { + notificationIntent = new Intent(this, ADMHandlerActivity.class); + } + notificationIntent.addFlags(Intent.FLAG_ACTIVITY_SINGLE_TOP + | Intent.FLAG_ACTIVITY_CLEAR_TOP); + notificationIntent.putExtra("pushBundle", extras); + + PendingIntent contentIntent = PendingIntent.getActivity(this, 0, + notificationIntent, PendingIntent.FLAG_UPDATE_CURRENT); + + final Builder mBuilder = new Notification.Builder(context); + mBuilder.setSmallIcon(context.getApplicationInfo().icon) + .setWhen(System.currentTimeMillis()) + .setContentIntent(contentIntent); + + if (PushPlugin.showMessageInNotificationCenter()) { + mBuilder.setContentText(extras.getString("message")); + } else { + mBuilder.setContentText(PushPlugin.defaultNotificationMessage()); + } + + String title = appName; + mBuilder.setContentTitle(title).setTicker(title); + mBuilder.setAutoCancel(true); + // Because the ID remains unchanged, the existing notification is updated. + mNotificationManager.notify((String) appName, NOTIFICATION_ID, + mBuilder.build()); + } + + public static void cancelNotification(Context context) { + NotificationManager mNotificationManager = (NotificationManager) context + .getSystemService(Context.NOTIFICATION_SERVICE); + mNotificationManager.cancel((String) getAppName(context), + NOTIFICATION_ID); + } + + private static String getAppName(Context context) { + CharSequence appName = context.getPackageManager().getApplicationLabel( + context.getApplicationInfo()); + return (String) appName; + } + + // clean up the message in the intent + static void cleanupNotificationIntent() { + if (notificationIntent != null) { + Bundle pushBundle = notificationIntent.getExtras().getBundle( + PUSH_BUNDLE); + if (pushBundle != null) { + pushBundle.clear(); + } + + } + } + + static Bundle getOfflineMessage() { + Bundle pushBundle = null; + if (notificationIntent != null) { + pushBundle = notificationIntent.getExtras().getBundle(PUSH_BUNDLE); + if (pushBundle.isEmpty()) { + pushBundle = null; + } + } + return pushBundle; + } + +} diff --git a/src/amazon/PushPlugin.java b/src/amazon/PushPlugin.java new file mode 100644 index 00000000..4ab5841c --- /dev/null +++ b/src/amazon/PushPlugin.java @@ -0,0 +1,420 @@ +/* + * Copyright 2014 Amazon.com, Inc. or its affiliates. All Rights Reserved. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package com.amazon.cordova.plugin; + +import org.apache.cordova.CallbackContext; +import org.apache.cordova.CordovaInterface; +import org.apache.cordova.CordovaPlugin; +import org.apache.cordova.CordovaWebView; +import org.apache.cordova.CordovaActivity; +import org.json.JSONArray; +import org.json.JSONException; +import com.amazon.device.messaging.ADM; +import android.app.Activity; +import android.os.Bundle; +import android.text.TextUtils; +import android.util.Log; + +import java.util.Iterator; + +import org.json.JSONObject; + +public class PushPlugin extends CordovaPlugin { + + private static String TAG = "PushPlugin"; + /** + * @uml.property name="adm" + * @uml.associationEnd + */ + private ADM adm = null; + /** + * @uml.property name="activity" + * @uml.associationEnd + */ + private Activity activity = null; + private static CordovaWebView webview = null; + private static String notificationHandlerCallBack; + private static boolean isForeground = false; + private static boolean showOfflineMessage = false; + private static String defaultOfflineMessage = null; + private static Bundle gCachedExtras = null; + + public static final String REGISTER = "register"; + public static final String UNREGISTER = "unregister"; + public static final String MESSAGE = "message"; + public static final String ECB = "ecb"; + public static final String EVENT = "event"; + public static final String PAYLOAD = "payload"; + public static final String FOREGROUND = "foreground"; + public static final String REG_ID = "regid"; + public static final String COLDSTART = "coldstart"; + + private static final String NON_AMAZON_DEVICE_ERROR = "PushNotifications using Amazon Device Messaging is only supported on Kindle Fire devices."; + private static final String ADM_NOT_SUPPORTED_ERROR = "Amazon Device Messaging is not supported on this device."; + private static final String REGISTER_OPTIONS_NULL = "Register options are not specified."; + private static final String ECB_NOT_SPECIFIED = "ecb(eventcallback) option is not specified in register()."; + private static final String ECB_NAME_NOT_SPECIFIED = "ecb(eventcallback) value is missing in options for register()."; + private static final String REGISTRATION_SUCCESS_RESPONSE = "Registration started..."; + private static final String UNREGISTRATION_SUCCESS_RESPONSE = "Unregistration started..."; + + public enum ADMReadiness { + INITIALIZED, NON_AMAZON_DEVICE, ADM_NOT_SUPPORTED + } + + /** + * Sets the context of the Command. This can then be used to do things like get file paths associated with the + * Activity. + * + * @param cordova + * The context of the main Activity. + * @param webView + * The associated CordovaWebView. + */ + @Override + public void initialize(CordovaInterface cordova, CordovaWebView webView) { + super.initialize(cordova, webView); + if (this.isAmazonDevice()) { + adm = new ADM(cordova.getActivity()); + activity = (CordovaActivity) cordova.getActivity(); + webview = this.webView; + isForeground = true; + if (activity != null) { + showOfflineMessage = ((CordovaActivity) activity) + .getBooleanProperty("showmessageinnotification", false); + defaultOfflineMessage = ((CordovaActivity) activity) + .getStringProperty("defaultnotificationmessage", null); + } + } else { + Log.e(TAG, NON_AMAZON_DEVICE_ERROR); + } + } + + /** + * Checks if current device manufacturer is Amazon by using android.os.Build.MANUFACTURER property + * + * @return returns true for all Kindle Fire OS devices. + */ + private boolean isAmazonDevice() { + String deviceMaker = android.os.Build.MANUFACTURER; + return deviceMaker.equalsIgnoreCase("Amazon"); + } + + /** + * Checks if ADM is available and supported - could be one of three 1. Non Amazon device, hence no ADM support 2. + * ADM is not supported on this Kindle device (1st generation) 3. ADM is successfully initialized and ready to be + * used + * + * @return returns true for all Kindle Fire OS devices. + */ + public ADMReadiness isPushPluginReady() { + if (adm == null) { + return ADMReadiness.NON_AMAZON_DEVICE; + } else if (!adm.isSupported()) { + return ADMReadiness.ADM_NOT_SUPPORTED; + } + return ADMReadiness.INITIALIZED; + } + + /** + * @see Plugin#execute(String, JSONArray, String) + */ + @Override + public boolean execute(final String request, final JSONArray args, + CallbackContext callbackContext) throws JSONException { + try { + + // check ADM readiness + ADMReadiness ready = isPushPluginReady(); + if (ready == ADMReadiness.NON_AMAZON_DEVICE) { + callbackContext.error(NON_AMAZON_DEVICE_ERROR); + return false; + } else if (ready == ADMReadiness.ADM_NOT_SUPPORTED) { + callbackContext.error(ADM_NOT_SUPPORTED_ERROR); + return false; + } else if (callbackContext == null) { + Log.e(TAG, + "CallbackConext is null. Notification to WebView is not possible. Can not proceed."); + return false; + } + + // Process the request here + if (REGISTER.equals(request)) { + + if (args == null) { + Log.e(TAG, REGISTER_OPTIONS_NULL); + callbackContext.error(REGISTER_OPTIONS_NULL); + return false; + } + + // parse args to get eventcallback name + if (args.isNull(0)) { + Log.e(TAG, ECB_NOT_SPECIFIED); + callbackContext.error(ECB_NOT_SPECIFIED); + return false; + } + + JSONObject jo = args.getJSONObject(0); + if (jo.getString("ecb").isEmpty()) { + Log.e(TAG, ECB_NAME_NOT_SPECIFIED); + callbackContext.error(ECB_NAME_NOT_SPECIFIED); + return false; + } + callbackContext.success(REGISTRATION_SUCCESS_RESPONSE); + notificationHandlerCallBack = jo.getString(ECB); + String regId = adm.getRegistrationId(); + Log.d(TAG, "regId = " + regId); + if (regId == null) { + adm.startRegister(); + } else { + sendRegistrationIdWithEvent(REGISTER, regId); + } + + // see if there are any messages while app was in background and + // launched via app icon + if (cachedExtrasAvailable()) { + Log.v(TAG, "sending cached extras"); + sendExtras(gCachedExtras); + gCachedExtras = null; + } else { + deliverOfflineMessages(); + } + // Clear the notification if any exists + ADMMessageHandler.cancelNotification(activity); + return true; + + } else if (UNREGISTER.equals(request)) { + adm.startUnregister(); + callbackContext.success(UNREGISTRATION_SUCCESS_RESPONSE); + return true; + } else { + Log.e(TAG, "Invalid action : " + request); + callbackContext.error("Invalid action : " + request); + return false; + } + } catch (final Exception e) { + callbackContext.error(e.getMessage()); + } + + return false; + } + + /** + * Gets "shownotificationmessage" config option + * + * @return returns boolean- true is shownotificationmessage is set to true in config.xml otherwise false + */ + public static boolean showMessageInNotificationCenter() { + return showOfflineMessage; + } + + /** + * Gets "defaultnotificationmessage" config option + * + * @return returns default message provided by user in cofing.xml + */ + public static String defaultNotificationMessage() { + return defaultOfflineMessage; + } + + /** + * Checks if any bundle extras were cached while app was not running + * + * @return returns tru if cached Bundle is not null otherwise true. + */ + public boolean cachedExtrasAvailable() { + return (gCachedExtras != null); + } + + /** + * Checks if offline message was pending to be delivered from notificationIntent. Sends it to webView(JS) if it is + * and also clears notification from the NotificaitonCenter. + */ + private void deliverOfflineMessages() { + Bundle pushBundle = ADMMessageHandler.getOfflineMessage(); + if (pushBundle != null) { + Log.d(TAG,"Sending offline message..."); + sendExtras(pushBundle); + ADMMessageHandler.cleanupNotificationIntent(); + } + } + + // lifecyle callback to set the isForeground + @Override + public void onPause(boolean multitasking) { + Log.d(TAG, "onPause"); + super.onPause(multitasking); + isForeground = false; + } + + @Override + public void onResume(boolean multitasking) { + Log.d(TAG, "onResume"); + super.onResume(multitasking); + isForeground = true; + } + + @Override + public void onDestroy() { + Log.d(TAG, "onDestroy"); + super.onDestroy(); + isForeground = false; + webview = null; + notificationHandlerCallBack = null; + } + + /** + * Indicates if app is in foreground or not. + * + * @return returns true if app is running otherwise false. + */ + public static boolean isInForeground() { + return isForeground; + } + + /** + * Indicates if app is killed or not + * + * @return returns true if app is killed otherwise false. + */ + public static boolean isActive() { + return webview != null; + } + + /** + * Sends register/unregiste events to JS + * + * @param String + * - eventName - "register", "unregister" + * @param String + * - valid registrationId + */ + public static void sendRegistrationIdWithEvent(String event, + String registrationId) { + if (TextUtils.isEmpty(event) || TextUtils.isEmpty(registrationId)) { + return; + } + try { + JSONObject json; + json = new JSONObject().put(EVENT, event); + json.put(REG_ID, registrationId); + + sendJavascript(json); + } catch (Exception e) { + Log.getStackTraceString(e); + } + } + + /** + * Sends events to JS using cordova nativeToJS bridge. + * + * @param JSONObject + */ + public static boolean sendJavascript(JSONObject json) { + if (json == null) { + Log.i(TAG, "JSON object is empty. Nothing to send to JS."); + return true; + } + + if (notificationHandlerCallBack != null && webview != null) { + String jsToSend = "javascript:" + notificationHandlerCallBack + "(" + + json.toString() + ")"; + Log.v(TAG, "sendJavascript: " + jsToSend); + webview.sendJavascript(jsToSend); + return true; + } + return false; + } + + /* + * Sends the pushbundle extras to the client application. If the client application isn't currently active, it is + * cached for later processing. + */ + public static void sendExtras(Bundle extras) { + if (extras != null) { + if (!sendJavascript(convertBundleToJson(extras))) { + Log.v(TAG, + "sendExtras: could not send to JS. Caching extras to send at a later time."); + gCachedExtras = extras; + } + } + } + + // serializes a bundle to JSON. + private static JSONObject convertBundleToJson(Bundle extras) { + if (extras == null) { + return null; + } + + try { + JSONObject json; + json = new JSONObject().put(EVENT, MESSAGE); + + JSONObject jsondata = new JSONObject(); + Iterator it = extras.keySet().iterator(); + while (it.hasNext()) { + String key = it.next(); + Object value = extras.get(key); + + // System data from Android + if (key.equals(FOREGROUND)) { + json.put(key, extras.getBoolean(FOREGROUND)); + } else if (key.equals(COLDSTART)) { + json.put(key, extras.getBoolean(COLDSTART)); + } else { + // we encourage put the message content into message value + // when server send out notification + if (key.equals(MESSAGE)) { + json.put(key, value); + } + + if (value instanceof String) { + // Try to figure out if the value is another JSON object + + String strValue = (String) value; + if (strValue.startsWith("{")) { + try { + JSONObject json2 = new JSONObject(strValue); + jsondata.put(key, json2); + } catch (Exception e) { + jsondata.put(key, value); + } + // Try to figure out if the value is another JSON + // array + } else if (strValue.startsWith("[")) { + try { + JSONArray json2 = new JSONArray(strValue); + jsondata.put(key, json2); + } catch (Exception e) { + jsondata.put(key, value); + } + } else { + jsondata.put(key, value); + } + } + } // while + } + json.put(PAYLOAD, jsondata); + Log.v(TAG, "extrasToJSON: " + json.toString()); + + return json; + } catch (JSONException e) { + Log.e(TAG, "extrasToJSON: JSON exception"); + } + return null; + } + +} From f9f45d6ae503c3abf7a67c0644e3aecb57e4ffdf Mon Sep 17 00:00:00 2001 From: Archana Naik Date: Wed, 26 Mar 2014 09:23:15 -0700 Subject: [PATCH 105/133] Updated readme file with Fire OS details. Added server script and readme for Amazon Device Messaging. --- Example/server/PushADM_README.txt | 40 +++ Example/server/pushADM.py | 431 ++++++++++++++++++++++++++++++ README.md | 105 +++++++- 3 files changed, 567 insertions(+), 9 deletions(-) create mode 100644 Example/server/PushADM_README.txt create mode 100644 Example/server/pushADM.py diff --git a/Example/server/PushADM_README.txt b/Example/server/PushADM_README.txt new file mode 100644 index 00000000..d149e02c --- /dev/null +++ b/Example/server/PushADM_README.txt @@ -0,0 +1,40 @@ +In this document, "your server" refers to the server-side software +that you must implement to use Amazon Device Messaging(ADM - https://developer.amazon.com/sdk/adm.html) services. + +== Server == + +Server: A self-contained web sample application written as a Python +script. The web application simulates a range of tasks your server +could implement to send messages to client applications. The server +runs on port 80 by default. + +There are two main classes in server.py: +SampleWebApp: handles the logic for interacting with ADM +services, as well as keeping a list of all devices that have been +registered with the server. + +ServerHandler: handles the minimal tasks required to process incoming +and outgoing web requests and responses. It also generates a very +simple html GUI. + +The web application exposes the following routes: +/: displays 'Server running'. +/register: accepts registration IDs from instances of your app and +registers them with your server. +/show-devices: returns html GUI that displayes all the devices registered +with your server and that allows you to send custom messages to them. +/sendmsg: Sends a message to ADM Servers for relaying to an instance of +your app. + +To run the server perform the following actions: +1. Change the value of PORT at the beginning of server.py to the port you + would like the server to listen on. Make sure this port is opened and + accessible before proceeding. +2. Change the values of PROD_CLIENT_ID and PROD_CLIENT_SECRET to the ones + you received from Amazon. These are also located at the beggining of + server.py +3. Run from the command line: + > python server.py +4. See it in browser: http://localhost:port +5. Register a device: http://localhost:4000/register?device=device_id +6. List registered devices: http://localhost:4000/show-devices diff --git a/Example/server/pushADM.py b/Example/server/pushADM.py new file mode 100644 index 00000000..f5480388 --- /dev/null +++ b/Example/server/pushADM.py @@ -0,0 +1,431 @@ +# +# Copyright 2014 Amazon.com, Inc. or its affiliates. All Rights Reserved. +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. +# + +# +# To run the server, perform the following actions: +# 1. Change the value of PORT to the port you would like the server +# to listen on. Make sure this port is opened and accessible before proceeding. +# 2. Change the values of PROD_CLIENT_ID and PROD_CLIENT_SECRET to the ones +# you received from ADM. +# 3. Run +# > python server.py +# + +import SimpleHTTPServer +import SocketServer +import logging +from urlparse import urlparse,parse_qs +import json +import urllib +import urllib2 +import threading +import datetime +import hashlib +import base64 + +# Port on which your server will be listening. +PORT = 4000 + +# Client ID received from ADM. +PROD_CLIENT_ID = "$CLIENT_ID" + +# Client secret received from ADM. +PROD_CLIENT_SECRET = "$CLIENT_SECRET" + +# Oauth2.0 token endpoint. This endpoint is used to request authorization tokens. +AMAZON_TOKEN_URL = "https://api.amazon.com/auth/O2/token" + +# ADM services endpoint. This endpoint is used to perform ADM requests. +AMAZON_ADM_URL = "https://api.amazon.com/messaging/registrations/" + +# Data used to request authorization tokens. +ACCESS_TOKEN_REQUEST_DATA = { + "scope" : "messaging:push", + "grant_type" : "client_credentials", + "client_secret" : PROD_CLIENT_SECRET, + "client_id": PROD_CLIENT_ID + } + +# JSON used to perform EnqueueMessage requests. +JSON_MSG_REQUEST = { + "data" : {}, + "consolidationKey" : "", + "expiresAfter" : "", + "md5" : "" + } + +class SampleADMWebapp: + """ + SampleADMWebapp is a class that handles the logic for sending messages to the ADM server + as well as the tasks involved in calling ADM services. + """ + def __init__(self): + """ + SampleADMWebapp constructor. + self.devices is a dictionary of registration IDs registered with your server. + self.token_lock is a lock which will be used to block execution on self.token_data. + self.token_data contains the data returned with an authorization token request response. + """ + self.devices = dict() + self.token_lock = threading.Lock() + self.request_token() + + def register_device(self, url_device): + """ + Registers an instance of our app with this web application and sends it a confirmation + message. The registration id is required to communicate with our app. + + Args: + url_device: A url path containing an app's instance registration ID. + + Returns: + {'status': 'ok'} + """ + params = parse_qs(url_device) + device = params['device'][0] + self.devices[device] = device + print 'registering device ' + device + self.send_message_to_device("You are registered", device, "Registration Confirmation", 3600) + return {'status': 'ok'} + + def unregister_device(self, url_device): + """ + Unregisters an instance of our app from this web application. + The registration ID associated with this app instance should no longer be used. + + Args: + url_device: A url path containing an app's instance registration ID. + + Returns: + {'status': 'ok'} + """ + params = parse_qs(url_device) + device = params['device'][0] + print 'unregistering device ' + device + if self.devices.has_key(device): + self.devices.pop(device) + return {'status': 'ok'} + + def query_devices(self): + """ + Returns: + The registration IDs registered with your server. + """ + return self.devices + + def send_message_to_device(self, message, device, consolidationKey, expiresAfter): + """ + Constructs and sends a request to ADM Servers to enqueue a message for delivery to a specific app instance. + Updates registration id if a newer one is received with the ADM server response. + + Args: + message: Message to send. + device: The registration ID the instance of the app to which the message is to be sent. + consolidationKey: An arbitrary string used to indicate that multiple messages are logically the same. + expiresAfter: The number of seconds that ADM must retain the message if the device is offline. + + Returns: + A message string representative of the outcome of the call. + """ + url = AMAZON_ADM_URL + device + '/messages' + req = urllib2.Request(url) + req.add_header('Content-Type', 'application/json') + req.add_header('Accept', 'application/json') + req.add_header('x-amzn-type-version', 'com.amazon.device.messaging.ADMMessage@1.0') + req.add_header('x-amzn-accept-type', 'com.amazon.device.messaging.ADMSendResult@1.0') + self.token_lock.acquire() + req.add_header('Authorization', "Bearer " + self.token_data['access_token']) + self.token_lock.release() + + timeStamp = str(datetime.datetime.now().isoformat(' ')) + JSON_MSG_REQUEST['data'] = {"message": message, "timeStamp": timeStamp} + JSON_MSG_REQUEST['consolidationKey'] = consolidationKey + JSON_MSG_REQUEST['expiresAfter'] = int(expiresAfter) + JSON_MSG_REQUEST['md5'] = self.calculate_checksum(JSON_MSG_REQUEST['data']) + print req.headers + print req.get_full_url() + print JSON_MSG_REQUEST + try: + # POST EnqueueMessage request to AMD Servers. + response = urllib2.urlopen(req,json.dumps(JSON_MSG_REQUEST)) + + # Retreiving Amazon ADM request ID. Include this with troubleshooting reports. + X_Amzn_RequestId = response.info().get('x-amzn-RequestId') + + # Retreiving the MD5 value computed by ADM servers. + MD5_from_ADM = response.info().get('x-amzn-data-md5') + print "ADM server md5_checksum " + MD5_from_ADM + + # Checking if the app's registration ID needs to be updated. + response_data = json.load(response) + canonical_reg_id = response_data['registrationID'] + if device != canonical_reg_id: + print "Updating registration Id" + if self.devices.has_key(device): + self.devices.pop(device) + self.devices[canonical_reg_id] = canonical_reg_id + return 'Message sent.' + except urllib2.HTTPError as e: + error_reason = json.load(e)['reason'] + if e.code == 400: + return 'Handle ' + str(e) + '. invalid input. Reason: ' + error_reason + elif e.code == 401: + return self.handle_invalid_token_error(e) + elif e.code == 403: + return 'Handle ' + str(e) + '. max rate exceeded. Reason: ' + error_reason + elif e.code == 413: + return 'Handle ' + str(e) + '. message greater than 6KB. Reason: ' + error_reason + elif e.code == 500: + return 'Handle ' + str(e) + '. internal server error' + elif e.code == 503: + return self.handle_server_temporarily_unavailable_error(e) + else: + return 'Message was not sent', str(e) + except urllib2.URLError as e: + return 'Message was not sent', 'URLError: ' + str(e.reason) + except urllib2.HTTPException as e: + return 'Message was not sent', 'HTTPException: ' + str(e) + except Exception as e: + return 'Message was not sent', 'Exception: ' + str(e) + + def handle_invalid_token_error(self, error): + """ + Handles 401 (invalid token error) raised in send_message_to_device(). + This assumes that the 401 error raised in send_message_to_device() + is due to an expired token. This won't help if the invalid token error + is caused for other reasons. + + Args: + error: HTTPError raised in send_message_to_device(). + + Returns: + 'Token refreshed. Please try again.' + """ + self.request_token() + return 'Token refreshed. Please try again.' + + def handle_server_temporarily_unavailable_error(self, error): + """ + Handles 503 (server temporarily unavailable) raised in send_message_to_device(). + 'Retry-After' header will either contain an integer in which case 'Retry-After' + is a delay of time in seconds or a date in HTTP format in which case + 'Retry-After' is the date and time at which it would be suggested to try again. + + Args: + error: HTTPError raised in send_message_to_device(). + + Returns: + A message detailing when the send_message_to_device request should be attempted again. + """ + retry_after = error.info().get('Retry-After') + if retry_after.isdigit(): + return 'Please retry in ' + retry_after + ' seconds' + else: + return 'Please retry at the following time: ' + retry_after + + def calculate_checksum(self, data): + """ + Computes MD5 checksum of the 'data' parameter as per the algorithm detailed + in the ADM documentation. + + Args: + data: a dictionary. + + Returns: + MD5 checksum of key/value pairs within data. + """ + md5_checksum = "" + utf8_data = dict() + utf8_keys = [] + + # Retreiving the list of keys in message. + message_keys = data.keys() + + # Converting data to UTF-8. + for key in message_keys: + utf8_keys.append(key.encode('utf-8')) + utf8_data[key.encode('utf-8')] = data[key].encode('utf-8') + + # UTF-8 sorting of the keys. + utf8_keys.sort() + utf8_string = "" + + # Concatenating the series of key-value pairs. + for key in utf8_keys: + utf8_string = utf8_string + key + utf8_string = utf8_string + ':' + utf8_string = utf8_string + utf8_data[key] + if key != utf8_keys[-1]: + utf8_string = utf8_string + ',' + + # Computing MD5 as per RFC 1321. + md5 = hashlib.md5(utf8_string).digest() + + # Base 64 encoding. + md5_checksum = base64.standard_b64encode(md5) + + print "App server md5_checksum " + md5_checksum + return md5_checksum + + def request_token(self): + """ + Requests and stores an access token from the OAuth2.0 Servers. + We must obtain an access token prior to sending a request to enqueue a message for delivery. + Also, when an access token expires, a new one is requested. + """ + print 'Requesting token' + req = urllib2.Request(AMAZON_TOKEN_URL) + req_data = urllib.urlencode(ACCESS_TOKEN_REQUEST_DATA) + print req_data, str(len(req_data)) + req.add_header('Content-Type', 'application/x-www-form-urlencoded') + + try: + self.token_lock.acquire() + + # POST access token request to OAuth2.0 Servers. + response = urllib2.urlopen(req, req_data) + + # Retreiving Amazon ADM request ID. Include this with troubleshooting reports. + X_Amzn_RequestId = response.info().get('x-amzn-RequestId') + + self.token_data = json.load(response) + self.token_lock.release() + + print 'Token acquired: ' + self.token_data['access_token'] + ' and valid for ' + \ + str(self.token_data['expires_in']) + ' seconds.' + response.close() + interval = int(self.token_data['expires_in']) + t = threading.Timer(interval, self.request_token) + t.daemon = True + t.start() + except urllib2.HTTPError as e: + self.token_lock.release() + error=json.load(e) + print 'Could not acquire token ', error + exit() + +class ServerHandler(SimpleHTTPServer.SimpleHTTPRequestHandler): + """ + Class ServerHandler performs the minimal tasks required to process + web requests coming from our clients, as well as outgoing responses. + """ + + def send_server_response(self, content_type, content): + """ + Sends your server's response. + + Args: + content_type: Content type of response to send (text/html or application/json). + content: Content to send back with the response. + """ + self.send_response(200) + self.send_header('Content-type', content_type) + self.send_header('Content-length', len(content)) + self.end_headers() + self.wfile.write(content) + self.wfile.close() + + def send_html_response(self, html): + """ + Sends an HTML response. + + Args: + html: HTML response to send. + """ + self.send_server_response('text/html', ""+html+"") + + def send_json_response(self, json): + """ + Sends a JSON response. + + Args: + json: JSON response to send. + """ + self.send_server_response('application/json', json) + + def do_GET(self): + """ + SimpleHTTPServer do_GET() implementation. + This method gets called when your server receives GET requests. + """ + self.route_request() + + def route_request(self): + """ + All the routes handled by our web application are handled here. + GUI HTML is generated here. + """ + query = urlparse(self.path).query + if self.path == "/": + server_running = 'Server running' + self.send_html_response(server_running) + elif self.path.startswith("/register"): + ret = theWebApp.register_device(query) + self.send_json_response(json.dumps(ret)) + elif self.path.startswith("/unregister"): + ret = theWebApp.unregister_device(query) + self.send_json_response(json.dumps(ret)) + elif self.path.startswith("/show-devices"): + devices = theWebApp.query_devices() + html = '' + html = html + '

    Select A Device And Send A Message

    ' + if len(devices) == 0: + html = html + '

    No devices registered with server

    ' + html = html + 'Please register a device by restarting the Amazon ADM Sample App or registering from within the app
    ' + else: + html = html + '
    ' + html = html + '' + for device in devices: + html = html + '' + html = html + '' + html = html + '' + html = html + '' + html = html + '' + html = html + '' + html = html + '' + html = html + '' + html = html + '' + html = html + '' + html = html + '' + html = html + '' + html = html + '' + html = html + '' + html = html + '' + html = html + '' + html = html + '
    '+device+'
    Message:
    Consolidation key:
    Expires after:
    ' + html = html + '
    ' + html = html + '' + self.send_html_response(html) + elif self.path.startswith("/sendmsg"): + device=parse_qs(query)['device'][0] + msg = parse_qs(query)['msg'][0] + consolidationKey = parse_qs(query)['consolidationKey'][0] + expiresAfter = parse_qs(query)['expiresAfter'][0] + response = theWebApp.send_message_to_device(msg, device, consolidationKey, expiresAfter) + print response + self.send_json_response(response) + else: + self.send_html_response("not found") + +# Instantiate a new global SampleADMWebapp. +theWebApp = SampleADMWebapp() + +# Instantiate a new ServerHandler and listen on port PORT. +httpd = SocketServer.TCPServer(("",PORT), ServerHandler) + +# Listen forever. +print "starting server in port ", PORT +httpd.serve_forever() diff --git a/README.md b/README.md index 6cebd9d4..2a894a7d 100644 --- a/README.md +++ b/README.md @@ -1,10 +1,10 @@ -# Cordova Push Notifications Plugin for Android and iOS +# Cordova Push Notifications Plugin for Amazon Fire OS, Android and iOS --- ## DESCRIPTION -This plugin is for use with [Cordova](http://incubator.apache.org/cordova/), and allows your application to receive push notifications on both Android and iOS devices. The Android implementation uses [Google's GCM (Google Cloud Messaging) service](http://developer.android.com/guide/google/gcm/index.html), whereas the iOS version is based on [Apple APNS Notifications](http://developer.apple.com/library/mac/#documentation/NetworkingInternet/Conceptual/RemoteNotificationsPG/ApplePushService/ApplePushService.html) +This plugin is for use with [Cordova](http://incubator.apache.org/cordova/), and allows your application to receive push notifications on Amazon Fire OS, Android and iOS devices. The Amazon Fire OS implementation uses [Amazon's ADM(Amazon Device Messaging) service](https://developer.amazon.com/sdk/adm.html), Android implementation uses [Google's GCM (Google Cloud Messaging) service](http://developer.android.com/guide/google/gcm/index.html) and the iOS version is based on [Apple APNS Notifications](http://developer.apple.com/library/mac/#documentation/NetworkingInternet/Conceptual/RemoteNotificationsPG/ApplePushService/ApplePushService.html) **Important** - Push notifications are intended for real devices. The registration process will fail on the iOS simulator. Notifications can be made to work on the Android Emulator. However, doing so requires installation of some helper libraries, as outlined [here,](http://www.androidhive.info/2012/10/android-push-notifications-using-google-cloud-messaging-gcm-php-and-mysql/) under the section titled "Installing helper libraries and setting up the Emulator". @@ -33,6 +33,57 @@ This plugin is for use with [Cordova](http://incubator.apache.org/cordova/), and OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. +## Manual Installation for Amazon Fire OS + +1) Copy the contents of **src/amazon/com/** to your project's **src/com/** folder. + +2) Modify your **AndroidManifest.xml** and add the following lines to your manifest tag: + +```xml + + + + +``` + +3) Modify your **AndroidManifest.xml** and add the following **activity**, **receiver** and **service** tags to your **application** section. + +```xml + + + + + + + + + + +``` + +4) Modify your **AndroidManifest.xml** and add "amazon" XML namespace to tag: + +```xml +xmlns:amazon="http://schemas.amazon.com/apk/res/android" +``` + +5) Modify your res/xml/config.xml to add a reference to PushPlugin: + +```xml + + + +``` + +6) Modify your res/xml/config.xml to set some config options to let Cordova know whether to display ADM message in the notification center or not. If not, provide the default message. By default, message will be visible in the notification. These config options are used if message arrives and app is not in the foreground(either Killed or running in the background). + +```xml + + +``` + +7) Finally, put api_key.txt (given to you when you register your app on [Amazon Developer Portal](https://developer.amazon.com/sdk/adm.html). For detailed steps on how to register for ADM please refer to section "Registering your app for Amazon Device Messaging(ADM)" + ## Manual Installation for Android @@ -145,6 +196,16 @@ phonegap local plugin add https://github.com/phonegap-build/PushPlugin.git For additional info, take a look at the [Plugman Documentation](https://github.com/apache/cordova-plugman/blob/master/README.md) +Note: For Amazon Fire OS, you will have to follow 2 steps below after automatic installation: + +1) Modify your **AndroidManifest.xml** and add "amazon" XML namespace to tag: + +```xml +xmlns:amazon="http://schemas.amazon.com/apk/res/android" +``` + +2) Put api_key.txt (given to you when you register your app on [Amazon Developer Portal](https://developer.amazon.com/sdk/adm.html) in your app's assets folder ($path to app/platforms/amazon-fireos/assets/). For detailed steps on how to register for ADM please refer to section "Registering your app for Amazon Device Messaging(ADM)" + ## Plugin API In the Examples folder you will find a sample implementation showing how to interact with the PushPlugin. Modify it to suit your needs. @@ -162,15 +223,18 @@ pushNotification = window.plugins.pushNotification; ``` #### register -This should be called as soon as the device becomes ready. On success, you will get a call to tokenHandler (iOS), or onNotificationGCM (Android), allowing you to obtain the device token or registration ID, respectively. Those values will typically get posted to your intermediary push server so it knows who it can send notifications to. +This should be called as soon as the device becomes ready. On success, you will get a call to tokenHandler (iOS), or onNotificationGCM (Amazon Fire OS or Android), allowing you to obtain the device token or registration ID, respectively. Those values will typically get posted to your intermediary push server so it knows who it can send notifications to. +For Amazon Fire OS, if you have not already registered with Amazon developer portal,you will have to obtain credentials and api_key for your app. This is described more in detail in the **Registering your app for Amazon Device Messaging(ADM)** section below. For Android, If you have not already done so, you'll need to set up a Google API project, to generate your senderID. [Follow these steps](http://developer.android.com/guide/google/gcm/gs.html) to do so. This is described more fully in the **Test Environment** section below. In this example, be sure and substitute your own senderID. Get your senderID by signing into to your [google dashboard](https://code.google.com/apis/console/). The senderID is found at **Overview->Dashboard->Project Number**. +Note: For Amazon Fire OS platform, sender_id is not needed. If you provide one, it will be ignored. "ecb" MUST be provided in order to get callback notifications. + ```js -if ( device.platform == 'android' || device.platform == 'Android' ) +if ( device.platform == 'android' || device.platform == 'Android' || device.platform == "Amazon" || device.platform == "amazon") { pushNotification.register( successHandler, @@ -284,7 +348,10 @@ function onNotificationGCM(e) { } $("#app-status-ul").append('
  • MESSAGE -> MSG: ' + e.payload.message + '
    • '); - $("#app-status-ul").append('
  • MESSAGE -> MSGCNT: ' + e.payload.msgcnt + '
    • '); + //Only works for GCM + $("#app-status-ul").append('
  • MESSAGE -> MSGCNT: ' + e.payload.msgcnt + '
    • '); + //Only works on Amazon Fire OS + $status.append('
  • MESSAGE -> TIME: ' + e.payload.timeStamp + '
    • '); break; case 'error': @@ -298,9 +365,12 @@ function onNotificationGCM(e) { } ``` -Looking at the above message handling code for Android, a few things bear explaination. Your app may receive a notification while it is active (INLINE). If you background the app by hitting the Home button on your device, you may later receive a status bar notification. Selecting that notification from the status will bring your app to the front and allow you to process the notification (BACKGROUND). Finally, should you completely exit the app by hitting the back button from the home page, you may still receive a notification. Touching that notification in the notification tray will relaunch your app and allow you to process the notification (COLDSTART). In this case the **coldstart** flag will be set on the incoming event. You can look at the **foreground** flag on the event to determine whether you are processing a background or an in-line notification. You may choose, for example to play a sound or show a dialog only for inline or coldstart notifications since the user has already been alerted via the status bar. +Looking at the above message handling code for Android/Amazon Fire OS, a few things bear explanation. Your app may receive a notification while it is active (INLINE). If you background the app by hitting the Home button on your device, you may later receive a status bar notification. Selecting that notification from the status will bring your app to the front and allow you to process the notification (BACKGROUND). Finally, should you completely exit the app by hitting the back button from the home page, you may still receive a notification. Touching that notification in the notification tray will relaunch your app and allow you to process the notification (COLDSTART). In this case the **coldstart** flag will be set on the incoming event. You can look at the **foreground** flag on the event to determine whether you are processing a background or an in-line notification. You may choose, for example to play a sound or show a dialog only for inline or coldstart notifications since the user has already been alerted via the status bar. + +For Amazon Fire OS platform, offline message can also be received when app is launched via carousel or by tapping on app icon from apps. In either case once app delivers the offline message to JS, notification will be cleared. Also make note of the **payload** object. Since the Android notification data model is much more flexible than that of iOS, there may be additional elements beyond **message**, **soundname**, and **msgcnt**. You can access those elements and any additional ones via the **payload** element. This means that if your data model should change in the future, there will be no need to change and recompile the plugin. +**payload** for Amazon Fire OS is mostly similar to Android with minor differences. It does NOT have **msgcnt** but instead it has **timestamp**. #### unregister You will typically call this when your app is exiting, to cleanup any used resources. Its not strictly necessary to call it, and indeed it may be desireable to NOT call it if you are debugging your intermediarry push server. When you call unregister(), the current token for a particular device will get invalidated, and the next call to register() will return a new token. If you do NOT call unregister(), the last token will remain in effect until it is invalidated for some reason at the GCM side. Since such invalidations are beyond your control, its recommended that, in a production environment, that you have a matching unregister() call, for every call to register(), and that your server updates the devices' records each time. @@ -361,10 +431,10 @@ pushNotification.setApplicationIconBadgeNumber(successCallback, errorCallback, b The notification system consists of several interdependent components. 1) The client application which runs on a device and receives notifications. - 2) The notification service provider (APNS for Apple, GCM for Google) - 3) Intermediary servers that collect device IDs from clients and push notifications through APNS and/or GCM. + 2) The notification service provider (ADM for Amazon Fire OS, APNS for Apple, GCM for Google) + 3) Intermediary servers that collect device IDs from clients and push notifications through Amazon ADM servers, APNS and/or GCM. -This plugin and its target Cordova application comprise the client application.The APNS and GCM infrastructure are maintained by Apple and Google, respectively. In order to send push notifications to your users, you would typically run an intermediary server or employ a 3rd party push service. This is true for both GCM (Android) and APNS (iOS) notifications. However, when testing the notification client applications, it may be desirable to be able to push notifications directly from your desktop, without having to design and build those server's first. There are a number of solutions out there to allow you to push from a desktop machine, sans server. The easiest I've found to work with is a ruby gem called [pushmeup](http://rubygems.org/gems/pushmeup). I've only tried this on Mac, but it probably works fine on Windows as well. Here's a rough outline; +This plugin and its target Cordova application comprise the client application.The ADM, APNS and GCM infrastructure are maintained by Amazon, Apple and Google, respectively. In order to send push notifications to your users, you would typically run an intermediary server or employ a 3rd party push service. This is true for all ADM(Amazon), GCM (Android) and APNS (iOS) notifications. However, when testing the notification client applications, it may be desirable to be able to push notifications directly from your desktop, without having to design and build those server's first. There are a number of solutions out there to allow you to push from a desktop machine, sans server. The easiest I've found to work with is a ruby gem called [pushmeup](http://rubygems.org/gems/pushmeup). I've only tried this on Mac, but it probably works fine on Windows as well. Here's a rough outline; **Prerequisites**. @@ -398,6 +468,22 @@ Start at the section entitled "Generating the Certificate Signing Request (CSR)" c) $ ruby pushGCM.rb d) $ ruby pushAPNS.rb +**Server for ADM** + +There is a python script that runs a simple web server from your local machine. Goto Example/Server folder. Follow the steps below: + +#### 1) open ADMServer.py in text editor and change the PORT, PROD_CLIENT_ID and PROD_CLIENT_SECRET values. + +#### 2) From command line run this command - "python ADMServer.py". + +#### 3) Open your favorite browser and load server url : http://localhost:4000/. It should report "Server Running". If you don't see this then check on command line for any errors. This also means something went wrong with ADM registration. Double check your Client_ID and Secret_Code. Also, make sure your app on Amazon dev portal has Device Messaging switch turned ON. + +#### 4) Once you register through the app and have valid registrationId, you should register that with the server too using this url: http://localhost:4000/register?device=registraionId. + +#### 5) To see list of registered devices with your server use this url: http://localhost:4000/show-devices + +#### 6) To send a message to one or more registered devices use this url: http://localhost:4000/show-devices, click on the radio button next to device id and type in the message. + If all went well, you should see a notification show up on each device. If not, make sure you are not being blocked by a firewall, and that you have internet access. Check and recheck the token id, the registration ID and the certificate generating process. In a production environment, your app, upon registration, would send the device id (iOS) or the registration id (Android), to your intermediary push server. For iOS, the push certificate would also be stored there, and would be used to authenticate push requests to the APNS server. When a push request is processed, this information is then used to target specific apps running on individual devices. @@ -412,6 +498,7 @@ If you're not up to building and maintaining your own intermediary push server, [kony](http://www.kony.com/push-notification-services) and many others. +[Amazon Simple Notification Service](https://aws.amazon.com/sns/) ## Notes From e23ef7ebf46b74fbdce189efa06850f29232a2d5 Mon Sep 17 00:00:00 2001 From: Archana Naik Date: Tue, 1 Apr 2014 14:37:46 -0700 Subject: [PATCH 106/133] Fixed couple of issues - 1. permission denied when launching the app from notification. 2. Message is not downloaded when resumed after hitting hoem button. --- plugin.xml | 2 +- src/amazon/ADMMessageHandler.java | 20 ++++----- src/amazon/PushPlugin.java | 75 +++++++++++++++++++------------ 3 files changed, 58 insertions(+), 39 deletions(-) diff --git a/plugin.xml b/plugin.xml index 888b93f8..a8901cdd 100755 --- a/plugin.xml +++ b/plugin.xml @@ -88,7 +88,7 @@ is unavailable. --> - + diff --git a/src/amazon/ADMMessageHandler.java b/src/amazon/ADMMessageHandler.java index d1852c6d..b566a51b 100644 --- a/src/amazon/ADMMessageHandler.java +++ b/src/amazon/ADMMessageHandler.java @@ -145,7 +145,7 @@ protected void onMessage(final Intent intent) { * @param extras */ public void createNotification(Context context, Bundle extras) { - NotificationManager mNotificationManager = (NotificationManager) getSystemService(Context.NOTIFICATION_SERVICE); + NotificationManager notificationManager = (NotificationManager) getSystemService(Context.NOTIFICATION_SERVICE); String appName = getAppName(this); // reuse the intent so that we can combine multiple messages into extra @@ -159,23 +159,23 @@ public void createNotification(Context context, Bundle extras) { PendingIntent contentIntent = PendingIntent.getActivity(this, 0, notificationIntent, PendingIntent.FLAG_UPDATE_CURRENT); - final Builder mBuilder = new Notification.Builder(context); - mBuilder.setSmallIcon(context.getApplicationInfo().icon) + final Builder notificationBuilder = new Notification.Builder(context); + notificationBuilder.setSmallIcon(context.getApplicationInfo().icon) .setWhen(System.currentTimeMillis()) .setContentIntent(contentIntent); if (PushPlugin.showMessageInNotificationCenter()) { - mBuilder.setContentText(extras.getString("message")); + notificationBuilder.setContentText(extras.getString("message")); } else { - mBuilder.setContentText(PushPlugin.defaultNotificationMessage()); + notificationBuilder.setContentText(PushPlugin.defaultNotificationMessage()); } String title = appName; - mBuilder.setContentTitle(title).setTicker(title); - mBuilder.setAutoCancel(true); + notificationBuilder.setContentTitle(title).setTicker(title); + notificationBuilder.setAutoCancel(true); // Because the ID remains unchanged, the existing notification is updated. - mNotificationManager.notify((String) appName, NOTIFICATION_ID, - mBuilder.build()); + notificationManager.notify((String) appName, NOTIFICATION_ID, + notificationBuilder.getNotification()); } public static void cancelNotification(Context context) { @@ -203,7 +203,7 @@ static void cleanupNotificationIntent() { } } - static Bundle getOfflineMessage() { + public static Bundle getOfflineMessage() { Bundle pushBundle = null; if (notificationIntent != null) { pushBundle = notificationIntent.getExtras().getBundle(PUSH_BUNDLE); diff --git a/src/amazon/PushPlugin.java b/src/amazon/PushPlugin.java index 4ab5841c..9dd9be4f 100644 --- a/src/amazon/PushPlugin.java +++ b/src/amazon/PushPlugin.java @@ -21,6 +21,7 @@ import org.apache.cordova.CordovaPlugin; import org.apache.cordova.CordovaWebView; import org.apache.cordova.CordovaActivity; +import org.apache.cordova.LOG; import org.json.JSONArray; import org.json.JSONException; import com.amazon.device.messaging.ADM; @@ -99,7 +100,7 @@ public void initialize(CordovaInterface cordova, CordovaWebView webView) { .getStringProperty("defaultnotificationmessage", null); } } else { - Log.e(TAG, NON_AMAZON_DEVICE_ERROR); + LOG.e(TAG, NON_AMAZON_DEVICE_ERROR); } } @@ -136,7 +137,6 @@ public ADMReadiness isPushPluginReady() { public boolean execute(final String request, final JSONArray args, CallbackContext callbackContext) throws JSONException { try { - // check ADM readiness ADMReadiness ready = isPushPluginReady(); if (ready == ADMReadiness.NON_AMAZON_DEVICE) { @@ -146,7 +146,7 @@ public boolean execute(final String request, final JSONArray args, callbackContext.error(ADM_NOT_SUPPORTED_ERROR); return false; } else if (callbackContext == null) { - Log.e(TAG, + LOG.e(TAG, "CallbackConext is null. Notification to WebView is not possible. Can not proceed."); return false; } @@ -155,28 +155,28 @@ public boolean execute(final String request, final JSONArray args, if (REGISTER.equals(request)) { if (args == null) { - Log.e(TAG, REGISTER_OPTIONS_NULL); + LOG.e(TAG, REGISTER_OPTIONS_NULL); callbackContext.error(REGISTER_OPTIONS_NULL); return false; } // parse args to get eventcallback name if (args.isNull(0)) { - Log.e(TAG, ECB_NOT_SPECIFIED); + LOG.e(TAG, ECB_NOT_SPECIFIED); callbackContext.error(ECB_NOT_SPECIFIED); return false; } JSONObject jo = args.getJSONObject(0); if (jo.getString("ecb").isEmpty()) { - Log.e(TAG, ECB_NAME_NOT_SPECIFIED); + LOG.e(TAG, ECB_NAME_NOT_SPECIFIED); callbackContext.error(ECB_NAME_NOT_SPECIFIED); return false; } callbackContext.success(REGISTRATION_SUCCESS_RESPONSE); notificationHandlerCallBack = jo.getString(ECB); String regId = adm.getRegistrationId(); - Log.d(TAG, "regId = " + regId); + LOG.d(TAG, "regId = " + regId); if (regId == null) { adm.startRegister(); } else { @@ -185,23 +185,16 @@ public boolean execute(final String request, final JSONArray args, // see if there are any messages while app was in background and // launched via app icon - if (cachedExtrasAvailable()) { - Log.v(TAG, "sending cached extras"); - sendExtras(gCachedExtras); - gCachedExtras = null; - } else { - deliverOfflineMessages(); - } - // Clear the notification if any exists - ADMMessageHandler.cancelNotification(activity); + LOG.d(TAG,"checking for offline message.."); + deliverPendingMessageAndCancelNotifiation(); return true; } else if (UNREGISTER.equals(request)) { adm.startUnregister(); callbackContext.success(UNREGISTRATION_SUCCESS_RESPONSE); return true; - } else { - Log.e(TAG, "Invalid action : " + request); + } else { + LOG.e(TAG, "Invalid action : " + request); callbackContext.error("Invalid action : " + request); return false; } @@ -243,33 +236,38 @@ public boolean cachedExtrasAvailable() { * Checks if offline message was pending to be delivered from notificationIntent. Sends it to webView(JS) if it is * and also clears notification from the NotificaitonCenter. */ - private void deliverOfflineMessages() { + private boolean deliverOfflineMessages() { + LOG.d(TAG,"deliverOfflineMessages()"); Bundle pushBundle = ADMMessageHandler.getOfflineMessage(); if (pushBundle != null) { - Log.d(TAG,"Sending offline message..."); + LOG.d(TAG,"Sending offline message..."); sendExtras(pushBundle); ADMMessageHandler.cleanupNotificationIntent(); + return true; } + return false; } // lifecyle callback to set the isForeground @Override public void onPause(boolean multitasking) { - Log.d(TAG, "onPause"); + LOG.d(TAG, "onPause"); super.onPause(multitasking); isForeground = false; } @Override public void onResume(boolean multitasking) { - Log.d(TAG, "onResume"); + LOG.d(TAG, "onResume"); super.onResume(multitasking); isForeground = true; + //Check if there are any offline messages? + deliverPendingMessageAndCancelNotifiation(); } @Override public void onDestroy() { - Log.d(TAG, "onDestroy"); + LOG.d(TAG, "onDestroy"); super.onDestroy(); isForeground = false; webview = null; @@ -294,6 +292,27 @@ public static boolean isActive() { return webview != null; } + /** + * Delivers pending/offline messages if any + * + * @return returns true if there were any pending messages otherwise false. + */ + public boolean deliverPendingMessageAndCancelNotifiation() { + boolean delivered = false; + LOG.d(TAG,"deliverPendingMessages()"); + if (cachedExtrasAvailable()) { + LOG.v(TAG, "sending cached extras"); + sendExtras(gCachedExtras); + gCachedExtras = null; + delivered = true; + } else { + delivered = deliverOfflineMessages(); + } + // Clear the notification if any exists + ADMMessageHandler.cancelNotification(activity); + + return delivered; + } /** * Sends register/unregiste events to JS * @@ -325,14 +344,14 @@ public static void sendRegistrationIdWithEvent(String event, */ public static boolean sendJavascript(JSONObject json) { if (json == null) { - Log.i(TAG, "JSON object is empty. Nothing to send to JS."); + LOG.i(TAG, "JSON object is empty. Nothing to send to JS."); return true; } if (notificationHandlerCallBack != null && webview != null) { String jsToSend = "javascript:" + notificationHandlerCallBack + "(" + json.toString() + ")"; - Log.v(TAG, "sendJavascript: " + jsToSend); + LOG.v(TAG, "sendJavascript: " + jsToSend); webview.sendJavascript(jsToSend); return true; } @@ -346,7 +365,7 @@ public static boolean sendJavascript(JSONObject json) { public static void sendExtras(Bundle extras) { if (extras != null) { if (!sendJavascript(convertBundleToJson(extras))) { - Log.v(TAG, + LOG.v(TAG, "sendExtras: could not send to JS. Caching extras to send at a later time."); gCachedExtras = extras; } @@ -408,11 +427,11 @@ private static JSONObject convertBundleToJson(Bundle extras) { } // while } json.put(PAYLOAD, jsondata); - Log.v(TAG, "extrasToJSON: " + json.toString()); + LOG.v(TAG, "extrasToJSON: " + json.toString()); return json; } catch (JSONException e) { - Log.e(TAG, "extrasToJSON: JSON exception"); + LOG.e(TAG, "extrasToJSON: JSON exception"); } return null; } From 377ac1aa5aaa85bd386b6095d3e4c0fb8d41d3c5 Mon Sep 17 00:00:00 2001 From: Archana Naik Date: Thu, 3 Apr 2014 11:37:02 -0700 Subject: [PATCH 107/133] Config options are persisted now. When app is forced stopped, we read config options from sharedPreferences. Also, fixes error message not being shown properly. --- plugin.xml | 2 +- src/amazon/ADMMessageHandler.java | 77 ++++++++++++++++++++++++++++--- src/amazon/PushPlugin.java | 30 ++---------- 3 files changed, 75 insertions(+), 34 deletions(-) diff --git a/plugin.xml b/plugin.xml index a8901cdd..ce6f2621 100755 --- a/plugin.xml +++ b/plugin.xml @@ -69,7 +69,7 @@ - + diff --git a/src/amazon/ADMMessageHandler.java b/src/amazon/ADMMessageHandler.java index b566a51b..cc8f39b4 100644 --- a/src/amazon/ADMMessageHandler.java +++ b/src/amazon/ADMMessageHandler.java @@ -16,13 +16,16 @@ package com.amazon.cordova.plugin; +import org.apache.cordova.CordovaActivity; import org.json.JSONObject; import android.app.Notification; import android.app.NotificationManager; import android.app.PendingIntent; import android.content.Context; import android.content.Intent; +import android.content.SharedPreferences; import android.os.Bundle; +import android.text.TextUtils; import android.util.Log; import android.app.Notification.Builder; @@ -35,10 +38,16 @@ public class ADMMessageHandler extends ADMMessageHandlerBase { - private static final String TAG = "ADMMessageHandler"; private static final String ERROR_EVENT = "error"; public static final String PUSH_BUNDLE = "pushBundle"; - + public static final String ERROR_MSG = "msg"; + private static final String SHOW_MESSAGE_PREF = "showmessageinnotification"; + private static final String DEFAULT_MESSAGE_PREF = "defaultnotificationmessage"; + private static boolean shouldShowOfflineMessage = false; + private static String defaultOfflineMessage = null; + private static final String PREFS_NAME = "PushPluginPrefs"; + private static final String DEFAULT_MESSAGE_TEXT = "You have a new message."; + // An identifier for ADM notification unique within your application // It allows you to update the same notification later on public static final int NOTIFICATION_ID = 519; @@ -108,7 +117,7 @@ protected void onRegistrationError(final String errorId) { try { JSONObject json; json = new JSONObject().put(PushPlugin.EVENT, ERROR_EVENT); - json.put(PushPlugin.REG_ID, errorId); + json.put(ADMMessageHandler.ERROR_MSG, errorId); PushPlugin.sendJavascript(json); } catch (Exception e) { @@ -164,10 +173,10 @@ public void createNotification(Context context, Bundle extras) { .setWhen(System.currentTimeMillis()) .setContentIntent(contentIntent); - if (PushPlugin.showMessageInNotificationCenter()) { - notificationBuilder.setContentText(extras.getString("message")); + if (this.shouldShowMessageInNotification()) { + notificationBuilder.setContentText(extras.getString(PushPlugin.MESSAGE)); } else { - notificationBuilder.setContentText(PushPlugin.defaultNotificationMessage()); + notificationBuilder.setContentText(this.defaultMessageTextInNotification()); } String title = appName; @@ -214,4 +223,60 @@ public static Bundle getOfflineMessage() { return pushBundle; } + /** + * Reads "shownotificationmessage" & "defaultnotificationmessage" config options + * If this is first-time it saves them to sharedPreferences so they can be read + * when app is forced-stop or killed + */ + public static void saveConfigOptions(Context context) { + if (context != null && TextUtils.isEmpty(defaultOfflineMessage)) { + // read config options from config.xml + shouldShowOfflineMessage = ((CordovaActivity) context) + .getBooleanProperty(SHOW_MESSAGE_PREF, false); + defaultOfflineMessage = ((CordovaActivity) context) + .getStringProperty(DEFAULT_MESSAGE_PREF, null); + + // save them to sharedPreferences if necessary + SharedPreferences config = context.getApplicationContext().getSharedPreferences(PREFS_NAME, 0); + SharedPreferences.Editor editor = config.edit(); + editor.putBoolean(SHOW_MESSAGE_PREF, shouldShowOfflineMessage); + editor.putString(DEFAULT_MESSAGE_PREF, defaultOfflineMessage); + // save prefs to disk + editor.commit(); + } + + } + + /** + * Gets "shownotificationmessage" config option + * + * @return returns boolean- true is shownotificationmessage is set to true in config.xml/sharedPreferences otherwise false + */ + private boolean shouldShowMessageInNotification() { + //check if have cached copy of this option + if (TextUtils.isEmpty(defaultOfflineMessage)) { + //need to read it from sharedPreferences + SharedPreferences config = this.getApplicationContext().getSharedPreferences(PREFS_NAME,0); + if (config != null) { + shouldShowOfflineMessage = config.getBoolean(SHOW_MESSAGE_PREF, true); + } + } + return shouldShowOfflineMessage; + } + + /** + * Gets "defaultnotificationmessage" config option + * + * @return returns default message provided by user in cofing.xml/sharedPreferences + */ + private String defaultMessageTextInNotification() { + //check if have cached copy of this option + if (TextUtils.isEmpty(defaultOfflineMessage)) { + SharedPreferences config = this.getApplicationContext().getSharedPreferences(PREFS_NAME,0); + if (config != null) { + defaultOfflineMessage = config.getString(DEFAULT_MESSAGE_PREF, DEFAULT_MESSAGE_TEXT); + } + } + return defaultOfflineMessage; + } } diff --git a/src/amazon/PushPlugin.java b/src/amazon/PushPlugin.java index 9dd9be4f..8c530219 100644 --- a/src/amazon/PushPlugin.java +++ b/src/amazon/PushPlugin.java @@ -50,10 +50,9 @@ public class PushPlugin extends CordovaPlugin { private static CordovaWebView webview = null; private static String notificationHandlerCallBack; private static boolean isForeground = false; - private static boolean showOfflineMessage = false; - private static String defaultOfflineMessage = null; private static Bundle gCachedExtras = null; - + + public static final String REGISTER = "register"; public static final String UNREGISTER = "unregister"; public static final String MESSAGE = "message"; @@ -93,12 +92,7 @@ public void initialize(CordovaInterface cordova, CordovaWebView webView) { activity = (CordovaActivity) cordova.getActivity(); webview = this.webView; isForeground = true; - if (activity != null) { - showOfflineMessage = ((CordovaActivity) activity) - .getBooleanProperty("showmessageinnotification", false); - defaultOfflineMessage = ((CordovaActivity) activity) - .getStringProperty("defaultnotificationmessage", null); - } + ADMMessageHandler.saveConfigOptions(activity); } else { LOG.e(TAG, NON_AMAZON_DEVICE_ERROR); } @@ -205,24 +199,6 @@ public boolean execute(final String request, final JSONArray args, return false; } - /** - * Gets "shownotificationmessage" config option - * - * @return returns boolean- true is shownotificationmessage is set to true in config.xml otherwise false - */ - public static boolean showMessageInNotificationCenter() { - return showOfflineMessage; - } - - /** - * Gets "defaultnotificationmessage" config option - * - * @return returns default message provided by user in cofing.xml - */ - public static String defaultNotificationMessage() { - return defaultOfflineMessage; - } - /** * Checks if any bundle extras were cached while app was not running * From 76fde26c3106f24d96dfda567e871f8e072788c5 Mon Sep 17 00:00:00 2001 From: Digvijay Dalapathi Date: Fri, 4 Apr 2014 14:54:45 -0700 Subject: [PATCH 108/133] Update error message for Otter1 where ADM is not supported JIRA: https://issues.labcollab.net/browse/ATLS-1064 cr https://cr.amazon.com/r/2292352/ --- src/amazon/PushPlugin.java | 18 +++++++++++++++--- 1 file changed, 15 insertions(+), 3 deletions(-) diff --git a/src/amazon/PushPlugin.java b/src/amazon/PushPlugin.java index 8c530219..b45a1d58 100644 --- a/src/amazon/PushPlugin.java +++ b/src/amazon/PushPlugin.java @@ -63,13 +63,15 @@ public class PushPlugin extends CordovaPlugin { public static final String REG_ID = "regid"; public static final String COLDSTART = "coldstart"; - private static final String NON_AMAZON_DEVICE_ERROR = "PushNotifications using Amazon Device Messaging is only supported on Kindle Fire devices."; + private static final String NON_AMAZON_DEVICE_ERROR = "PushNotifications using Amazon Device Messaging is only supported on Kindle Fire devices (2nd Generation and Later only)."; private static final String ADM_NOT_SUPPORTED_ERROR = "Amazon Device Messaging is not supported on this device."; private static final String REGISTER_OPTIONS_NULL = "Register options are not specified."; private static final String ECB_NOT_SPECIFIED = "ecb(eventcallback) option is not specified in register()."; private static final String ECB_NAME_NOT_SPECIFIED = "ecb(eventcallback) value is missing in options for register()."; private static final String REGISTRATION_SUCCESS_RESPONSE = "Registration started..."; private static final String UNREGISTRATION_SUCCESS_RESPONSE = "Unregistration started..."; + + private static final String MODEL_FIRST_GEN = "Kindle Fire"; public enum ADMReadiness { INITIALIZED, NON_AMAZON_DEVICE, ADM_NOT_SUPPORTED @@ -87,7 +89,8 @@ public enum ADMReadiness { @Override public void initialize(CordovaInterface cordova, CordovaWebView webView) { super.initialize(cordova, webView); - if (this.isAmazonDevice()) { + // Initialize only for Amazon devices 2nd Generation and later + if (this.isAmazonDevice() && !isFirstGenKindleFireDevice()) { adm = new ADM(cordova.getActivity()); activity = (CordovaActivity) cordova.getActivity(); webview = this.webView; @@ -107,7 +110,15 @@ private boolean isAmazonDevice() { String deviceMaker = android.os.Build.MANUFACTURER; return deviceMaker.equalsIgnoreCase("Amazon"); } - + + /** + * Check if device is First generation Kindle + * + * @return if device is First generation Kindle + */ + private static boolean isFirstGenKindleFireDevice() { + return android.os.Build.MODEL.equals(MODEL_FIRST_GEN); + } /** * Checks if ADM is available and supported - could be one of three 1. Non Amazon device, hence no ADM support 2. * ADM is not supported on this Kindle device (1st generation) 3. ADM is successfully initialized and ready to be @@ -413,3 +424,4 @@ private static JSONObject convertBundleToJson(Bundle extras) { } } + From 34b11b64ab07dbbcc086080fcf2f0c5876f323a5 Mon Sep 17 00:00:00 2001 From: Archana Naik Date: Tue, 8 Apr 2014 13:44:15 -0700 Subject: [PATCH 109/133] HTML decoding the message before adding it to notification. --- src/amazon/ADMMessageHandler.java | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/src/amazon/ADMMessageHandler.java b/src/amazon/ADMMessageHandler.java index cc8f39b4..b68a3c24 100644 --- a/src/amazon/ADMMessageHandler.java +++ b/src/amazon/ADMMessageHandler.java @@ -25,6 +25,7 @@ import android.content.Intent; import android.content.SharedPreferences; import android.os.Bundle; +import android.text.Html; import android.text.TextUtils; import android.util.Log; import android.app.Notification.Builder; @@ -133,7 +134,7 @@ protected void onMessage(final Intent intent) { // Extract the payload from the message Bundle extras = intent.getExtras(); - if (extras != null) { + if (extras != null && (extras.getString(PushPlugin.MESSAGE) != null)) { // if we are in the foreground, just surface the payload, else post // it to the statusbar if (PushPlugin.isInForeground()) { @@ -174,7 +175,8 @@ public void createNotification(Context context, Bundle extras) { .setContentIntent(contentIntent); if (this.shouldShowMessageInNotification()) { - notificationBuilder.setContentText(extras.getString(PushPlugin.MESSAGE)); + String message = extras.getString(PushPlugin.MESSAGE); + notificationBuilder.setContentText(Html.fromHtml(message).toString()); } else { notificationBuilder.setContentText(this.defaultMessageTextInNotification()); } From 3cee78ab130c90f6b39842919c64e82e5faa708a Mon Sep 17 00:00:00 2001 From: Archana Naik Date: Thu, 10 Apr 2014 07:02:15 -0700 Subject: [PATCH 110/133] Updated event names for the callback so existing sample code works with both android and amazon-fireos --- Example/www/index.html | 8 ++++++-- src/amazon/ADMMessageHandler.java | 4 ++-- src/amazon/PushPlugin.java | 4 +++- 3 files changed, 11 insertions(+), 5 deletions(-) diff --git a/Example/www/index.html b/Example/www/index.html index 681e9e72..9ec8dc38 100755 --- a/Example/www/index.html +++ b/Example/www/index.html @@ -36,8 +36,9 @@ try { pushNotification = window.plugins.pushNotification; - if (device.platform == 'android' || device.platform == 'Android') { - $("#app-status-ul").append('
  • registering android
    • '); + if (device.platform == 'android' || device.platform == 'Android' || + device.platform == 'amazon-fireos' ) { + $("#app-status-ul").append('
  • registering ' + device.platform + '
    • '); pushNotification.register(successHandler, errorHandler, {"senderID":"661780372179","ecb":"onNotificationGCM"}); // required! } else { $("#app-status-ul").append('
  • registering iOS
    • '); @@ -105,7 +106,10 @@ } $("#app-status-ul").append('
  • MESSAGE -> MSG: ' + e.payload.message + '
    • '); + //android only $("#app-status-ul").append('
  • MESSAGE -> MSGCNT: ' + e.payload.msgcnt + '
    • '); + //amazon-fireos only + $("#app-status-ul").append('
  • MESSAGE -> TIMESTAMP: ' + e.payload.timeStamp + '
    • '); break; case 'error': diff --git a/src/amazon/ADMMessageHandler.java b/src/amazon/ADMMessageHandler.java index b68a3c24..7fe79df5 100644 --- a/src/amazon/ADMMessageHandler.java +++ b/src/amazon/ADMMessageHandler.java @@ -96,7 +96,7 @@ protected void onRegistered(final String newRegistrationId) { // we fire the register event in the web app, register handler should // fire to send the registration ID to your server via a header key/value pair over HTTP.(AJAX) - PushPlugin.sendRegistrationIdWithEvent(PushPlugin.REGISTER, + PushPlugin.sendRegistrationIdWithEvent(PushPlugin.REGISTER_EVENT, newRegistrationId); } @@ -105,7 +105,7 @@ protected void onRegistered(final String newRegistrationId) { protected void onUnregistered(final String registrationId) { // If your app is unregistered on this device, inform your server that // this app instance is no longer a valid target for messages. - PushPlugin.sendRegistrationIdWithEvent(PushPlugin.UNREGISTER, + PushPlugin.sendRegistrationIdWithEvent(PushPlugin.UNREGISTER_EVENT, registrationId); } diff --git a/src/amazon/PushPlugin.java b/src/amazon/PushPlugin.java index b45a1d58..1d610cde 100644 --- a/src/amazon/PushPlugin.java +++ b/src/amazon/PushPlugin.java @@ -55,6 +55,8 @@ public class PushPlugin extends CordovaPlugin { public static final String REGISTER = "register"; public static final String UNREGISTER = "unregister"; + public static final String REGISTER_EVENT = "registered"; + public static final String UNREGISTER_EVENT = "unregistered"; public static final String MESSAGE = "message"; public static final String ECB = "ecb"; public static final String EVENT = "event"; @@ -185,7 +187,7 @@ public boolean execute(final String request, final JSONArray args, if (regId == null) { adm.startRegister(); } else { - sendRegistrationIdWithEvent(REGISTER, regId); + sendRegistrationIdWithEvent(REGISTER_EVENT, regId); } // see if there are any messages while app was in background and From c1c8a8d285a6066504ffc93304ab6ed94d90a15d Mon Sep 17 00:00:00 2001 From: Archana Naik Date: Fri, 21 Mar 2014 14:03:21 -0700 Subject: [PATCH 111/133] Added amazon-fireos platform. --- plugin.xml | 46 +++- src/amazon/ADMHandlerActivity.java | 69 +++++ src/amazon/ADMMessageHandler.java | 217 +++++++++++++++ src/amazon/PushPlugin.java | 420 +++++++++++++++++++++++++++++ 4 files changed, 751 insertions(+), 1 deletion(-) create mode 100644 src/amazon/ADMHandlerActivity.java create mode 100644 src/amazon/ADMMessageHandler.java create mode 100644 src/amazon/PushPlugin.java diff --git a/plugin.xml b/plugin.xml index 61873231..288fd7f9 100755 --- a/plugin.xml +++ b/plugin.xml @@ -17,7 +17,7 @@ MIT - + @@ -64,6 +64,50 @@     + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/src/amazon/ADMHandlerActivity.java b/src/amazon/ADMHandlerActivity.java new file mode 100644 index 00000000..14ceece2 --- /dev/null +++ b/src/amazon/ADMHandlerActivity.java @@ -0,0 +1,69 @@ +/* + * Copyright 2014 Amazon.com, Inc. or its affiliates. All Rights Reserved. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package com.amazon.cordova.plugin; + +import android.app.Activity; +import android.content.Intent; +import android.content.pm.PackageManager; +import android.os.Bundle; + +public class ADMHandlerActivity extends Activity { + + /* + * this activity will be started if the user touches a notification that we own. We send it's data off to the push + * plugin for processing. If needed, we boot up the main activity to kickstart the application. + * @see android.app.Activity#onCreate(android.os.Bundle) + */ + @Override + public void onCreate(Bundle savedInstanceState) { + super.onCreate(savedInstanceState); + boolean isPushPluginActive = PushPlugin.isActive(); + processPushBundle(isPushPluginActive); + finish(); + if (!isPushPluginActive) { + forceMainActivityReload(); + } + } + + /** + * Takes the pushBundle extras from the intent, and sends it through to the PushPlugin for processing. + */ + private void processPushBundle(boolean isCordovaActive) { + Bundle extras = getIntent().getExtras(); + + if (extras != null) { + Bundle originalExtras = extras + .getBundle(ADMMessageHandler.PUSH_BUNDLE); + ADMMessageHandler.cancelNotification(this); + PushPlugin.sendExtras(originalExtras); + // clean up the noticiationIntent extra + ADMMessageHandler.cleanupNotificationIntent(); + } + } + + /** + * Forces the main activity to re-launch if it's unloaded. + */ + private void forceMainActivityReload(/* Bundle extras */) { + PackageManager pm = getPackageManager(); + Intent launchIntent = pm + .getLaunchIntentForPackage(getApplicationContext() + .getPackageName()); + startActivity(launchIntent); + } + +} diff --git a/src/amazon/ADMMessageHandler.java b/src/amazon/ADMMessageHandler.java new file mode 100644 index 00000000..d1852c6d --- /dev/null +++ b/src/amazon/ADMMessageHandler.java @@ -0,0 +1,217 @@ +/* + * Copyright 2014 Amazon.com, Inc. or its affiliates. All Rights Reserved. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package com.amazon.cordova.plugin; + +import org.json.JSONObject; +import android.app.Notification; +import android.app.NotificationManager; +import android.app.PendingIntent; +import android.content.Context; +import android.content.Intent; +import android.os.Bundle; +import android.util.Log; +import android.app.Notification.Builder; + +import com.amazon.device.messaging.ADMMessageHandlerBase; +import com.amazon.device.messaging.ADMMessageReceiver; + +/** + * The ADMMessageHandler class receives messages sent by ADM via the receiver. + */ + +public class ADMMessageHandler extends ADMMessageHandlerBase { + + private static final String TAG = "ADMMessageHandler"; + private static final String ERROR_EVENT = "error"; + public static final String PUSH_BUNDLE = "pushBundle"; + + // An identifier for ADM notification unique within your application + // It allows you to update the same notification later on + public static final int NOTIFICATION_ID = 519; + static Intent notificationIntent = null; + + /** + * Class constructor. + */ + public ADMMessageHandler() { + super(ADMMessageHandler.class.getName()); + } + + /** + * Class constructor, including the className argument. + * + * @param className + * The name of the class. + */ + public ADMMessageHandler(final String className) { + super(className); + } + + /** + * The Receiver class listens for messages from ADM and forwards them to the ADMMessageHandler class. + */ + public static class Receiver extends ADMMessageReceiver { + public Receiver() { + super(ADMMessageHandler.class); + + } + + // Nothing else is required here; your broadcast receiver automatically + // forwards intents to your service for processing. + } + + /** {@inheritDoc} */ + @Override + protected void onRegistered(final String newRegistrationId) { + // You start the registration process by calling startRegister() in your Main Activity. + // When the registration ID is ready, ADM calls onRegistered() + // on your app. Transmit the passed-in registration ID to your server, so + // your server can send messages to this app instance. onRegistered() is also + // called if your registration ID is rotated or changed for any reason; + // your app should pass the new registration ID to your server if this occurs. + + // we fire the register event in the web app, register handler should + // fire to send the registration ID to your server via a header key/value pair over HTTP.(AJAX) + PushPlugin.sendRegistrationIdWithEvent(PushPlugin.REGISTER, + newRegistrationId); + } + + /** {@inheritDoc} */ + @Override + protected void onUnregistered(final String registrationId) { + // If your app is unregistered on this device, inform your server that + // this app instance is no longer a valid target for messages. + PushPlugin.sendRegistrationIdWithEvent(PushPlugin.UNREGISTER, + registrationId); + } + + /** {@inheritDoc} */ + @Override + protected void onRegistrationError(final String errorId) { + // You should consider a registration error fatal. In response, your app + // may degrade gracefully, or you may wish to notify the user that this part + // of your app's functionality is not available. + try { + JSONObject json; + json = new JSONObject().put(PushPlugin.EVENT, ERROR_EVENT); + json.put(PushPlugin.REG_ID, errorId); + + PushPlugin.sendJavascript(json); + } catch (Exception e) { + Log.getStackTraceString(e); + } + } + + /** {@inheritDoc} */ + @Override + protected void onMessage(final Intent intent) { + // Extract the message content from the set of extras attached to + // the com.amazon.device.messaging.intent.RECEIVE intent. + + // Extract the payload from the message + Bundle extras = intent.getExtras(); + if (extras != null) { + // if we are in the foreground, just surface the payload, else post + // it to the statusbar + if (PushPlugin.isInForeground()) { + extras.putBoolean(PushPlugin.FOREGROUND, true); + PushPlugin.sendExtras(extras); + } else { + extras.putBoolean(PushPlugin.FOREGROUND, false); + createNotification(this, extras); + } + } + } + + /** + * Creates a notification when app is not running or is not in foreground. It puts the message info into the Intent + * extra + * + * @param context + * @param extras + */ + public void createNotification(Context context, Bundle extras) { + NotificationManager mNotificationManager = (NotificationManager) getSystemService(Context.NOTIFICATION_SERVICE); + String appName = getAppName(this); + + // reuse the intent so that we can combine multiple messages into extra + if (notificationIntent == null) { + notificationIntent = new Intent(this, ADMHandlerActivity.class); + } + notificationIntent.addFlags(Intent.FLAG_ACTIVITY_SINGLE_TOP + | Intent.FLAG_ACTIVITY_CLEAR_TOP); + notificationIntent.putExtra("pushBundle", extras); + + PendingIntent contentIntent = PendingIntent.getActivity(this, 0, + notificationIntent, PendingIntent.FLAG_UPDATE_CURRENT); + + final Builder mBuilder = new Notification.Builder(context); + mBuilder.setSmallIcon(context.getApplicationInfo().icon) + .setWhen(System.currentTimeMillis()) + .setContentIntent(contentIntent); + + if (PushPlugin.showMessageInNotificationCenter()) { + mBuilder.setContentText(extras.getString("message")); + } else { + mBuilder.setContentText(PushPlugin.defaultNotificationMessage()); + } + + String title = appName; + mBuilder.setContentTitle(title).setTicker(title); + mBuilder.setAutoCancel(true); + // Because the ID remains unchanged, the existing notification is updated. + mNotificationManager.notify((String) appName, NOTIFICATION_ID, + mBuilder.build()); + } + + public static void cancelNotification(Context context) { + NotificationManager mNotificationManager = (NotificationManager) context + .getSystemService(Context.NOTIFICATION_SERVICE); + mNotificationManager.cancel((String) getAppName(context), + NOTIFICATION_ID); + } + + private static String getAppName(Context context) { + CharSequence appName = context.getPackageManager().getApplicationLabel( + context.getApplicationInfo()); + return (String) appName; + } + + // clean up the message in the intent + static void cleanupNotificationIntent() { + if (notificationIntent != null) { + Bundle pushBundle = notificationIntent.getExtras().getBundle( + PUSH_BUNDLE); + if (pushBundle != null) { + pushBundle.clear(); + } + + } + } + + static Bundle getOfflineMessage() { + Bundle pushBundle = null; + if (notificationIntent != null) { + pushBundle = notificationIntent.getExtras().getBundle(PUSH_BUNDLE); + if (pushBundle.isEmpty()) { + pushBundle = null; + } + } + return pushBundle; + } + +} diff --git a/src/amazon/PushPlugin.java b/src/amazon/PushPlugin.java new file mode 100644 index 00000000..4ab5841c --- /dev/null +++ b/src/amazon/PushPlugin.java @@ -0,0 +1,420 @@ +/* + * Copyright 2014 Amazon.com, Inc. or its affiliates. All Rights Reserved. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package com.amazon.cordova.plugin; + +import org.apache.cordova.CallbackContext; +import org.apache.cordova.CordovaInterface; +import org.apache.cordova.CordovaPlugin; +import org.apache.cordova.CordovaWebView; +import org.apache.cordova.CordovaActivity; +import org.json.JSONArray; +import org.json.JSONException; +import com.amazon.device.messaging.ADM; +import android.app.Activity; +import android.os.Bundle; +import android.text.TextUtils; +import android.util.Log; + +import java.util.Iterator; + +import org.json.JSONObject; + +public class PushPlugin extends CordovaPlugin { + + private static String TAG = "PushPlugin"; + /** + * @uml.property name="adm" + * @uml.associationEnd + */ + private ADM adm = null; + /** + * @uml.property name="activity" + * @uml.associationEnd + */ + private Activity activity = null; + private static CordovaWebView webview = null; + private static String notificationHandlerCallBack; + private static boolean isForeground = false; + private static boolean showOfflineMessage = false; + private static String defaultOfflineMessage = null; + private static Bundle gCachedExtras = null; + + public static final String REGISTER = "register"; + public static final String UNREGISTER = "unregister"; + public static final String MESSAGE = "message"; + public static final String ECB = "ecb"; + public static final String EVENT = "event"; + public static final String PAYLOAD = "payload"; + public static final String FOREGROUND = "foreground"; + public static final String REG_ID = "regid"; + public static final String COLDSTART = "coldstart"; + + private static final String NON_AMAZON_DEVICE_ERROR = "PushNotifications using Amazon Device Messaging is only supported on Kindle Fire devices."; + private static final String ADM_NOT_SUPPORTED_ERROR = "Amazon Device Messaging is not supported on this device."; + private static final String REGISTER_OPTIONS_NULL = "Register options are not specified."; + private static final String ECB_NOT_SPECIFIED = "ecb(eventcallback) option is not specified in register()."; + private static final String ECB_NAME_NOT_SPECIFIED = "ecb(eventcallback) value is missing in options for register()."; + private static final String REGISTRATION_SUCCESS_RESPONSE = "Registration started..."; + private static final String UNREGISTRATION_SUCCESS_RESPONSE = "Unregistration started..."; + + public enum ADMReadiness { + INITIALIZED, NON_AMAZON_DEVICE, ADM_NOT_SUPPORTED + } + + /** + * Sets the context of the Command. This can then be used to do things like get file paths associated with the + * Activity. + * + * @param cordova + * The context of the main Activity. + * @param webView + * The associated CordovaWebView. + */ + @Override + public void initialize(CordovaInterface cordova, CordovaWebView webView) { + super.initialize(cordova, webView); + if (this.isAmazonDevice()) { + adm = new ADM(cordova.getActivity()); + activity = (CordovaActivity) cordova.getActivity(); + webview = this.webView; + isForeground = true; + if (activity != null) { + showOfflineMessage = ((CordovaActivity) activity) + .getBooleanProperty("showmessageinnotification", false); + defaultOfflineMessage = ((CordovaActivity) activity) + .getStringProperty("defaultnotificationmessage", null); + } + } else { + Log.e(TAG, NON_AMAZON_DEVICE_ERROR); + } + } + + /** + * Checks if current device manufacturer is Amazon by using android.os.Build.MANUFACTURER property + * + * @return returns true for all Kindle Fire OS devices. + */ + private boolean isAmazonDevice() { + String deviceMaker = android.os.Build.MANUFACTURER; + return deviceMaker.equalsIgnoreCase("Amazon"); + } + + /** + * Checks if ADM is available and supported - could be one of three 1. Non Amazon device, hence no ADM support 2. + * ADM is not supported on this Kindle device (1st generation) 3. ADM is successfully initialized and ready to be + * used + * + * @return returns true for all Kindle Fire OS devices. + */ + public ADMReadiness isPushPluginReady() { + if (adm == null) { + return ADMReadiness.NON_AMAZON_DEVICE; + } else if (!adm.isSupported()) { + return ADMReadiness.ADM_NOT_SUPPORTED; + } + return ADMReadiness.INITIALIZED; + } + + /** + * @see Plugin#execute(String, JSONArray, String) + */ + @Override + public boolean execute(final String request, final JSONArray args, + CallbackContext callbackContext) throws JSONException { + try { + + // check ADM readiness + ADMReadiness ready = isPushPluginReady(); + if (ready == ADMReadiness.NON_AMAZON_DEVICE) { + callbackContext.error(NON_AMAZON_DEVICE_ERROR); + return false; + } else if (ready == ADMReadiness.ADM_NOT_SUPPORTED) { + callbackContext.error(ADM_NOT_SUPPORTED_ERROR); + return false; + } else if (callbackContext == null) { + Log.e(TAG, + "CallbackConext is null. Notification to WebView is not possible. Can not proceed."); + return false; + } + + // Process the request here + if (REGISTER.equals(request)) { + + if (args == null) { + Log.e(TAG, REGISTER_OPTIONS_NULL); + callbackContext.error(REGISTER_OPTIONS_NULL); + return false; + } + + // parse args to get eventcallback name + if (args.isNull(0)) { + Log.e(TAG, ECB_NOT_SPECIFIED); + callbackContext.error(ECB_NOT_SPECIFIED); + return false; + } + + JSONObject jo = args.getJSONObject(0); + if (jo.getString("ecb").isEmpty()) { + Log.e(TAG, ECB_NAME_NOT_SPECIFIED); + callbackContext.error(ECB_NAME_NOT_SPECIFIED); + return false; + } + callbackContext.success(REGISTRATION_SUCCESS_RESPONSE); + notificationHandlerCallBack = jo.getString(ECB); + String regId = adm.getRegistrationId(); + Log.d(TAG, "regId = " + regId); + if (regId == null) { + adm.startRegister(); + } else { + sendRegistrationIdWithEvent(REGISTER, regId); + } + + // see if there are any messages while app was in background and + // launched via app icon + if (cachedExtrasAvailable()) { + Log.v(TAG, "sending cached extras"); + sendExtras(gCachedExtras); + gCachedExtras = null; + } else { + deliverOfflineMessages(); + } + // Clear the notification if any exists + ADMMessageHandler.cancelNotification(activity); + return true; + + } else if (UNREGISTER.equals(request)) { + adm.startUnregister(); + callbackContext.success(UNREGISTRATION_SUCCESS_RESPONSE); + return true; + } else { + Log.e(TAG, "Invalid action : " + request); + callbackContext.error("Invalid action : " + request); + return false; + } + } catch (final Exception e) { + callbackContext.error(e.getMessage()); + } + + return false; + } + + /** + * Gets "shownotificationmessage" config option + * + * @return returns boolean- true is shownotificationmessage is set to true in config.xml otherwise false + */ + public static boolean showMessageInNotificationCenter() { + return showOfflineMessage; + } + + /** + * Gets "defaultnotificationmessage" config option + * + * @return returns default message provided by user in cofing.xml + */ + public static String defaultNotificationMessage() { + return defaultOfflineMessage; + } + + /** + * Checks if any bundle extras were cached while app was not running + * + * @return returns tru if cached Bundle is not null otherwise true. + */ + public boolean cachedExtrasAvailable() { + return (gCachedExtras != null); + } + + /** + * Checks if offline message was pending to be delivered from notificationIntent. Sends it to webView(JS) if it is + * and also clears notification from the NotificaitonCenter. + */ + private void deliverOfflineMessages() { + Bundle pushBundle = ADMMessageHandler.getOfflineMessage(); + if (pushBundle != null) { + Log.d(TAG,"Sending offline message..."); + sendExtras(pushBundle); + ADMMessageHandler.cleanupNotificationIntent(); + } + } + + // lifecyle callback to set the isForeground + @Override + public void onPause(boolean multitasking) { + Log.d(TAG, "onPause"); + super.onPause(multitasking); + isForeground = false; + } + + @Override + public void onResume(boolean multitasking) { + Log.d(TAG, "onResume"); + super.onResume(multitasking); + isForeground = true; + } + + @Override + public void onDestroy() { + Log.d(TAG, "onDestroy"); + super.onDestroy(); + isForeground = false; + webview = null; + notificationHandlerCallBack = null; + } + + /** + * Indicates if app is in foreground or not. + * + * @return returns true if app is running otherwise false. + */ + public static boolean isInForeground() { + return isForeground; + } + + /** + * Indicates if app is killed or not + * + * @return returns true if app is killed otherwise false. + */ + public static boolean isActive() { + return webview != null; + } + + /** + * Sends register/unregiste events to JS + * + * @param String + * - eventName - "register", "unregister" + * @param String + * - valid registrationId + */ + public static void sendRegistrationIdWithEvent(String event, + String registrationId) { + if (TextUtils.isEmpty(event) || TextUtils.isEmpty(registrationId)) { + return; + } + try { + JSONObject json; + json = new JSONObject().put(EVENT, event); + json.put(REG_ID, registrationId); + + sendJavascript(json); + } catch (Exception e) { + Log.getStackTraceString(e); + } + } + + /** + * Sends events to JS using cordova nativeToJS bridge. + * + * @param JSONObject + */ + public static boolean sendJavascript(JSONObject json) { + if (json == null) { + Log.i(TAG, "JSON object is empty. Nothing to send to JS."); + return true; + } + + if (notificationHandlerCallBack != null && webview != null) { + String jsToSend = "javascript:" + notificationHandlerCallBack + "(" + + json.toString() + ")"; + Log.v(TAG, "sendJavascript: " + jsToSend); + webview.sendJavascript(jsToSend); + return true; + } + return false; + } + + /* + * Sends the pushbundle extras to the client application. If the client application isn't currently active, it is + * cached for later processing. + */ + public static void sendExtras(Bundle extras) { + if (extras != null) { + if (!sendJavascript(convertBundleToJson(extras))) { + Log.v(TAG, + "sendExtras: could not send to JS. Caching extras to send at a later time."); + gCachedExtras = extras; + } + } + } + + // serializes a bundle to JSON. + private static JSONObject convertBundleToJson(Bundle extras) { + if (extras == null) { + return null; + } + + try { + JSONObject json; + json = new JSONObject().put(EVENT, MESSAGE); + + JSONObject jsondata = new JSONObject(); + Iterator it = extras.keySet().iterator(); + while (it.hasNext()) { + String key = it.next(); + Object value = extras.get(key); + + // System data from Android + if (key.equals(FOREGROUND)) { + json.put(key, extras.getBoolean(FOREGROUND)); + } else if (key.equals(COLDSTART)) { + json.put(key, extras.getBoolean(COLDSTART)); + } else { + // we encourage put the message content into message value + // when server send out notification + if (key.equals(MESSAGE)) { + json.put(key, value); + } + + if (value instanceof String) { + // Try to figure out if the value is another JSON object + + String strValue = (String) value; + if (strValue.startsWith("{")) { + try { + JSONObject json2 = new JSONObject(strValue); + jsondata.put(key, json2); + } catch (Exception e) { + jsondata.put(key, value); + } + // Try to figure out if the value is another JSON + // array + } else if (strValue.startsWith("[")) { + try { + JSONArray json2 = new JSONArray(strValue); + jsondata.put(key, json2); + } catch (Exception e) { + jsondata.put(key, value); + } + } else { + jsondata.put(key, value); + } + } + } // while + } + json.put(PAYLOAD, jsondata); + Log.v(TAG, "extrasToJSON: " + json.toString()); + + return json; + } catch (JSONException e) { + Log.e(TAG, "extrasToJSON: JSON exception"); + } + return null; + } + +} From da3c5f937de457509aad3c0d6a68b13c808c9621 Mon Sep 17 00:00:00 2001 From: Archana Naik Date: Wed, 26 Mar 2014 09:23:15 -0700 Subject: [PATCH 112/133] Updated readme file with Fire OS details. Added server script and readme for Amazon Device Messaging. --- Example/server/PushADM_README.txt | 40 +++ Example/server/pushADM.py | 431 ++++++++++++++++++++++++++++++ README.md | 144 ++++++---- 3 files changed, 566 insertions(+), 49 deletions(-) create mode 100644 Example/server/PushADM_README.txt create mode 100644 Example/server/pushADM.py diff --git a/Example/server/PushADM_README.txt b/Example/server/PushADM_README.txt new file mode 100644 index 00000000..d149e02c --- /dev/null +++ b/Example/server/PushADM_README.txt @@ -0,0 +1,40 @@ +In this document, "your server" refers to the server-side software +that you must implement to use Amazon Device Messaging(ADM - https://developer.amazon.com/sdk/adm.html) services. + +== Server == + +Server: A self-contained web sample application written as a Python +script. The web application simulates a range of tasks your server +could implement to send messages to client applications. The server +runs on port 80 by default. + +There are two main classes in server.py: +SampleWebApp: handles the logic for interacting with ADM +services, as well as keeping a list of all devices that have been +registered with the server. + +ServerHandler: handles the minimal tasks required to process incoming +and outgoing web requests and responses. It also generates a very +simple html GUI. + +The web application exposes the following routes: +/: displays 'Server running'. +/register: accepts registration IDs from instances of your app and +registers them with your server. +/show-devices: returns html GUI that displayes all the devices registered +with your server and that allows you to send custom messages to them. +/sendmsg: Sends a message to ADM Servers for relaying to an instance of +your app. + +To run the server perform the following actions: +1. Change the value of PORT at the beginning of server.py to the port you + would like the server to listen on. Make sure this port is opened and + accessible before proceeding. +2. Change the values of PROD_CLIENT_ID and PROD_CLIENT_SECRET to the ones + you received from Amazon. These are also located at the beggining of + server.py +3. Run from the command line: + > python server.py +4. See it in browser: http://localhost:port +5. Register a device: http://localhost:4000/register?device=device_id +6. List registered devices: http://localhost:4000/show-devices diff --git a/Example/server/pushADM.py b/Example/server/pushADM.py new file mode 100644 index 00000000..f5480388 --- /dev/null +++ b/Example/server/pushADM.py @@ -0,0 +1,431 @@ +# +# Copyright 2014 Amazon.com, Inc. or its affiliates. All Rights Reserved. +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. +# + +# +# To run the server, perform the following actions: +# 1. Change the value of PORT to the port you would like the server +# to listen on. Make sure this port is opened and accessible before proceeding. +# 2. Change the values of PROD_CLIENT_ID and PROD_CLIENT_SECRET to the ones +# you received from ADM. +# 3. Run +# > python server.py +# + +import SimpleHTTPServer +import SocketServer +import logging +from urlparse import urlparse,parse_qs +import json +import urllib +import urllib2 +import threading +import datetime +import hashlib +import base64 + +# Port on which your server will be listening. +PORT = 4000 + +# Client ID received from ADM. +PROD_CLIENT_ID = "$CLIENT_ID" + +# Client secret received from ADM. +PROD_CLIENT_SECRET = "$CLIENT_SECRET" + +# Oauth2.0 token endpoint. This endpoint is used to request authorization tokens. +AMAZON_TOKEN_URL = "https://api.amazon.com/auth/O2/token" + +# ADM services endpoint. This endpoint is used to perform ADM requests. +AMAZON_ADM_URL = "https://api.amazon.com/messaging/registrations/" + +# Data used to request authorization tokens. +ACCESS_TOKEN_REQUEST_DATA = { + "scope" : "messaging:push", + "grant_type" : "client_credentials", + "client_secret" : PROD_CLIENT_SECRET, + "client_id": PROD_CLIENT_ID + } + +# JSON used to perform EnqueueMessage requests. +JSON_MSG_REQUEST = { + "data" : {}, + "consolidationKey" : "", + "expiresAfter" : "", + "md5" : "" + } + +class SampleADMWebapp: + """ + SampleADMWebapp is a class that handles the logic for sending messages to the ADM server + as well as the tasks involved in calling ADM services. + """ + def __init__(self): + """ + SampleADMWebapp constructor. + self.devices is a dictionary of registration IDs registered with your server. + self.token_lock is a lock which will be used to block execution on self.token_data. + self.token_data contains the data returned with an authorization token request response. + """ + self.devices = dict() + self.token_lock = threading.Lock() + self.request_token() + + def register_device(self, url_device): + """ + Registers an instance of our app with this web application and sends it a confirmation + message. The registration id is required to communicate with our app. + + Args: + url_device: A url path containing an app's instance registration ID. + + Returns: + {'status': 'ok'} + """ + params = parse_qs(url_device) + device = params['device'][0] + self.devices[device] = device + print 'registering device ' + device + self.send_message_to_device("You are registered", device, "Registration Confirmation", 3600) + return {'status': 'ok'} + + def unregister_device(self, url_device): + """ + Unregisters an instance of our app from this web application. + The registration ID associated with this app instance should no longer be used. + + Args: + url_device: A url path containing an app's instance registration ID. + + Returns: + {'status': 'ok'} + """ + params = parse_qs(url_device) + device = params['device'][0] + print 'unregistering device ' + device + if self.devices.has_key(device): + self.devices.pop(device) + return {'status': 'ok'} + + def query_devices(self): + """ + Returns: + The registration IDs registered with your server. + """ + return self.devices + + def send_message_to_device(self, message, device, consolidationKey, expiresAfter): + """ + Constructs and sends a request to ADM Servers to enqueue a message for delivery to a specific app instance. + Updates registration id if a newer one is received with the ADM server response. + + Args: + message: Message to send. + device: The registration ID the instance of the app to which the message is to be sent. + consolidationKey: An arbitrary string used to indicate that multiple messages are logically the same. + expiresAfter: The number of seconds that ADM must retain the message if the device is offline. + + Returns: + A message string representative of the outcome of the call. + """ + url = AMAZON_ADM_URL + device + '/messages' + req = urllib2.Request(url) + req.add_header('Content-Type', 'application/json') + req.add_header('Accept', 'application/json') + req.add_header('x-amzn-type-version', 'com.amazon.device.messaging.ADMMessage@1.0') + req.add_header('x-amzn-accept-type', 'com.amazon.device.messaging.ADMSendResult@1.0') + self.token_lock.acquire() + req.add_header('Authorization', "Bearer " + self.token_data['access_token']) + self.token_lock.release() + + timeStamp = str(datetime.datetime.now().isoformat(' ')) + JSON_MSG_REQUEST['data'] = {"message": message, "timeStamp": timeStamp} + JSON_MSG_REQUEST['consolidationKey'] = consolidationKey + JSON_MSG_REQUEST['expiresAfter'] = int(expiresAfter) + JSON_MSG_REQUEST['md5'] = self.calculate_checksum(JSON_MSG_REQUEST['data']) + print req.headers + print req.get_full_url() + print JSON_MSG_REQUEST + try: + # POST EnqueueMessage request to AMD Servers. + response = urllib2.urlopen(req,json.dumps(JSON_MSG_REQUEST)) + + # Retreiving Amazon ADM request ID. Include this with troubleshooting reports. + X_Amzn_RequestId = response.info().get('x-amzn-RequestId') + + # Retreiving the MD5 value computed by ADM servers. + MD5_from_ADM = response.info().get('x-amzn-data-md5') + print "ADM server md5_checksum " + MD5_from_ADM + + # Checking if the app's registration ID needs to be updated. + response_data = json.load(response) + canonical_reg_id = response_data['registrationID'] + if device != canonical_reg_id: + print "Updating registration Id" + if self.devices.has_key(device): + self.devices.pop(device) + self.devices[canonical_reg_id] = canonical_reg_id + return 'Message sent.' + except urllib2.HTTPError as e: + error_reason = json.load(e)['reason'] + if e.code == 400: + return 'Handle ' + str(e) + '. invalid input. Reason: ' + error_reason + elif e.code == 401: + return self.handle_invalid_token_error(e) + elif e.code == 403: + return 'Handle ' + str(e) + '. max rate exceeded. Reason: ' + error_reason + elif e.code == 413: + return 'Handle ' + str(e) + '. message greater than 6KB. Reason: ' + error_reason + elif e.code == 500: + return 'Handle ' + str(e) + '. internal server error' + elif e.code == 503: + return self.handle_server_temporarily_unavailable_error(e) + else: + return 'Message was not sent', str(e) + except urllib2.URLError as e: + return 'Message was not sent', 'URLError: ' + str(e.reason) + except urllib2.HTTPException as e: + return 'Message was not sent', 'HTTPException: ' + str(e) + except Exception as e: + return 'Message was not sent', 'Exception: ' + str(e) + + def handle_invalid_token_error(self, error): + """ + Handles 401 (invalid token error) raised in send_message_to_device(). + This assumes that the 401 error raised in send_message_to_device() + is due to an expired token. This won't help if the invalid token error + is caused for other reasons. + + Args: + error: HTTPError raised in send_message_to_device(). + + Returns: + 'Token refreshed. Please try again.' + """ + self.request_token() + return 'Token refreshed. Please try again.' + + def handle_server_temporarily_unavailable_error(self, error): + """ + Handles 503 (server temporarily unavailable) raised in send_message_to_device(). + 'Retry-After' header will either contain an integer in which case 'Retry-After' + is a delay of time in seconds or a date in HTTP format in which case + 'Retry-After' is the date and time at which it would be suggested to try again. + + Args: + error: HTTPError raised in send_message_to_device(). + + Returns: + A message detailing when the send_message_to_device request should be attempted again. + """ + retry_after = error.info().get('Retry-After') + if retry_after.isdigit(): + return 'Please retry in ' + retry_after + ' seconds' + else: + return 'Please retry at the following time: ' + retry_after + + def calculate_checksum(self, data): + """ + Computes MD5 checksum of the 'data' parameter as per the algorithm detailed + in the ADM documentation. + + Args: + data: a dictionary. + + Returns: + MD5 checksum of key/value pairs within data. + """ + md5_checksum = "" + utf8_data = dict() + utf8_keys = [] + + # Retreiving the list of keys in message. + message_keys = data.keys() + + # Converting data to UTF-8. + for key in message_keys: + utf8_keys.append(key.encode('utf-8')) + utf8_data[key.encode('utf-8')] = data[key].encode('utf-8') + + # UTF-8 sorting of the keys. + utf8_keys.sort() + utf8_string = "" + + # Concatenating the series of key-value pairs. + for key in utf8_keys: + utf8_string = utf8_string + key + utf8_string = utf8_string + ':' + utf8_string = utf8_string + utf8_data[key] + if key != utf8_keys[-1]: + utf8_string = utf8_string + ',' + + # Computing MD5 as per RFC 1321. + md5 = hashlib.md5(utf8_string).digest() + + # Base 64 encoding. + md5_checksum = base64.standard_b64encode(md5) + + print "App server md5_checksum " + md5_checksum + return md5_checksum + + def request_token(self): + """ + Requests and stores an access token from the OAuth2.0 Servers. + We must obtain an access token prior to sending a request to enqueue a message for delivery. + Also, when an access token expires, a new one is requested. + """ + print 'Requesting token' + req = urllib2.Request(AMAZON_TOKEN_URL) + req_data = urllib.urlencode(ACCESS_TOKEN_REQUEST_DATA) + print req_data, str(len(req_data)) + req.add_header('Content-Type', 'application/x-www-form-urlencoded') + + try: + self.token_lock.acquire() + + # POST access token request to OAuth2.0 Servers. + response = urllib2.urlopen(req, req_data) + + # Retreiving Amazon ADM request ID. Include this with troubleshooting reports. + X_Amzn_RequestId = response.info().get('x-amzn-RequestId') + + self.token_data = json.load(response) + self.token_lock.release() + + print 'Token acquired: ' + self.token_data['access_token'] + ' and valid for ' + \ + str(self.token_data['expires_in']) + ' seconds.' + response.close() + interval = int(self.token_data['expires_in']) + t = threading.Timer(interval, self.request_token) + t.daemon = True + t.start() + except urllib2.HTTPError as e: + self.token_lock.release() + error=json.load(e) + print 'Could not acquire token ', error + exit() + +class ServerHandler(SimpleHTTPServer.SimpleHTTPRequestHandler): + """ + Class ServerHandler performs the minimal tasks required to process + web requests coming from our clients, as well as outgoing responses. + """ + + def send_server_response(self, content_type, content): + """ + Sends your server's response. + + Args: + content_type: Content type of response to send (text/html or application/json). + content: Content to send back with the response. + """ + self.send_response(200) + self.send_header('Content-type', content_type) + self.send_header('Content-length', len(content)) + self.end_headers() + self.wfile.write(content) + self.wfile.close() + + def send_html_response(self, html): + """ + Sends an HTML response. + + Args: + html: HTML response to send. + """ + self.send_server_response('text/html', ""+html+"") + + def send_json_response(self, json): + """ + Sends a JSON response. + + Args: + json: JSON response to send. + """ + self.send_server_response('application/json', json) + + def do_GET(self): + """ + SimpleHTTPServer do_GET() implementation. + This method gets called when your server receives GET requests. + """ + self.route_request() + + def route_request(self): + """ + All the routes handled by our web application are handled here. + GUI HTML is generated here. + """ + query = urlparse(self.path).query + if self.path == "/": + server_running = 'Server running' + self.send_html_response(server_running) + elif self.path.startswith("/register"): + ret = theWebApp.register_device(query) + self.send_json_response(json.dumps(ret)) + elif self.path.startswith("/unregister"): + ret = theWebApp.unregister_device(query) + self.send_json_response(json.dumps(ret)) + elif self.path.startswith("/show-devices"): + devices = theWebApp.query_devices() + html = '' + html = html + '

    Select A Device And Send A Message

    ' + if len(devices) == 0: + html = html + '

    No devices registered with server

    ' + html = html + 'Please register a device by restarting the Amazon ADM Sample App or registering from within the app
    ' + else: + html = html + '
    ' + html = html + '' + for device in devices: + html = html + '' + html = html + '' + html = html + '' + html = html + '' + html = html + '' + html = html + '' + html = html + '' + html = html + '' + html = html + '' + html = html + '' + html = html + '' + html = html + '' + html = html + '' + html = html + '' + html = html + '' + html = html + '' + html = html + '
    '+device+'
    Message:
    Consolidation key:
    Expires after:
    ' + html = html + '
    ' + html = html + '' + self.send_html_response(html) + elif self.path.startswith("/sendmsg"): + device=parse_qs(query)['device'][0] + msg = parse_qs(query)['msg'][0] + consolidationKey = parse_qs(query)['consolidationKey'][0] + expiresAfter = parse_qs(query)['expiresAfter'][0] + response = theWebApp.send_message_to_device(msg, device, consolidationKey, expiresAfter) + print response + self.send_json_response(response) + else: + self.send_html_response("not found") + +# Instantiate a new global SampleADMWebapp. +theWebApp = SampleADMWebapp() + +# Instantiate a new ServerHandler and listen on port PORT. +httpd = SocketServer.TCPServer(("",PORT), ServerHandler) + +# Listen forever. +print "starting server in port ", PORT +httpd.serve_forever() diff --git a/README.md b/README.md index d644250e..e7188a2a 100644 --- a/README.md +++ b/README.md @@ -1,10 +1,10 @@ -# Cordova Push Notifications Plugin for Android, iOS and WP8 +# Cordova Push Notifications Plugin for Android, iOS, WP8 and Amazon Fire OS --- ## DESCRIPTION -This plugin is for use with [Cordova](http://incubator.apache.org/cordova/), and allows your application to receive push notifications on both Android and iOS devices. The Android implementation uses [Google's GCM (Google Cloud Messaging) service](http://developer.android.com/guide/google/gcm/index.html), whereas the iOS version is based on [Apple APNS Notifications](http://developer.apple.com/library/mac/#documentation/NetworkingInternet/Conceptual/RemoteNotificationsPG/ApplePushService/ApplePushService.html) +This plugin is for use with [Cordova](http://incubator.apache.org/cordova/), and allows your application to receive push notifications on Amazon Fire OS, Android and iOS devices. The Amazon Fire OS implementation uses [Amazon's ADM(Amazon Device Messaging) service](https://developer.amazon.com/sdk/adm.html), Android implementation uses [Google's GCM (Google Cloud Messaging) service](http://developer.android.com/guide/google/gcm/index.html) and the iOS version is based on [Apple APNS Notifications](http://developer.apple.com/library/mac/#documentation/NetworkingInternet/Conceptual/RemoteNotificationsPG/ApplePushService/ApplePushService.html) **Important** - Push notifications are intended for real devices. The registration process will fail on the iOS simulator. Notifications can be made to work on the Android Emulator. However, doing so requires installation of some helper libraries, as outlined [here,](http://www.androidhive.info/2012/10/android-push-notifications-using-google-cloud-messaging-gcm-php-and-mysql/) under the section titled "Installing helper libraries and setting up the Emulator". @@ -33,6 +33,57 @@ This plugin is for use with [Cordova](http://incubator.apache.org/cordova/), and OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. +## Manual Installation for Amazon Fire OS + +1) Copy the contents of **src/amazon/com/** to your project's **src/com/** folder. + +2) Modify your **AndroidManifest.xml** and add the following lines to your manifest tag: + +```xml + + + + +``` + +3) Modify your **AndroidManifest.xml** and add the following **activity**, **receiver** and **service** tags to your **application** section. + +```xml + + + + + + + + + + +``` + +4) Modify your **AndroidManifest.xml** and add "amazon" XML namespace to tag: + +```xml +xmlns:amazon="http://schemas.amazon.com/apk/res/android" +``` + +5) Modify your res/xml/config.xml to add a reference to PushPlugin: + +```xml + + + +``` + +6) Modify your res/xml/config.xml to set some config options to let Cordova know whether to display ADM message in the notification center or not. If not, provide the default message. By default, message will be visible in the notification. These config options are used if message arrives and app is not in the foreground(either Killed or running in the background). + +```xml + + +``` + +7) Finally, put api_key.txt (given to you when you register your app on [Amazon Developer Portal](https://developer.amazon.com/sdk/adm.html). For detailed steps on how to register for ADM please refer to section "Registering your app for Amazon Device Messaging(ADM)" + ## Manual Installation for Android @@ -172,6 +223,16 @@ cordova plugin add https://github.com/phonegap-build/PushPlugin.git For additional info, take a look at the [Plugman Documentation](https://github.com/apache/cordova-plugman/blob/master/README.md) +Note: For Amazon Fire OS, you will have to follow 2 steps below after automatic installation: + +1) Modify your **AndroidManifest.xml** and add "amazon" XML namespace to tag: + +```xml +xmlns:amazon="http://schemas.amazon.com/apk/res/android" +``` + +2) Put api_key.txt (given to you when you register your app on [Amazon Developer Portal](https://developer.amazon.com/sdk/adm.html) in your app's assets folder ($path to app/platforms/amazon-fireos/assets/). For detailed steps on how to register for ADM please refer to section "Registering your app for Amazon Device Messaging(ADM)" + ## Plugin API In the Examples folder you will find a sample implementation showing how to interact with the PushPlugin. Modify it to suit your needs. @@ -189,15 +250,18 @@ pushNotification = window.plugins.pushNotification; ``` #### register -This should be called as soon as the device becomes ready. On success, you will get a call to tokenHandler (iOS), or onNotificationGCM (Android), allowing you to obtain the device token or registration ID, respectively. Those values will typically get posted to your intermediary push server so it knows who it can send notifications to. +This should be called as soon as the device becomes ready. On success, you will get a call to tokenHandler (iOS), or onNotificationGCM (Amazon Fire OS or Android), allowing you to obtain the device token or registration ID, respectively. Those values will typically get posted to your intermediary push server so it knows who it can send notifications to. +For Amazon Fire OS, if you have not already registered with Amazon developer portal,you will have to obtain credentials and api_key for your app. This is described more in detail in the **Registering your app for Amazon Device Messaging(ADM)** section below. For Android, If you have not already done so, you'll need to set up a Google API project, to generate your senderID. [Follow these steps](http://developer.android.com/guide/google/gcm/gs.html) to do so. This is described more fully in the **Test Environment** section below. In this example, be sure and substitute your own senderID. Get your senderID by signing into to your [google dashboard](https://code.google.com/apis/console/). The senderID is found at **Overview->Dashboard->Project Number**. +Note: For Amazon Fire OS platform, sender_id is not needed. If you provide one, it will be ignored. "ecb" MUST be provided in order to get callback notifications. + ```js -if ( device.platform == 'android' || device.platform == 'Android' ) +if ( device.platform == 'android' || device.platform == 'Android' || device.platform == "Amazon" || device.platform == "amazon") { pushNotification.register( successHandler, @@ -311,7 +375,10 @@ function onNotificationGCM(e) { } $("#app-status-ul").append('
  • MESSAGE -> MSG: ' + e.payload.message + '
    • '); - $("#app-status-ul").append('
  • MESSAGE -> MSGCNT: ' + e.payload.msgcnt + '
    • '); + //Only works for GCM + $("#app-status-ul").append('
  • MESSAGE -> MSGCNT: ' + e.payload.msgcnt + '
    • '); + //Only works on Amazon Fire OS + $status.append('
  • MESSAGE -> TIME: ' + e.payload.timeStamp + '
    • '); break; case 'error': @@ -325,49 +392,11 @@ function onNotificationGCM(e) { } ``` -Looking at the above message handling code for Android, a few things bear explaination. Your app may receive a notification while it is active (INLINE). If you background the app by hitting the Home button on your device, you may later receive a status bar notification. Selecting that notification from the status will bring your app to the front and allow you to process the notification (BACKGROUND). Finally, should you completely exit the app by hitting the back button from the home page, you may still receive a notification. Touching that notification in the notification tray will relaunch your app and allow you to process the notification (COLDSTART). In this case the **coldstart** flag will be set on the incoming event. You can look at the **foreground** flag on the event to determine whether you are processing a background or an in-line notification. You may choose, for example to play a sound or show a dialog only for inline or coldstart notifications since the user has already been alerted via the status bar. - -Also make note of the **payload** object. Since the Android notification data model is much more flexible than that of iOS, there may be additional elements beyond **message**, **soundname**, and **msgcnt**. You can access those elements and any additional ones via the **payload** element. This means that if your data model should change in the future, there will be no need to change and recompile the plugin. - -##### wp8 -Register as - -```js -pushNotification = window.plugins.pushNotification; -pushNotification.register(successHandler, errorHandler, {"channelName":"your_channel_name","ecb":"onNotification"}); - -function successHandler(result) { - console.log('registered###' + result.uri); - // send uri to your notification server -} -``` - -onNotification is fired if the app is running when you receive the toast notification - -```js -function onNotification (e) { - navigator.notification.alert(e.text2, function(){}, e.text1); -} -``` +Looking at the above message handling code for Android/Amazon Fire OS, a few things bear explanation. Your app may receive a notification while it is active (INLINE). If you background the app by hitting the Home button on your device, you may later receive a status bar notification. Selecting that notification from the status will bring your app to the front and allow you to process the notification (BACKGROUND). Finally, should you completely exit the app by hitting the back button from the home page, you may still receive a notification. Touching that notification in the notification tray will relaunch your app and allow you to process the notification (COLDSTART). In this case the **coldstart** flag will be set on the incoming event. You can look at the **foreground** flag on the event to determine whether you are processing a background or an in-line notification. You may choose, for example to play a sound or show a dialog only for inline or coldstart notifications since the user has already been alerted via the status bar. -When not using PhoneGap Build, you can control the launch page when the user taps on your toast notification when the app is not running. Add the following code to your MainPage.xaml.cs: +For Amazon Fire OS platform, offline message can also be received when app is launched via carousel or by tapping on app icon from apps. In either case once app delivers the offline message to JS, notification will be cleared. -``` - protected override void OnNavigatedTo(System.Windows.Navigation.NavigationEventArgs e) - { - base.OnNavigatedTo(e); - try - { - if (this.NavigationContext.QueryString["NavigatedFrom"] == "toast") // this is set on the server - { - this.CordovaView.StartPageUri = new Uri("//www/index.html#notification-page", UriKind.Relative); - } - } - catch (KeyNotFoundException) - { - } - } -``` +Also make note of the **payload** object. Since the Android notification data model is much more flexible than that of iOS, there may be additional elements beyond **message**, **soundname**, and **msgcnt**. You can access those elements and any additional ones via the **payload** element. This means that if your data model should change in the future, there will be no need to change and recompile the plugin. #### unregister You will typically call this when your app is exiting, to cleanup any used resources. Its not strictly necessary to call it, and indeed it may be desireable to NOT call it if you are debugging your intermediarry push server. When you call unregister(), the current token for a particular device will get invalidated, and the next call to register() will return a new token. If you do NOT call unregister(), the last token will remain in effect until it is invalidated for some reason at the GCM side. Since such invalidations are beyond your control, its recommended that, in a production environment, that you have a matching unregister() call, for every call to register(), and that your server updates the devices' records each time. @@ -428,10 +457,10 @@ pushNotification.setApplicationIconBadgeNumber(successCallback, errorCallback, b The notification system consists of several interdependent components. 1) The client application which runs on a device and receives notifications. - 2) The notification service provider (APNS for Apple, GCM for Google) - 3) Intermediary servers that collect device IDs from clients and push notifications through APNS and/or GCM. + 2) The notification service provider (ADM for Amazon Fire OS, APNS for Apple, GCM for Google) + 3) Intermediary servers that collect device IDs from clients and push notifications through Amazon ADM servers, APNS and/or GCM. -This plugin and its target Cordova application comprise the client application.The APNS and GCM infrastructure are maintained by Apple and Google, respectively. In order to send push notifications to your users, you would typically run an intermediary server or employ a 3rd party push service. This is true for both GCM (Android) and APNS (iOS) notifications. However, when testing the notification client applications, it may be desirable to be able to push notifications directly from your desktop, without having to design and build those server's first. There are a number of solutions out there to allow you to push from a desktop machine, sans server. The easiest I've found to work with is a ruby gem called [pushmeup](http://rubygems.org/gems/pushmeup). I've only tried this on Mac, but it probably works fine on Windows as well. Here's a rough outline; +This plugin and its target Cordova application comprise the client application.The ADM, APNS and GCM infrastructure are maintained by Amazon, Apple and Google, respectively. In order to send push notifications to your users, you would typically run an intermediary server or employ a 3rd party push service. This is true for all ADM(Amazon), GCM (Android) and APNS (iOS) notifications. However, when testing the notification client applications, it may be desirable to be able to push notifications directly from your desktop, without having to design and build those server's first. There are a number of solutions out there to allow you to push from a desktop machine, sans server. The easiest I've found to work with is a ruby gem called [pushmeup](http://rubygems.org/gems/pushmeup). I've only tried this on Mac, but it probably works fine on Windows as well. Here's a rough outline; **Prerequisites**. @@ -465,6 +494,22 @@ Start at the section entitled "Generating the Certificate Signing Request (CSR)" c) $ ruby pushGCM.rb d) $ ruby pushAPNS.rb +**Server for ADM** + +There is a python script that runs a simple web server from your local machine. Goto Example/Server folder. Follow the steps below: + +#### 1) open ADMServer.py in text editor and change the PORT, PROD_CLIENT_ID and PROD_CLIENT_SECRET values. + +#### 2) From command line run this command - "python ADMServer.py". + +#### 3) Open your favorite browser and load server url : http://localhost:4000/. It should report "Server Running". If you don't see this then check on command line for any errors. This also means something went wrong with ADM registration. Double check your Client_ID and Secret_Code. Also, make sure your app on Amazon dev portal has Device Messaging switch turned ON. + +#### 4) Once you register through the app and have valid registrationId, you should register that with the server too using this url: http://localhost:4000/register?device=registraionId. + +#### 5) To see list of registered devices with your server use this url: http://localhost:4000/show-devices + +#### 6) To send a message to one or more registered devices use this url: http://localhost:4000/show-devices, click on the radio button next to device id and type in the message. + If all went well, you should see a notification show up on each device. If not, make sure you are not being blocked by a firewall, and that you have internet access. Check and recheck the token id, the registration ID and the certificate generating process. In a production environment, your app, upon registration, would send the device id (iOS) or the registration id (Android), to your intermediary push server. For iOS, the push certificate would also be stored there, and would be used to authenticate push requests to the APNS server. When a push request is processed, this information is then used to target specific apps running on individual devices. @@ -479,6 +524,7 @@ If you're not up to building and maintaining your own intermediary push server, [kony](http://www.kony.com/push-notification-services) and many others. +[Amazon Simple Notification Service](https://aws.amazon.com/sns/) ## Notes From c66ab15bc301190eb6861b75ea489f34a37368c6 Mon Sep 17 00:00:00 2001 From: Archana Naik Date: Tue, 1 Apr 2014 14:37:46 -0700 Subject: [PATCH 113/133] Fixed couple of issues - 1. permission denied when launching the app from notification. 2. Message is not downloaded when resumed after hitting hoem button. --- plugin.xml | 2 +- src/amazon/ADMMessageHandler.java | 20 ++++----- src/amazon/PushPlugin.java | 75 +++++++++++++++++++------------ 3 files changed, 58 insertions(+), 39 deletions(-) diff --git a/plugin.xml b/plugin.xml index 288fd7f9..b7766f1c 100755 --- a/plugin.xml +++ b/plugin.xml @@ -91,7 +91,7 @@ is unavailable. --> - + diff --git a/src/amazon/ADMMessageHandler.java b/src/amazon/ADMMessageHandler.java index d1852c6d..b566a51b 100644 --- a/src/amazon/ADMMessageHandler.java +++ b/src/amazon/ADMMessageHandler.java @@ -145,7 +145,7 @@ protected void onMessage(final Intent intent) { * @param extras */ public void createNotification(Context context, Bundle extras) { - NotificationManager mNotificationManager = (NotificationManager) getSystemService(Context.NOTIFICATION_SERVICE); + NotificationManager notificationManager = (NotificationManager) getSystemService(Context.NOTIFICATION_SERVICE); String appName = getAppName(this); // reuse the intent so that we can combine multiple messages into extra @@ -159,23 +159,23 @@ public void createNotification(Context context, Bundle extras) { PendingIntent contentIntent = PendingIntent.getActivity(this, 0, notificationIntent, PendingIntent.FLAG_UPDATE_CURRENT); - final Builder mBuilder = new Notification.Builder(context); - mBuilder.setSmallIcon(context.getApplicationInfo().icon) + final Builder notificationBuilder = new Notification.Builder(context); + notificationBuilder.setSmallIcon(context.getApplicationInfo().icon) .setWhen(System.currentTimeMillis()) .setContentIntent(contentIntent); if (PushPlugin.showMessageInNotificationCenter()) { - mBuilder.setContentText(extras.getString("message")); + notificationBuilder.setContentText(extras.getString("message")); } else { - mBuilder.setContentText(PushPlugin.defaultNotificationMessage()); + notificationBuilder.setContentText(PushPlugin.defaultNotificationMessage()); } String title = appName; - mBuilder.setContentTitle(title).setTicker(title); - mBuilder.setAutoCancel(true); + notificationBuilder.setContentTitle(title).setTicker(title); + notificationBuilder.setAutoCancel(true); // Because the ID remains unchanged, the existing notification is updated. - mNotificationManager.notify((String) appName, NOTIFICATION_ID, - mBuilder.build()); + notificationManager.notify((String) appName, NOTIFICATION_ID, + notificationBuilder.getNotification()); } public static void cancelNotification(Context context) { @@ -203,7 +203,7 @@ static void cleanupNotificationIntent() { } } - static Bundle getOfflineMessage() { + public static Bundle getOfflineMessage() { Bundle pushBundle = null; if (notificationIntent != null) { pushBundle = notificationIntent.getExtras().getBundle(PUSH_BUNDLE); diff --git a/src/amazon/PushPlugin.java b/src/amazon/PushPlugin.java index 4ab5841c..9dd9be4f 100644 --- a/src/amazon/PushPlugin.java +++ b/src/amazon/PushPlugin.java @@ -21,6 +21,7 @@ import org.apache.cordova.CordovaPlugin; import org.apache.cordova.CordovaWebView; import org.apache.cordova.CordovaActivity; +import org.apache.cordova.LOG; import org.json.JSONArray; import org.json.JSONException; import com.amazon.device.messaging.ADM; @@ -99,7 +100,7 @@ public void initialize(CordovaInterface cordova, CordovaWebView webView) { .getStringProperty("defaultnotificationmessage", null); } } else { - Log.e(TAG, NON_AMAZON_DEVICE_ERROR); + LOG.e(TAG, NON_AMAZON_DEVICE_ERROR); } } @@ -136,7 +137,6 @@ public ADMReadiness isPushPluginReady() { public boolean execute(final String request, final JSONArray args, CallbackContext callbackContext) throws JSONException { try { - // check ADM readiness ADMReadiness ready = isPushPluginReady(); if (ready == ADMReadiness.NON_AMAZON_DEVICE) { @@ -146,7 +146,7 @@ public boolean execute(final String request, final JSONArray args, callbackContext.error(ADM_NOT_SUPPORTED_ERROR); return false; } else if (callbackContext == null) { - Log.e(TAG, + LOG.e(TAG, "CallbackConext is null. Notification to WebView is not possible. Can not proceed."); return false; } @@ -155,28 +155,28 @@ public boolean execute(final String request, final JSONArray args, if (REGISTER.equals(request)) { if (args == null) { - Log.e(TAG, REGISTER_OPTIONS_NULL); + LOG.e(TAG, REGISTER_OPTIONS_NULL); callbackContext.error(REGISTER_OPTIONS_NULL); return false; } // parse args to get eventcallback name if (args.isNull(0)) { - Log.e(TAG, ECB_NOT_SPECIFIED); + LOG.e(TAG, ECB_NOT_SPECIFIED); callbackContext.error(ECB_NOT_SPECIFIED); return false; } JSONObject jo = args.getJSONObject(0); if (jo.getString("ecb").isEmpty()) { - Log.e(TAG, ECB_NAME_NOT_SPECIFIED); + LOG.e(TAG, ECB_NAME_NOT_SPECIFIED); callbackContext.error(ECB_NAME_NOT_SPECIFIED); return false; } callbackContext.success(REGISTRATION_SUCCESS_RESPONSE); notificationHandlerCallBack = jo.getString(ECB); String regId = adm.getRegistrationId(); - Log.d(TAG, "regId = " + regId); + LOG.d(TAG, "regId = " + regId); if (regId == null) { adm.startRegister(); } else { @@ -185,23 +185,16 @@ public boolean execute(final String request, final JSONArray args, // see if there are any messages while app was in background and // launched via app icon - if (cachedExtrasAvailable()) { - Log.v(TAG, "sending cached extras"); - sendExtras(gCachedExtras); - gCachedExtras = null; - } else { - deliverOfflineMessages(); - } - // Clear the notification if any exists - ADMMessageHandler.cancelNotification(activity); + LOG.d(TAG,"checking for offline message.."); + deliverPendingMessageAndCancelNotifiation(); return true; } else if (UNREGISTER.equals(request)) { adm.startUnregister(); callbackContext.success(UNREGISTRATION_SUCCESS_RESPONSE); return true; - } else { - Log.e(TAG, "Invalid action : " + request); + } else { + LOG.e(TAG, "Invalid action : " + request); callbackContext.error("Invalid action : " + request); return false; } @@ -243,33 +236,38 @@ public boolean cachedExtrasAvailable() { * Checks if offline message was pending to be delivered from notificationIntent. Sends it to webView(JS) if it is * and also clears notification from the NotificaitonCenter. */ - private void deliverOfflineMessages() { + private boolean deliverOfflineMessages() { + LOG.d(TAG,"deliverOfflineMessages()"); Bundle pushBundle = ADMMessageHandler.getOfflineMessage(); if (pushBundle != null) { - Log.d(TAG,"Sending offline message..."); + LOG.d(TAG,"Sending offline message..."); sendExtras(pushBundle); ADMMessageHandler.cleanupNotificationIntent(); + return true; } + return false; } // lifecyle callback to set the isForeground @Override public void onPause(boolean multitasking) { - Log.d(TAG, "onPause"); + LOG.d(TAG, "onPause"); super.onPause(multitasking); isForeground = false; } @Override public void onResume(boolean multitasking) { - Log.d(TAG, "onResume"); + LOG.d(TAG, "onResume"); super.onResume(multitasking); isForeground = true; + //Check if there are any offline messages? + deliverPendingMessageAndCancelNotifiation(); } @Override public void onDestroy() { - Log.d(TAG, "onDestroy"); + LOG.d(TAG, "onDestroy"); super.onDestroy(); isForeground = false; webview = null; @@ -294,6 +292,27 @@ public static boolean isActive() { return webview != null; } + /** + * Delivers pending/offline messages if any + * + * @return returns true if there were any pending messages otherwise false. + */ + public boolean deliverPendingMessageAndCancelNotifiation() { + boolean delivered = false; + LOG.d(TAG,"deliverPendingMessages()"); + if (cachedExtrasAvailable()) { + LOG.v(TAG, "sending cached extras"); + sendExtras(gCachedExtras); + gCachedExtras = null; + delivered = true; + } else { + delivered = deliverOfflineMessages(); + } + // Clear the notification if any exists + ADMMessageHandler.cancelNotification(activity); + + return delivered; + } /** * Sends register/unregiste events to JS * @@ -325,14 +344,14 @@ public static void sendRegistrationIdWithEvent(String event, */ public static boolean sendJavascript(JSONObject json) { if (json == null) { - Log.i(TAG, "JSON object is empty. Nothing to send to JS."); + LOG.i(TAG, "JSON object is empty. Nothing to send to JS."); return true; } if (notificationHandlerCallBack != null && webview != null) { String jsToSend = "javascript:" + notificationHandlerCallBack + "(" + json.toString() + ")"; - Log.v(TAG, "sendJavascript: " + jsToSend); + LOG.v(TAG, "sendJavascript: " + jsToSend); webview.sendJavascript(jsToSend); return true; } @@ -346,7 +365,7 @@ public static boolean sendJavascript(JSONObject json) { public static void sendExtras(Bundle extras) { if (extras != null) { if (!sendJavascript(convertBundleToJson(extras))) { - Log.v(TAG, + LOG.v(TAG, "sendExtras: could not send to JS. Caching extras to send at a later time."); gCachedExtras = extras; } @@ -408,11 +427,11 @@ private static JSONObject convertBundleToJson(Bundle extras) { } // while } json.put(PAYLOAD, jsondata); - Log.v(TAG, "extrasToJSON: " + json.toString()); + LOG.v(TAG, "extrasToJSON: " + json.toString()); return json; } catch (JSONException e) { - Log.e(TAG, "extrasToJSON: JSON exception"); + LOG.e(TAG, "extrasToJSON: JSON exception"); } return null; } From eb69be328cc3d2f38079be46f6c1be9cad09817d Mon Sep 17 00:00:00 2001 From: Archana Naik Date: Thu, 3 Apr 2014 11:37:02 -0700 Subject: [PATCH 114/133] Config options are persisted now. When app is forced stopped, we read config options from sharedPreferences. Also, fixes error message not being shown properly. --- plugin.xml | 2 +- src/amazon/ADMMessageHandler.java | 77 ++++++++++++++++++++++++++++--- src/amazon/PushPlugin.java | 30 ++---------- 3 files changed, 75 insertions(+), 34 deletions(-) diff --git a/plugin.xml b/plugin.xml index b7766f1c..f3972008 100755 --- a/plugin.xml +++ b/plugin.xml @@ -72,7 +72,7 @@ - + diff --git a/src/amazon/ADMMessageHandler.java b/src/amazon/ADMMessageHandler.java index b566a51b..cc8f39b4 100644 --- a/src/amazon/ADMMessageHandler.java +++ b/src/amazon/ADMMessageHandler.java @@ -16,13 +16,16 @@ package com.amazon.cordova.plugin; +import org.apache.cordova.CordovaActivity; import org.json.JSONObject; import android.app.Notification; import android.app.NotificationManager; import android.app.PendingIntent; import android.content.Context; import android.content.Intent; +import android.content.SharedPreferences; import android.os.Bundle; +import android.text.TextUtils; import android.util.Log; import android.app.Notification.Builder; @@ -35,10 +38,16 @@ public class ADMMessageHandler extends ADMMessageHandlerBase { - private static final String TAG = "ADMMessageHandler"; private static final String ERROR_EVENT = "error"; public static final String PUSH_BUNDLE = "pushBundle"; - + public static final String ERROR_MSG = "msg"; + private static final String SHOW_MESSAGE_PREF = "showmessageinnotification"; + private static final String DEFAULT_MESSAGE_PREF = "defaultnotificationmessage"; + private static boolean shouldShowOfflineMessage = false; + private static String defaultOfflineMessage = null; + private static final String PREFS_NAME = "PushPluginPrefs"; + private static final String DEFAULT_MESSAGE_TEXT = "You have a new message."; + // An identifier for ADM notification unique within your application // It allows you to update the same notification later on public static final int NOTIFICATION_ID = 519; @@ -108,7 +117,7 @@ protected void onRegistrationError(final String errorId) { try { JSONObject json; json = new JSONObject().put(PushPlugin.EVENT, ERROR_EVENT); - json.put(PushPlugin.REG_ID, errorId); + json.put(ADMMessageHandler.ERROR_MSG, errorId); PushPlugin.sendJavascript(json); } catch (Exception e) { @@ -164,10 +173,10 @@ public void createNotification(Context context, Bundle extras) { .setWhen(System.currentTimeMillis()) .setContentIntent(contentIntent); - if (PushPlugin.showMessageInNotificationCenter()) { - notificationBuilder.setContentText(extras.getString("message")); + if (this.shouldShowMessageInNotification()) { + notificationBuilder.setContentText(extras.getString(PushPlugin.MESSAGE)); } else { - notificationBuilder.setContentText(PushPlugin.defaultNotificationMessage()); + notificationBuilder.setContentText(this.defaultMessageTextInNotification()); } String title = appName; @@ -214,4 +223,60 @@ public static Bundle getOfflineMessage() { return pushBundle; } + /** + * Reads "shownotificationmessage" & "defaultnotificationmessage" config options + * If this is first-time it saves them to sharedPreferences so they can be read + * when app is forced-stop or killed + */ + public static void saveConfigOptions(Context context) { + if (context != null && TextUtils.isEmpty(defaultOfflineMessage)) { + // read config options from config.xml + shouldShowOfflineMessage = ((CordovaActivity) context) + .getBooleanProperty(SHOW_MESSAGE_PREF, false); + defaultOfflineMessage = ((CordovaActivity) context) + .getStringProperty(DEFAULT_MESSAGE_PREF, null); + + // save them to sharedPreferences if necessary + SharedPreferences config = context.getApplicationContext().getSharedPreferences(PREFS_NAME, 0); + SharedPreferences.Editor editor = config.edit(); + editor.putBoolean(SHOW_MESSAGE_PREF, shouldShowOfflineMessage); + editor.putString(DEFAULT_MESSAGE_PREF, defaultOfflineMessage); + // save prefs to disk + editor.commit(); + } + + } + + /** + * Gets "shownotificationmessage" config option + * + * @return returns boolean- true is shownotificationmessage is set to true in config.xml/sharedPreferences otherwise false + */ + private boolean shouldShowMessageInNotification() { + //check if have cached copy of this option + if (TextUtils.isEmpty(defaultOfflineMessage)) { + //need to read it from sharedPreferences + SharedPreferences config = this.getApplicationContext().getSharedPreferences(PREFS_NAME,0); + if (config != null) { + shouldShowOfflineMessage = config.getBoolean(SHOW_MESSAGE_PREF, true); + } + } + return shouldShowOfflineMessage; + } + + /** + * Gets "defaultnotificationmessage" config option + * + * @return returns default message provided by user in cofing.xml/sharedPreferences + */ + private String defaultMessageTextInNotification() { + //check if have cached copy of this option + if (TextUtils.isEmpty(defaultOfflineMessage)) { + SharedPreferences config = this.getApplicationContext().getSharedPreferences(PREFS_NAME,0); + if (config != null) { + defaultOfflineMessage = config.getString(DEFAULT_MESSAGE_PREF, DEFAULT_MESSAGE_TEXT); + } + } + return defaultOfflineMessage; + } } diff --git a/src/amazon/PushPlugin.java b/src/amazon/PushPlugin.java index 9dd9be4f..8c530219 100644 --- a/src/amazon/PushPlugin.java +++ b/src/amazon/PushPlugin.java @@ -50,10 +50,9 @@ public class PushPlugin extends CordovaPlugin { private static CordovaWebView webview = null; private static String notificationHandlerCallBack; private static boolean isForeground = false; - private static boolean showOfflineMessage = false; - private static String defaultOfflineMessage = null; private static Bundle gCachedExtras = null; - + + public static final String REGISTER = "register"; public static final String UNREGISTER = "unregister"; public static final String MESSAGE = "message"; @@ -93,12 +92,7 @@ public void initialize(CordovaInterface cordova, CordovaWebView webView) { activity = (CordovaActivity) cordova.getActivity(); webview = this.webView; isForeground = true; - if (activity != null) { - showOfflineMessage = ((CordovaActivity) activity) - .getBooleanProperty("showmessageinnotification", false); - defaultOfflineMessage = ((CordovaActivity) activity) - .getStringProperty("defaultnotificationmessage", null); - } + ADMMessageHandler.saveConfigOptions(activity); } else { LOG.e(TAG, NON_AMAZON_DEVICE_ERROR); } @@ -205,24 +199,6 @@ public boolean execute(final String request, final JSONArray args, return false; } - /** - * Gets "shownotificationmessage" config option - * - * @return returns boolean- true is shownotificationmessage is set to true in config.xml otherwise false - */ - public static boolean showMessageInNotificationCenter() { - return showOfflineMessage; - } - - /** - * Gets "defaultnotificationmessage" config option - * - * @return returns default message provided by user in cofing.xml - */ - public static String defaultNotificationMessage() { - return defaultOfflineMessage; - } - /** * Checks if any bundle extras were cached while app was not running * From 4aa063a5eb9d24d6ec2773444f7777c90d493cd7 Mon Sep 17 00:00:00 2001 From: Digvijay Dalapathi Date: Fri, 4 Apr 2014 14:54:45 -0700 Subject: [PATCH 115/133] Update error message for Otter1 where ADM is not supported JIRA: https://issues.labcollab.net/browse/ATLS-1064 cr https://cr.amazon.com/r/2292352/ --- src/amazon/PushPlugin.java | 18 +++++++++++++++--- 1 file changed, 15 insertions(+), 3 deletions(-) diff --git a/src/amazon/PushPlugin.java b/src/amazon/PushPlugin.java index 8c530219..b45a1d58 100644 --- a/src/amazon/PushPlugin.java +++ b/src/amazon/PushPlugin.java @@ -63,13 +63,15 @@ public class PushPlugin extends CordovaPlugin { public static final String REG_ID = "regid"; public static final String COLDSTART = "coldstart"; - private static final String NON_AMAZON_DEVICE_ERROR = "PushNotifications using Amazon Device Messaging is only supported on Kindle Fire devices."; + private static final String NON_AMAZON_DEVICE_ERROR = "PushNotifications using Amazon Device Messaging is only supported on Kindle Fire devices (2nd Generation and Later only)."; private static final String ADM_NOT_SUPPORTED_ERROR = "Amazon Device Messaging is not supported on this device."; private static final String REGISTER_OPTIONS_NULL = "Register options are not specified."; private static final String ECB_NOT_SPECIFIED = "ecb(eventcallback) option is not specified in register()."; private static final String ECB_NAME_NOT_SPECIFIED = "ecb(eventcallback) value is missing in options for register()."; private static final String REGISTRATION_SUCCESS_RESPONSE = "Registration started..."; private static final String UNREGISTRATION_SUCCESS_RESPONSE = "Unregistration started..."; + + private static final String MODEL_FIRST_GEN = "Kindle Fire"; public enum ADMReadiness { INITIALIZED, NON_AMAZON_DEVICE, ADM_NOT_SUPPORTED @@ -87,7 +89,8 @@ public enum ADMReadiness { @Override public void initialize(CordovaInterface cordova, CordovaWebView webView) { super.initialize(cordova, webView); - if (this.isAmazonDevice()) { + // Initialize only for Amazon devices 2nd Generation and later + if (this.isAmazonDevice() && !isFirstGenKindleFireDevice()) { adm = new ADM(cordova.getActivity()); activity = (CordovaActivity) cordova.getActivity(); webview = this.webView; @@ -107,7 +110,15 @@ private boolean isAmazonDevice() { String deviceMaker = android.os.Build.MANUFACTURER; return deviceMaker.equalsIgnoreCase("Amazon"); } - + + /** + * Check if device is First generation Kindle + * + * @return if device is First generation Kindle + */ + private static boolean isFirstGenKindleFireDevice() { + return android.os.Build.MODEL.equals(MODEL_FIRST_GEN); + } /** * Checks if ADM is available and supported - could be one of three 1. Non Amazon device, hence no ADM support 2. * ADM is not supported on this Kindle device (1st generation) 3. ADM is successfully initialized and ready to be @@ -413,3 +424,4 @@ private static JSONObject convertBundleToJson(Bundle extras) { } } + From b03226d043cc463abb2534dec247df2bcfef22fc Mon Sep 17 00:00:00 2001 From: Archana Naik Date: Tue, 8 Apr 2014 13:44:15 -0700 Subject: [PATCH 116/133] HTML decoding the message before adding it to notification. --- src/amazon/ADMMessageHandler.java | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/src/amazon/ADMMessageHandler.java b/src/amazon/ADMMessageHandler.java index cc8f39b4..b68a3c24 100644 --- a/src/amazon/ADMMessageHandler.java +++ b/src/amazon/ADMMessageHandler.java @@ -25,6 +25,7 @@ import android.content.Intent; import android.content.SharedPreferences; import android.os.Bundle; +import android.text.Html; import android.text.TextUtils; import android.util.Log; import android.app.Notification.Builder; @@ -133,7 +134,7 @@ protected void onMessage(final Intent intent) { // Extract the payload from the message Bundle extras = intent.getExtras(); - if (extras != null) { + if (extras != null && (extras.getString(PushPlugin.MESSAGE) != null)) { // if we are in the foreground, just surface the payload, else post // it to the statusbar if (PushPlugin.isInForeground()) { @@ -174,7 +175,8 @@ public void createNotification(Context context, Bundle extras) { .setContentIntent(contentIntent); if (this.shouldShowMessageInNotification()) { - notificationBuilder.setContentText(extras.getString(PushPlugin.MESSAGE)); + String message = extras.getString(PushPlugin.MESSAGE); + notificationBuilder.setContentText(Html.fromHtml(message).toString()); } else { notificationBuilder.setContentText(this.defaultMessageTextInNotification()); } From dda679ae8b5c3d2ac99c1018bde139cab1efceb7 Mon Sep 17 00:00:00 2001 From: Archana Naik Date: Thu, 10 Apr 2014 07:02:15 -0700 Subject: [PATCH 117/133] Updated event names for the callback so existing sample code works with both android and amazon-fireos --- Example/www/index.html | 8 ++++++-- src/amazon/ADMMessageHandler.java | 4 ++-- src/amazon/PushPlugin.java | 4 +++- 3 files changed, 11 insertions(+), 5 deletions(-) diff --git a/Example/www/index.html b/Example/www/index.html index 681e9e72..9ec8dc38 100755 --- a/Example/www/index.html +++ b/Example/www/index.html @@ -36,8 +36,9 @@ try { pushNotification = window.plugins.pushNotification; - if (device.platform == 'android' || device.platform == 'Android') { - $("#app-status-ul").append('
  • registering android
    • '); + if (device.platform == 'android' || device.platform == 'Android' || + device.platform == 'amazon-fireos' ) { + $("#app-status-ul").append('
  • registering ' + device.platform + '
    • '); pushNotification.register(successHandler, errorHandler, {"senderID":"661780372179","ecb":"onNotificationGCM"}); // required! } else { $("#app-status-ul").append('
  • registering iOS
    • '); @@ -105,7 +106,10 @@ } $("#app-status-ul").append('
  • MESSAGE -> MSG: ' + e.payload.message + '
    • '); + //android only $("#app-status-ul").append('
  • MESSAGE -> MSGCNT: ' + e.payload.msgcnt + '
    • '); + //amazon-fireos only + $("#app-status-ul").append('
  • MESSAGE -> TIMESTAMP: ' + e.payload.timeStamp + '
    • '); break; case 'error': diff --git a/src/amazon/ADMMessageHandler.java b/src/amazon/ADMMessageHandler.java index b68a3c24..7fe79df5 100644 --- a/src/amazon/ADMMessageHandler.java +++ b/src/amazon/ADMMessageHandler.java @@ -96,7 +96,7 @@ protected void onRegistered(final String newRegistrationId) { // we fire the register event in the web app, register handler should // fire to send the registration ID to your server via a header key/value pair over HTTP.(AJAX) - PushPlugin.sendRegistrationIdWithEvent(PushPlugin.REGISTER, + PushPlugin.sendRegistrationIdWithEvent(PushPlugin.REGISTER_EVENT, newRegistrationId); } @@ -105,7 +105,7 @@ protected void onRegistered(final String newRegistrationId) { protected void onUnregistered(final String registrationId) { // If your app is unregistered on this device, inform your server that // this app instance is no longer a valid target for messages. - PushPlugin.sendRegistrationIdWithEvent(PushPlugin.UNREGISTER, + PushPlugin.sendRegistrationIdWithEvent(PushPlugin.UNREGISTER_EVENT, registrationId); } diff --git a/src/amazon/PushPlugin.java b/src/amazon/PushPlugin.java index b45a1d58..1d610cde 100644 --- a/src/amazon/PushPlugin.java +++ b/src/amazon/PushPlugin.java @@ -55,6 +55,8 @@ public class PushPlugin extends CordovaPlugin { public static final String REGISTER = "register"; public static final String UNREGISTER = "unregister"; + public static final String REGISTER_EVENT = "registered"; + public static final String UNREGISTER_EVENT = "unregistered"; public static final String MESSAGE = "message"; public static final String ECB = "ecb"; public static final String EVENT = "event"; @@ -185,7 +187,7 @@ public boolean execute(final String request, final JSONArray args, if (regId == null) { adm.startRegister(); } else { - sendRegistrationIdWithEvent(REGISTER, regId); + sendRegistrationIdWithEvent(REGISTER_EVENT, regId); } // see if there are any messages while app was in background and From ce95a56a2e93cfabb976e66dd73f54c62fa78c5e Mon Sep 17 00:00:00 2001 From: EddyVerbruggen Date: Thu, 1 May 2014 23:34:03 +0200 Subject: [PATCH 118/133] typo --- plugin.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/plugin.xml b/plugin.xml index f3972008..43bd6ab8 100755 --- a/plugin.xml +++ b/plugin.xml @@ -87,7 +87,7 @@ From f2b813bbe84009d1806bea08191da71e24b5c844 Mon Sep 17 00:00:00 2001 From: Nadya Atanasova Date: Mon, 7 Apr 2014 16:33:37 +0300 Subject: [PATCH 119/133] Take deserialization outside the methods as it can be reused. Adding TryCast method improves readability and decreases the code nesting. --- src/wp8/PushPlugin.cs | 70 +++++++++++++++++++++++++------------------ 1 file changed, 41 insertions(+), 29 deletions(-) diff --git a/src/wp8/PushPlugin.cs b/src/wp8/PushPlugin.cs index 724f2bf9..43826baa 100644 --- a/src/wp8/PushPlugin.cs +++ b/src/wp8/PushPlugin.cs @@ -3,9 +3,9 @@ using System; using System.Diagnostics; using System.Text; -using System.Threading; using System.Runtime.Serialization; using System.Windows; +using WPCordovaClassLib.Cordova.JSON; namespace WPCordovaClassLib.Cordova.Commands { @@ -19,19 +19,14 @@ public void register(string options) { Options pushOptions; - try - { - string[] args = JSON.JsonHelper.Deserialize(options); - pushOptions = JSON.JsonHelper.Deserialize(args[0]); - this.channelName = pushOptions.ChannelName; - this.toastCallback = pushOptions.NotificationCallback; - } - catch (Exception) + if (!TryDeserializeOptions(options, out pushOptions)) { - DispatchCommandResult(new PluginResult(PluginResult.Status.JSON_EXCEPTION)); + this.DispatchCommandResult(new PluginResult(PluginResult.Status.JSON_EXCEPTION)); return; } + this.toastCallback = pushOptions.NotificationCallback; + channelName = pushOptions.ChannelName; pushChannel = HttpNotificationChannel.Find(channelName); if (pushChannel == null) { @@ -96,33 +91,50 @@ void PushChannel_ShellToastNotificationReceived(object sender, NotificationEvent Deployment.Current.Dispatcher.BeginInvoke(() => { - PhoneApplicationFrame frame = Application.Current.RootVisual as PhoneApplicationFrame; - if (frame != null) + PhoneApplicationFrame frame; + PhoneApplicationPage page; + CordovaView cView; + + if (TryCast(Application.Current.RootVisual, out frame) && + TryCast(frame.Content, out page) && + TryCast(page.FindName("CordovaView"), out cView)) { - PhoneApplicationPage page = frame.Content as PhoneApplicationPage; - if (page != null) + cView.Browser.Dispatcher.BeginInvoke(() => { - CordovaView cView = page.FindName("CordovaView") as CordovaView; // was: PGView - if (cView != null) + try { - cView.Browser.Dispatcher.BeginInvoke((ThreadStart)delegate() - { - try - { - cView.Browser.InvokeScript("execScript", this.toastCallback + "(" + result.Message + ")"); - } - catch (Exception ex) - { - Debug.WriteLine("ERROR: Exception in InvokeScriptCallback :: " + ex.Message); - } - - }); + cView.Browser.InvokeScript("execScript", this.toastCallback + "(" + result.Message + ")"); } - } + catch (Exception ex) + { + Debug.WriteLine("ERROR: Exception in InvokeScriptCallback :: " + ex.Message); + } + }); } }); } + private static bool TryDeserializeOptions(string options, out T result) where T : class + { + result = null; + try + { + var args = JsonHelper.Deserialize(options); + result = JsonHelper.Deserialize(args[0]); + return true; + } + catch + { + return false; + } + } + + private static bool TryCast(object obj, out T result) where T : class + { + result = obj as T; + return result != null; + } + [DataContract] public class Toast { From 2071e52a660874f1a5bc53b74b7e5475294b4502 Mon Sep 17 00:00:00 2001 From: Nadya Atanasova Date: Mon, 7 Apr 2014 16:48:57 +0300 Subject: [PATCH 120/133] One channel per application and js callback functions. It appears that MPNS opens only one channel per application and defines it by name. Sometimes the channeluriupdate is called with delay and it looks like the channel has no Uri. Handle this by adding urichangedcallback js function. Added js error callback to handle errors. Added error to notify the user if they try to open new channel but already have opened one as this is throwing argument exception. Extract the js function execution in separate method as it is reused. --- src/wp8/PushPlugin.cs | 90 +++++++++++++++++++++++++++---------------- 1 file changed, 56 insertions(+), 34 deletions(-) diff --git a/src/wp8/PushPlugin.cs b/src/wp8/PushPlugin.cs index 43826baa..efff31f1 100644 --- a/src/wp8/PushPlugin.cs +++ b/src/wp8/PushPlugin.cs @@ -11,61 +11,67 @@ namespace WPCordovaClassLib.Cordova.Commands { public class PushPlugin : BaseCommand { + private const string InvalidRegistrationError = "Unable to open a channel with the specified name. The most probable cause is that you have already registered a channel with a different name."; + + private Options pushOptions; private HttpNotificationChannel pushChannel; - private string channelName; - private string toastCallback; public void register(string options) { - Options pushOptions; - - if (!TryDeserializeOptions(options, out pushOptions)) + if (!TryDeserializeOptions(options, out this.pushOptions)) { this.DispatchCommandResult(new PluginResult(PluginResult.Status.JSON_EXCEPTION)); return; } - this.toastCallback = pushOptions.NotificationCallback; - channelName = pushOptions.ChannelName; - pushChannel = HttpNotificationChannel.Find(channelName); + pushChannel = HttpNotificationChannel.Find(this.pushOptions.ChannelName); if (pushChannel == null) { - pushChannel = new HttpNotificationChannel(channelName); - pushChannel.ChannelUriUpdated += new EventHandler(PushChannel_ChannelUriUpdated); - pushChannel.ErrorOccurred += new EventHandler(PushChannel_ErrorOccurred); - pushChannel.ShellToastNotificationReceived += new EventHandler(PushChannel_ShellToastNotificationReceived); - pushChannel.Open(); + pushChannel = new HttpNotificationChannel(this.pushOptions.ChannelName); + SubscribePushChannelEvents(pushChannel); + try + { + pushChannel.Open(); + } + catch (InvalidOperationException) + { + this.DispatchCommandResult(new PluginResult(PluginResult.Status.ERROR, InvalidRegistrationError)); + return; + } + pushChannel.BindToShellToast(); + pushChannel.BindToShellTile(); } - else + + var result = new RegisterResult { - pushChannel.ChannelUriUpdated += new EventHandler(PushChannel_ChannelUriUpdated); - pushChannel.ErrorOccurred += new EventHandler(PushChannel_ErrorOccurred); - pushChannel.ShellToastNotificationReceived += new EventHandler(PushChannel_ShellToastNotificationReceived); - - RegisterResult result = new RegisterResult(); - result.ChannelName = this.channelName; - result.Uri = pushChannel.ChannelUri.ToString(); - this.DispatchCommandResult(new PluginResult(PluginResult.Status.OK, result)); - } + ChannelName = this.pushOptions.ChannelName, + Uri = pushChannel.ChannelUri == null ? string.Empty : pushChannel.ChannelUri.ToString() + }; + + this.DispatchCommandResult(new PluginResult(PluginResult.Status.OK, result)); } void PushChannel_ChannelUriUpdated(object sender, NotificationChannelUriEventArgs e) { // return uri to js - RegisterResult result = new RegisterResult(); - result.ChannelName = this.channelName; - result.Uri = pushChannel.ChannelUri.ToString(); - this.DispatchCommandResult(new PluginResult(PluginResult.Status.OK, result)); + var result = new RegisterResult + { + ChannelName = this.pushOptions.ChannelName, + Uri = e.ChannelUri.ToString() + }; + this.ExecuteCallback(this.pushOptions.UriChangedCallback, JsonHelper.Serialize(result)); } void PushChannel_ErrorOccurred(object sender, NotificationChannelErrorEventArgs e) { // call error handler and return uri - RegisterError err = new RegisterError(); - err.Code = e.ErrorCode.ToString(); - err.Message = e.Message; - this.DispatchCommandResult(new PluginResult(PluginResult.Status.ERROR, err)); + var err = new RegisterError + { + Code = e.ErrorCode.ToString(), + Message = e.Message + }; + this.ExecuteCallback(this.pushOptions.ErrorCallback, JsonHelper.Serialize(err)); } void PushChannel_ShellToastNotificationReceived(object sender, NotificationEventArgs e) @@ -87,8 +93,11 @@ void PushChannel_ShellToastNotificationReceived(object sender, NotificationEvent toast.Param = e.Collection["wp:Param"]; } - PluginResult result = new PluginResult(PluginResult.Status.OK, toast); + this.ExecuteCallback(this.pushOptions.NotificationCallback, JsonHelper.Serialize(toast)); + } + private void ExecuteCallback(string callback, string callbackResult) + { Deployment.Current.Dispatcher.BeginInvoke(() => { PhoneApplicationFrame frame; @@ -103,7 +112,7 @@ void PushChannel_ShellToastNotificationReceived(object sender, NotificationEvent { try { - cView.Browser.InvokeScript("execScript", this.toastCallback + "(" + result.Message + ")"); + cView.Browser.InvokeScript("execScript", callback + "(" + callbackResult + ")"); } catch (Exception ex) { @@ -114,7 +123,7 @@ void PushChannel_ShellToastNotificationReceived(object sender, NotificationEvent }); } - private static bool TryDeserializeOptions(string options, out T result) where T : class + private static bool TryDeserializeOptions(string options, out T result) where T : class { result = null; try @@ -135,6 +144,13 @@ private static bool TryCast(object obj, out T result) where T : class return result != null; } + private void SubscribePushChannelEvents(HttpNotificationChannel channel) + { + channel.ChannelUriUpdated += new EventHandler(PushChannel_ChannelUriUpdated); + channel.ErrorOccurred += new EventHandler(PushChannel_ErrorOccurred); + channel.ShellToastNotificationReceived += new EventHandler(PushChannel_ShellToastNotificationReceived); + } + [DataContract] public class Toast { @@ -156,6 +172,12 @@ public class Options [DataMember(Name = "ecb", IsRequired = false)] public string NotificationCallback { get; set; } + + [DataMember(Name = "errcb", IsRequired = false)] + public string ErrorCallback { get; set; } + + [DataMember(Name = "uccb", IsRequired = false)] + public string UriChangedCallback { get; set; } } [DataContract] From 14e811d640d46894302179d128b481873e2afc39 Mon Sep 17 00:00:00 2001 From: Nadya Atanasova Date: Mon, 7 Apr 2014 17:56:46 +0300 Subject: [PATCH 121/133] Add unregister channel If user want to open new channel they have to have the option to close the current one. Update the error text. Remove the channel field as it is not necessary. --- src/wp8/PushPlugin.cs | 30 ++++++++++++++++++++++++++---- www/PushNotification.js | 6 ++---- 2 files changed, 28 insertions(+), 8 deletions(-) diff --git a/src/wp8/PushPlugin.cs b/src/wp8/PushPlugin.cs index efff31f1..005b5f1a 100644 --- a/src/wp8/PushPlugin.cs +++ b/src/wp8/PushPlugin.cs @@ -11,10 +11,9 @@ namespace WPCordovaClassLib.Cordova.Commands { public class PushPlugin : BaseCommand { - private const string InvalidRegistrationError = "Unable to open a channel with the specified name. The most probable cause is that you have already registered a channel with a different name."; - + private const string InvalidRegistrationError = "Unable to open a channel with the specified name. The most probable cause is that you have already registered a channel with a different name. Call unregister(old-channel-name) or uninstall and redeploy your application."; + private const string MissingChannelError = "Couldn't find a channel with the specified name."; private Options pushOptions; - private HttpNotificationChannel pushChannel; public void register(string options) { @@ -24,7 +23,7 @@ public void register(string options) return; } - pushChannel = HttpNotificationChannel.Find(this.pushOptions.ChannelName); + var pushChannel = HttpNotificationChannel.Find(this.pushOptions.ChannelName); if (pushChannel == null) { pushChannel = new HttpNotificationChannel(this.pushOptions.ChannelName); @@ -52,6 +51,29 @@ public void register(string options) this.DispatchCommandResult(new PluginResult(PluginResult.Status.OK, result)); } + public void unregister(string options) + { + Options unregisterOptions; + if (!TryDeserializeOptions(options, out unregisterOptions)) + { + this.DispatchCommandResult(new PluginResult(PluginResult.Status.JSON_EXCEPTION)); + return; + } + var pushChannel = HttpNotificationChannel.Find(unregisterOptions.ChannelName); + if (pushChannel != null) + { + pushChannel.UnbindToShellTile(); + pushChannel.UnbindToShellToast(); + pushChannel.Close(); + pushChannel.Dispose(); + this.DispatchCommandResult(new PluginResult(PluginResult.Status.OK, "Channel " + unregisterOptions.ChannelName + " is closed!")); + } + else + { + this.DispatchCommandResult(new PluginResult(PluginResult.Status.ERROR, MissingChannelError)); + } + } + void PushChannel_ChannelUriUpdated(object sender, NotificationChannelUriEventArgs e) { // return uri to js diff --git a/www/PushNotification.js b/www/PushNotification.js index f4d800f4..a327b67b 100644 --- a/www/PushNotification.js +++ b/www/PushNotification.js @@ -20,7 +20,7 @@ PushNotification.prototype.register = function(successCallback, errorCallback, o }; // Call this to unregister for push notifications -PushNotification.prototype.unregister = function(successCallback, errorCallback) { +PushNotification.prototype.unregister = function(successCallback, errorCallback, options) { if (errorCallback == null) { errorCallback = function() {}} if (typeof errorCallback != "function") { @@ -33,10 +33,8 @@ PushNotification.prototype.unregister = function(successCallback, errorCallback) return } - cordova.exec(successCallback, errorCallback, "PushPlugin", "unregister", []); + cordova.exec(successCallback, errorCallback, "PushPlugin", "unregister", [options]); }; - - // Call this to set the application icon badge PushNotification.prototype.setApplicationIconBadgeNumber = function(successCallback, errorCallback, badge) { if (errorCallback == null) { errorCallback = function() {}} From aef10caca99f50b252801f71c5e9b5253a90b8ee Mon Sep 17 00:00:00 2001 From: Nadya Atanasova Date: Mon, 7 Apr 2014 18:39:33 +0300 Subject: [PATCH 122/133] Add unified handling of raw and toast notifications Add API for showing toast notifications, using the system behaviour. Expose interface for users to handle raw and toast notifications by js callbacks. This way they can handle notifications differently than the system --- plugin.xml | 1 + src/wp8/Newtonsoft.Json.dll | Bin 0 -> 374784 bytes src/wp8/PushPlugin.cs | 100 +++++++++++++++++++++++------------- www/PushNotification.js | 14 ++++- 4 files changed, 77 insertions(+), 38 deletions(-) create mode 100644 src/wp8/Newtonsoft.Json.dll diff --git a/plugin.xml b/plugin.xml index 43bd6ab8..75e208ff 100755 --- a/plugin.xml +++ b/plugin.xml @@ -139,6 +139,7 @@ +     diff --git a/src/wp8/Newtonsoft.Json.dll b/src/wp8/Newtonsoft.Json.dll new file mode 100644 index 0000000000000000000000000000000000000000..b819428456fceffcbc5f5acc8783d65ef57a4f9f GIT binary patch literal 374784 zcmb@P37lL-wf}qW?YZ53XUX);q8VlH+k zE*U09R8$POps0wb_;~I-pMUkaFSw&9uFnM{?$3Sq`Fzjt|Nc(h+sjM>{y(4pB)6;T z)TvWdr%s(ZwcNUoyx^r7Ka6rIU?aJ0`E#G5OGQ&Yyg0{G>~#2L{5!6Vm6N zmdQM#$ItA1_^-}ObGt9&t?KLP%Vh58&1CWpI{iibllbq$&18nm@40ddpz_<_WRS@K zf9uNw>b3d#Le>Aan*<$p=DsiVW*#m-bkArJNg~Y&GX1!3xvMv`yc7Ij{>fI+4Kq*p zjE*$ZJ1>3aPQpjOBdM3_O1V4#CNr6fryI@269HP;RClVEc^7WS-)5R?x^d~1F^DRw zA&J)e7U7+0(H%cS;wyhDo0sX$oO_j**>ZuODHyciT=>;nu8lU^kvp>E0NzeMpO&_`J=l}iE zKVJB%pI&;xTUIW+^s^rw{nqcNeqH+fakVeM`B@*i>-txHb?>{bzUpCbIAUh*568aw z?1v3CCi+Kq-t@PRz2{MXx?}L?(|3O2Tl;?SxzFxB{))ezaqB(b`Qfz}-~BHuy*XHr zt*-X`dGkEhi?(Dkp;wOJNB}fc^agKEZoHMKR^S2!PWAkVguxoz9Bws}nON7G`5c|3 zCzC1qaRcDUNO7dR^|WEwFc0)L9DEw2xXX17~GsG#p1$XwL zc>JA6y%)N|1@SJjiXTU*f_S%b9j!g4I2vCFpwFS?;#UeqMT#E}*vrK?%Kuz`c3we= zlkoEi4=+8ibdt&xmqzrd092*5Izsd!QcvBszrQ$I&k>|R;k_=8Qv3u0RevX3@%kMs z-!58d`#?T^Hk3w6wX=$)_+pSpvJS17?I_x?A8jKpx`dxXw7Ecu%1MdJu0+MGm8MYM zzGVPPR-|`Qq!L9c9kfUT6ltV4$*k9^?J{{HnHc9Nw;=@ylH-j-dXkVX0DbYegv|x#DzmisoX_{81VQKqFUoo`U zU2BM~Z%#tDD>TyYMYKjxp6MIzkG7L=q`x-oU}G}{U{5hvvA-1kEKf7^)ecM3AF1>M z!vhhShB!~fiGE^8Num1E`Y%z{28)BPW~-5tktGSvk{hltRwlv0_&SPXLXjfGJ0P6a zcc?hjL8O@A6jK~@u{Sd86^G;NMW!XGDZoT^ED?;cL@4ml`<%-3GRu4Zso8^!({-2l(N$p8hh5Jbf}f4hjfprVeSw*l8BNbls>z8?RbmZ*RkT)r?EF3ld#zN?gh_Jz!&UixU=uXljyDS zzC=+isnv^1Oi}fh2MS)^w34aSEfzG*1FwTE1G&PMK5(tGe}T@vgwDRib@p6&OJ9(S zpAKFQ=>p#y$&Qco(qRHriz%I<+A+x6#c*aMSL`is8R;$ddd0x>OB5;x2g$kI2?VGY z(hs>T?8?M;m5`?ZKm41q0eW<@Q zGEf}wiv8A+lIkT8b&eLKzc}DX^g9y&PzQ1SBhDQEmb8C-J9FxU>mM6R&1X=@y^`T7 z11<{I4Y=mH(+#+O<1y-jpPpX;0p zrTS3gwF?V9Z^8?8E@M(oh_%{qCgZ+dg%pu}@TgkC(UHhKs@ zQv=@BBSg%7%LoM3fKENK&d<=rW$qO_qk}zHi>_nY#Ppc+R0`9B&bRD9Pw7ApMGu4e zkuJmX^~ce3`tzli$o1xw*K_2}YhbC>&}AxDUoQGV56y9^H#bV~h^b(WDNr+|1gT!< zchq3*fD8EX9#lX zsc%m8jZOmCS?dAMZ|-qmU!r@tTT#fL$uyalZ(XkRegV~xDN zfG2I^b>3W=$f=03$>TM?Ajw5qlVtm7stFrBqJozRc01Y0X5K(~F{L`&wY2_ZSFR97 zTeaJ5Ufyb~vN{|r@;PK!8%dL!NE}#dP1aGRnyV7_pDNU!!xE6xBD7wsLOHmriVSB= zq_A(>@>LygUIYGa@p~D~PaiIN%jX#$vtB#{v!;q(DLMhquzz6b;Z(d(b+Q@;6Vvww zm7$qUUc8EUXREC6Dnl-8)=Kla5Z@=eBRUbBBu3%p^N6Vil|Jm4tfO4a5-!X<)nS>v z+MkcmmtlRxtMs{2^d`8y)w~xS0nJHTJVW!LVZ-`Tvd^{i%eh>_rj-fFuP=QZSyOR)R`#rawuk0iqg=ZGH(Q zY`&0mBiULbEe3;IFtPPCG*0Gx9wf*n(M4)LJyBa*q@mS*Cg9PFNGyXctZiVhd$CCM zl6SG!GB5VRpC28PKZ(R#>otz^;J0-S@mET)!9>V)qD5>KPs{L>(Xi-^ck;AT_Aq`I z$li+SY_M`>qbvR{WT9tjxwo>jHv1_5K1Fm&pTf=Si7`%^^oe#NeODwby#lO*N}u5( zeU;eBAEI{y#OkBo%3M3IoXf#$d?T%PQZCt?ZO)kF8AVCnQU0M=WO6qFk1%?Q=%qvS z&&dbjQPc5gMJJD*C>|-IlSc~M)TPZM(N1`D`GfJuaN*I47K@Nfv1moEomI|d;5D9~ zR{PK_GJ;~!x7)bD7KxJa=^dF&2GgU+5Yxe@gZ5A9o3s#I#vDlbXTJKNzUCh z0!n>6sl5WDu7dGPsa{_#p%lMNA+J(sck-kU9Fsj%1FH`V)4qc$_e5v8TYbPguoT5P zkx%r?#PojG!%@LSS0tx$Urz1`4%#)8-d4I)Z&TylNextEhWY1{phLr=jfGEJ=Q=fP zCc060s{=1$#15kSm^X%~+h8B^>x3t0y1W}NN$cq{>QJFck)?Cd($5H_#L{adLeM( z4Zp3j;52Go65G$qd=FX}ltmV-1~oQk=Lu!~Fkt$IX{A}EEo)YA&*It3L(e|svzEA7 zo>Mw-s&p7L)5_6N6tIdMT5v20Rthe>EDaAtCmUX6F!d}+JYx>i?2N39sgIcZHlgyCc{#G5d#!#$;zb0bkwHItC~h#l z+G|XxjkeK(zBNj)k2dh4SG9C*l7BwQpYkYsYp-mE6|)Q#hOP=327S5HvVfR-Xd15} zKZD$5YLg67VoVi7$+?v<@i=m*w6q*a3EEo!GB3h-4(fTNI7!^^Jk-t0U}?E_4uch2 zPh&*1td;%3M@37YG_HnZmP}rlAEk7V5RLsQj@%S4o7t4$AxV{iHlhdzLJZ2)vFb9! z{j8vivmIS}wO5W$7Z=ZVQ;rqW1;36QKTNO-ycJeEYHM;kYI3VN9@6J#Zsq}iVd4Ph z0dRZ@Fi+L-4l6SusMYw)rpUS7%CC2|vG}in&QhUu;$-7?O?7ZlDz4J!x zt~A}v?Q{>4#M*~Bi-e%)d0IUS=8qQ5=t+1(&0M2nR482J&Rp^|mr9yT=H`+vsBUa& zGN~k6pJANLFt9L(fKs+Ue_8>6noOdQJ_t}|;ZvLNA{I@8ur}jGNHQLz`$F@q@)~bR zo6iy6$2_IevJIyC67#jxw|}VIx4(Z)JDkZ?Gd*-T{XOS7nf{%qo9nzt?dwG_BcQL& ziQRRkA#&qa!*%slKXVUhC~B)d<6BSb1*C`Rkg1?&;nHH6+1vQ>#v5N(QEj#`F)t>d zY_+C|-mDb7=u&(xc6lq7euN=7NZR|-v?MCqgaP>zk!8)NffRZ{bTKaF7RC9~67phP zU#^~L>dFABdZi`HRlUl9qf<(X&RcdhU{mt;$lL~0XrJ9RArWZ zG)c6nfadb%=!V&W!jxC47Urz6w~k~Bb7-qTw57n4cz_ zIn&b!6Vx#_E)t_{n&U-J0Om3z#^o060Om4THl3{u*5E$VDJD~@iQ4lmEdoxgWIAMI z>pTKif8N}Bis*jh*V5Xo8r*`@0h!8sqw}h$YQGr!bzr;b^IWta-zoyW1D;JkQ8AOA z`+A~O2HB%pD=yQvKKl`U$uhAz?q;5Ic%H_CO=x!6+i^e2!_b{Mnua}*=cznb^K1t8 zV%(c~?ns{5599Ho?c_{dmQnih%nEO1uy2=)$!(M(+Q(0OLRD==N;S|eJ9RBJEi*?y*WL=shSm&5`iuRoftU)*)X&t)#h?_uQFL;(CBuOVEN`|LjN~w`i@COS zO+nlm2svoLVdu%Yg$5J)tBQH&6r$TiBZNc6&}28|4)aFo9_Sp5cNjG;mPwn~wte5z z+f@RlN_Bu5S@LWQ^5eVB6sZQcnIby|12QvadO@^8$FRQK*bKW!8t|u*#*s!AbDhiu zHV1+^w8RxaN5fKIsXsqZV>NRFsR~Dw*$T|wQkdKe{k4oLHrz;Pj~L08)_uE>-#XIE z!vB`O1m(D3>gecA#5)2db_3=ZY}sA;XK{&b&+?W;{ta9Vnzs{C^$O*!(UU2{NUke6 z=v@TzjGU9QzMKC-vXE}%$mHWU6JAr)CdAgYhZlQ`xvk}`Y?rDUMWZ5LDIdKByxC>< z-+zBn;-OZN0-JYKOZ~HdJD{@|(zk1eu02W8qFl>`1$b=LR zBev*IrK`mq%=L3yjhXqa>w59ma!H8gT=CWwIA4h03dIq$=2TzfbQ-<+Hp07e#Voru z+58s8_%pRGR*|-Y(<$GJy$OSh*_6XUFqQKi|GEgUP}@Z!*Wzw2;V#=gaCcRa?$W_s zOV`2Onpf)2`6my<H7OWzpqgWNs>esbMY5m8Uh!3TxS* zwDvnWKiE3s`Be$5PkWpT4gL9h>Lf0|Y#kQ3zh_EK`?3xF&L`*?(CHRbK0%iOUE6}n zC+K)$!=vbueF7Csn}>UWxXnXB9CN0Y8`CT^5mb)-75xS zRJ#Kn{`^A~WFCQ`>LwQE0dPhNFb~%HmZZGd4D@Bdp;^uZNz(@mJHOO?5uW%J`~=zf zCOPrHk%pzyodl}kvg+wBMf`5S`w)%^%>s5S@+`0Ue*n&lpcm0HftYv}AwPZ(5q?T! zTtozq-zy?8$%s5VA@V*EQFKCtlPn^}K>lz6v-6L@QGFGZn}#2$unxeOhlsONfO$CK zG8SDUO4;az$_tEhQVjEeF_B`tIKe>h9Z~a;HS>E#2H_?uwiH@7XM?;{9+cTE$#2{s2DK z!Y^hm`-6CISM)#-e+YkJ-B|?<(hoAt?jzImAxoQ!)e1pA{xCFZIrgLFf&N7}Q?FwC zILr2N)@>gL@kfAGNv8Remsy{A>aA}7RO=YS(3_+_E3aQiQ-?vR5?((F8hxTtxHVVS z&zOFe>1SL&6Z%=MpB4I9sh>(gzqiq~TylEN*sb|8j}qsVI6qEkf@e9;3LYiQTf+Qp z!B~=z9yNYzq0FO%1tlzu6Pn;z&a;9?3CT~tw*||Rgwp<{<+q}Y^`peatWp=V;{r_R zXSse>=tm@qS))+El>YP&Nlsc!>Ii=1i zbxx^`@kPh^BCKDLrp_1hWzrbui^lq5ew?IvrOzvUUg?ehMb`jDT41k9^sDI>d#{lA z(+#kLUH>u>EeumY|;1rlwoR@-vqpZ>tRNso;gdX(50?o_?Mn zdGfe=6sIT4Bl)fkmNp|3fQ_h1dA#^76r7=+h(?NO9stc0V4hRGIR=6So8*F2Kbj0j$=0`u z$f}R(h@*nB=&IbAhB3XfHBjRc6DeB*RiJwf^o|auvt(iH_U42a@1-r%&2IrT24^$d z;Qwlq2f?s}RR|NG()wA<9xGEDnC?pp`CyUHArrPbtmWN?bjQZB61iPwH1}s!p*3E) z9Qis)z(Qe!sVvagSPB|TLCcnDEBGm~M z17}~_hEDmTH7dUfu;mc{w-7XJCCS_*{7K{$e^XJ9Cd%RWzSsc)Rm-lA#VhRMaFEKAEg4yTcb@kbGq{=puWO}3+x z`LP~mHiNx&+Ncg>c2rhOukad|1MSGOQ*pbB z-~M!}8V0sZk>qnwYLz7-_g{x5$Khcy#>(f(-cR=)I`a~)X6na)(Vw@YGtrmSpwbf9F#6tnxmJHYx+g86n1E8exY4gX!+|gxPp4UTk!O4wgf9qzBaL^-HI1r;TMkUR4KKBy8mo_o5kFHq zoH0s?Ye%ysXr5Z?S)B}KwPjx8Xv$bjHoWL_VIq;3g|+Wtl&lHtIF;m3Cw!4>P<>Ho2b5K{soS5dYwLB|k zLVrRv|6&JgPIGa_vbzoL(r`>pp7Ci$c}qOK)OnUq_xs~)GZ<7mT*k-1IKr65>Kx12 z8r@hqG#^7CI!>El5t=Cw{7Z8E_$xRpuWJ29YqncLBX9rN?Nv zh#sx*0Q6{tF#g^GdPk-77+4q4gYgeQkFh(9_b;GF-Ccbd@)yx#n0^3yur7>Q`*DIq z#k*UJl85nqX*BtEN0ZQv%GTE4bw~d|(HhJx8c%ohj}*<1i~jM#=$|MWD0|y}yUi;_ z*J&=}fW}Y3sJFUB+Mh4!!1kj%*#+>Uzl#hSAxKQxsMmSQ(f=xj8HAM0N@=P03gE_) z^Rwt*@m5O}Y%n4RW_Awa&hTvJ*~YVjN5&1KOXedyck%p^=dV0E*SUu0VLY1a zW>4V9%ihlFRF4xpFIyjQ;pWd^SS{3nONQHtVi5mEl?D4sVauQ+AZ&%3|LL%E2bMC1 zPZV=8bu#QZVVlr6Y=xUYci8y@OE(ESAO9}FzFOGGSxQ^s<}Vy}!R9a%9Mu0+f;}(n zd)wFwH_2G#4i7Ay740zob%Na#w&_7v5`|4!fZdn8iqaP&Nmg#!xW{!Khpljvj77Wu zz|xJP-5>up!QLZmQ=$%A;U*aid*Hy*^}-&AkwK#^YtC%-go6qrU49lm$1NffqYzF?0e z$9PBLKPK4NVQzksU@L4#Gr=A`u#~JOc)g9HSxKtG{*env1{H3Sv1-ZdawiCTY5b=I zn||5jw1X?R!c8(3cIm*<6NO!h|Lm}L)`k6FN#F_vzLo@5gJ|;v>{bSopqkxPBEJ6E z>`u8D=$}M`^yT7@;*_WJ&ckN%k^LR84-;7n?-6BN038SlW;(^kQ6hFJ^Sn;?cb8*y z0C)G(y~ej%_Ek)ShIXjOnNrl;Y}wD_E-~FMySqq;j^DBjSKvRD=S-e+5AkdPelgGG z9r3jt%-!8|UyIMSI^g-q0zh_`>M%9bxUs+c{SbGM%&iF|dNeVxmZnO|S( zM>jKl(|oBg(6Y^0j<4?E9!yQq+~(FqK5V~qW3AsCYm$>okS@A=OJKgyhD( z0INzerXu_E&sCDMSd5ZKZ@vW%#9CZdZzu$YShceeFG7;^=a4y^Yl(LC0jXD9z}}nn z=2Q?rekRE|B4MRUqWi)1V-$N(buR=io31&}xQ-E?0xR6SL#Ocrx52G5eCa&H6_|31 zyINz6{wi9hdXYM?H;Q4-iFVa6y2k*^UHCdM)$RSMu#H4tu>B=h#S1{uaN_xPR2sY7 zDBa;tGJAUVvB=wJ+6@KnHyo~ph7?yMzUjbE7kJo__^7`M68bYT&soxHZ}2q|kmdFc z{Ko>8$_FfUUv^Xkm1+mNs~h?q2fY&LN{6e0XxIf8LFp>ry$(zhw7{A>S7_H^^bHBW z2gYc~+~O~E4K_6wGHJh~pb@mQ;xY=zPX<8>R*~;>VCny)A}BI4kxNC{~v5PxUvXSFu zV06}LI~W=t5X^;9-&yqb9Aa?7P`mvW%r95C!r$sQo(Ymu9}7^jO)^Q!9gbGRvi@V9 zqOP@JrFjgc%rI&dvpchNm(bs}6o+GS1Gyj`Byqe>mG+Z>*x~kkPgLL3m=R9`s}!dv z8!uEbwn4gcJxU#_IiNSF+;WsHn1w-eNR&4E_b68z$`16XWV6a`y76&HHR)|SgXi0M z*{OD3efF+NR*RV&#@KfoBG4ZR}v>_=*3A!u0QXDe?LEfAJ6Oq0timNOsRl2ox-0q}R74WS^rHjVq{b ztuHV)z9pccq?i3-?@kS@W_B1}Gr^PF#_RRjz1&J6eOo<67Ifdi**%=MS-|H#*Q?-T zuHY;lso*&)^G?)zPv~0-B8~_${W(j&?d9ga(f&ZAVK|bn9gd|wYqe`v$cmbCNA|OY z{u-~m70!Zn}1iKdW+eSu*AFbM-{_j-_0~jFQP+>U^#{Hqv1|`KR#D24##cL5xHV` z!xbC8>|lFt5O0!3<>Xf>e_OG?O!H%xgm^7Wc4&b*@(6b+w?}R~t-U zhc0F*=I3)d6uIZc9W5x)^HZs_>6hsNKeK_hUr%}VTnF~XBMFuF%Iih%qz8vVqi+}i z!iWp|a*eI{D`PR{SlAzJM5X3q8mqQfIU$MxZ2VCPnOKK0I-|B%9i}V({_c2nA~NV3X%%%OaQK1CK#dnPD#Tm0I0L4d z6myNHK<$hquW1zTab6YYR0b=f#H;!X&t%OrML0e)+VQdpCn`Ql10l69Bcaoc9a4*V zYU}=Jue*tNqTEtStW46nZgbN-tRB1)fL_vdF9aXUVDeg8XI@|}F5HwvM|p~9yP|^F zy7woMw+*y!*1f`cM%LaV!cr6I%Fq)kL(?o%TVV4ODw}8Wyz;i4va?Fo&bIMuis?n? zB5YBCEW+ATvTkDqdeV}deLEyQFXD_^$m-g`>Gc`CiN>bUgj3n*0_xVmE(Rf+P0@d{ z8B~qdMwstxGx?nIv$Y@_^+SbSj!BJ4eKV_E>{Qur{IpHh-qTn@_uf54C9m+6$&#*VB^QvTLZVzz`u~)RF zR_0yEaoMpm8lYD8!mHkg755YPU<>}BB$fzOgWLiVLoN7O?&#UP8qkX#N-n4dvk{(x zdvsfN#uC{{B!r6nl#UbDHYBo8ak4PLu8IPJ=Uos{l?c1(ufY*y;Wqg;dOPfv5gOusYL23e4JD}c7n77N zYeQB(p}j! zZFlpW)sO8nSFgOQ-$-_Jq<2*1$E*$3)V6iByLP{9n$!(+cf~TtP!@%w7G<`qgny);=nUKM3bcxE7NMKvFkKA$1CD{mEY61mZ0Qz8f)WS+A6vxCh{pkH z!G8pCsXTSvAiq~km*k%wt4-lHr^onxChzZ8*j~MuBaUSb-pO6U(YhgdI2%2VtFz{k zZEV*DWA=vEvkurqdm?pe?{84n6Rf?p<#ie+@a(?=aN@VXX8x*ZUEH7;A=(@&ng z!4On8Yp6tZsXv}DmNFu5O_6kz!A?%p&dWE%|0Hf`xQ8VgEZthPoKn?}cKxSTw+?=00=6UDYVT5|{yHW*t4SxhsGV3SW^axUBRJBVFZK=x@!|N_ z6oVtC{56OOD{PlSqF&&Zqc@-(MgkH@xg^`}1+4uKH}0cgh3E)T$@xf_vzFZ4ZV!b& zN%i^vVlNdo|MLR*$eT&(<|BQ)`8qmM_#P&m&i<(KBiVeV9k=oXY1H;xR$E@bQFRBHI%e~R#obcni0Mm6 z{!B*_Azv|bycazgB2&vT1to9W5cp(_UudpbTrT=NBlbvP|C#&OjN~!&mUSn346Tqg z^8f`uBxBNV>}lgn()tUH!D4|yz`bL6a^}xR_pHeiRR0{IoYKdhKb(mp%D#qn_ttO> zhRHyD6o4x8^K6E3B*Q8OtG<$1AyypULG{j z;o)9^46gh9YPy!KcEnU}jibXp#ceh|RNWlAl=+qC?yDMM-D(-NIn-Et z2YFWC*3r9nT}wsl1D(T3wNV{UEmf_Lpj$JWVNfzW*g8~esF>-{e@(OrOH=*(PwVp= zmqBBpxaCrjd0RVjG8LIbEX5T!;N)9!Q_3u@WmZaVPwVxf zLTIHq)$;jRlI8@6C;6P1=5rFBc_FmYJjBv`JV|qMJI&@a%_&MF1kI>V6_gDgxs2)0 zL~H@ieOl2PBFqEc3lssK+!U;p{};Lhj?Va=yB*oR=JFQxvgqYP$T(d~+4NFuk&Pv- zH;0wY(JeG)U#_w`eh3A~1sp2a20NqQ5Z!{hfp&kGtMkG^57GD1@J_CWGDjX~19XP7 zSkWsw^4dgRjOfKA4{Q*Z2c=K)_#=6=pq5A9el7~*?H0=;dGFif{M(UhT^=WSyhQd{ zRdLT}^t-_(8DVsX^5w+V@e|1aSlzfJljL%mF}M{xy*v1@?%)~SK^6~boK{+<_F?rh z@5&{a#);(QIQ4LV(VJ9&8@wwI73XuN_YK1NOSU{c#4DL3ViP8Mq+DL;%JM2UhirpA zpHsCOr$D{hyYCtFBi}jE*~qms;5`ITum?6Ig&IW6(_ z`ISqP!H`n04S#h>;(&LFm9+Wa|Ji0$B`6g<1dz4KJse-;xs+qF7+t9;0a z#+lW)8fVyW$yg&s=Yz~O8sb3U9LE7m`gSEfZ%L+OE5nceRlrNUhS}4Sr?y^iscaBsT({LuDIp<|n-oupCWE8M`um0--!zeFqV=R`TpvSzE@8}c6nuxm5F<@o^5>@WE7Y&zh&i)SZfqMO7W&lX&xS33Wk)c3zQ|JCxp z#`)*v=QV2KH|2k|^D{f@iEej(>e3Uv*7=_<|1HkHUH;cO|8Dtjb^cxQztQ>E$p13u zKSKUD%bzgYR`H@6T`ZjLiQZyo}!8*yQjLZS2R}adT{(1}?E|aY||U^jwy;yYRCu zd_RcZ?{XXUT~f=7>9g*+#_oLtgwg#$^Z}t&y-{v;wG@U|PVjmi9&Z3{0KbK9_7`%g zQxL^T*7wtQflWI#A4`qEP+^%r78!jRa z-q{8Z#8Y@>IZx1LjAy!&r|7k>_)J(D#1EsoQ@MZ}V#KoMKf#RVtMGD>t8Yst{oR9_ ztM^oAuE?q)`Tl+TEF1)#Wvk zS#!M0%g0VZ_Ux~5-tx>ZfayH>ut6Or0Nxs>m$U&Xe&`W5jn4K|5(_#2W*ogw{#pdzYH&S z=dA21=-^;xERVR*@E4F!0$_GZr(yCqMF?=AJaoCNR$W5gHpTZt=nZ+<=9k1{iu+|1 zS7wiS0Nj%T%){{*vy;lvS4qIE`0Fm6vwlGTN{VhC`j4~y9;v#`F~>05?;^5K>^N4S zoV|E4o_Qg(>d>;aqHigaR+X-!bZFo#HM)<8`R~fV)GmnPn8$ZSf_%NqrSOMtM83jq zy*NNeGc_Ys!*b3gBNJb^Js^Yq-}`R9t{D_-~yt-&V|%46SjX6;Yk`#-@8c zu3P2pISA{0Ro34!XOn;PQn0z<>oT1F+LCKg zxvHJd)6#qz%0~#TG;XeOUy|mKa}6Q1(wt)X{2)n##z^baJ$Dj9D-DJOa{R+2%~kC* z&%$ebyByEF5L#(mpZigg=8%0(2x_qZl&hX^9^@-+GsnxHBy&maDFXc2KwKt7S`U?Pq&^?m5bf!~>L$a*o=ZPg)8*u~Fv!h(-__&b=_vf6(@}WNkaI4|=QQVIbaD3C zXp|;3wZZRit|90CDz}aEicTDhqs{&+Z8P%#_?1gk+K~0f*Y~+=#Q#JW(5Py0;QYFc zQ(lN;ap3%>jk9baj>Un41+M}sud#(V76;Dn+Bl2yvN&-5@Bla#2hJbcIE%_-ap3&E zjkBmc76%TzNXxvaJQlazoBK03T>RF&3(=cbz=70@{-Wd<2zKrFRh%K3HwZERtr+z$ z^Q1cBe3PgDAx?Vz8MJVs*Pn^k^wYEO%nPB_-ydyhm@`?L-R(4UX_~8*MhLAmND+GQ z?@5|@OS4StPJ7Zc&sG{Cw9-7*(i}+A?6ovyrFl-8<{G6DLMzQbSsILaE8BA|jjeAz zFHQ4&r4d3a%@#{@f0EC&?KD_qjt4JP8X>gOY_&8!Nj@)Xr@1ao^J1kDf=+P+xM~tR zZK3nC^MY`(Q!YX95`;Y~1W+>xq89b#nq71p`bgu+|HB>kN=z=OMQl^VVHUAg5i*D@#S;~AltoM{LROqbT&jp8ETXOmnQ9jCWJMfl z5i^Ql5y3?~O%XMV*r144q!HW}&iPV{SfdC@mq^ViG%r!|<2j;@ygV_tsldr*3X>Xph|>dZ1%$aI*0bwv@+j zCn#qc8c?4|8e98^4lpT~4Vv3-U-3Yi%?fjlTuWpw9JdNgKO% z9q>7c*3mewL4a~8v?}hn>NpA1*Mh2JN5Y1@PD85-#hl5kmhrNYjz{bMk!){#fxHaF zw!p_8!#|}_qb`auMsizY0C>E~?dZy+a|~w=EIrR!Q&y2vGPLF!#C6_V7jT5#&f!p7 zQfkf6a9XX&{{0XeL_se7R37v zr$rng7j7gA4B|%QwIco|5l6@m(u4k4#5pOdZpF9529OY0We^|i?m-B-a2NNW+eI89 z$NHk=GL)R&qvUTDaV{|saAc^sWOzsmT_QeYIIWT+`DPghKt4F;Yjuu#D@*1MVwJbxRH!9h#QgDiTIm=a=0wfL|h>tjpWDg z1ne{s{Xzi_>L;q`4okstO_^@>BYoZ7M@Z^lOY?j!!GSog=AiLAgmCDdbg_C;4r^Xr zhJz%E<^9kYREwF}`mmQgOTw?ji&Q+S1 zw$uD`n&x(;5kf1?6D^I5O{I~&nbh%L(ll>Y8X>5T$I4Y5%>&@L6kr|zvnjwl0FF-q z<^ixV1(+w{6JufKNmdrwwo975dF%WcB4d3an_(!{o=g$6hdDGk+`&ZgSbTk}oH-`t9L0E;cl9HP zi*AJaRKa}%E36%vKwqXj9m31oUg1V>r@mZ$%~{A3HHJ8P%VrL9=m$#d<9Y6&3zzS> z@AJ?ALu6WAghCye6lCisIw}*~;51Mhb%EtG*|C8dABYvkK%NV=@nBv=zhpe+EoZLo z&L%~u6!PXv^I>6j?1F6X*ad^xu?w_st^?q*5$E6!wmkhw%)j9Z-6ky#ZM`zM^01p< zqrVTFe8Dk%TJUu7&BbxFbp0}y!a>J~KV9LSf}(-5xcs!f55w5`4cqg7i0!oj$b zU>%w(`3|n!aD^)lS4-;)#@11iJjFUD26s?7j6N?)nDV^%l@?Lp((Cwo z+78zeKD82TLqUu5ZxFxPHPm^A6JP>6Imkep->P7mVk`H2mioMGklSkQ)Ss{CbNMZO zxnRRDa=}{Kr;Op0ejsTEnVd>Le5EK>C6u6z~9P$V0+wMZeMBDd1>z<-&DG^LymFGQX=gVQyy>+=Ts}nZ2&ZLTfj@%7HK3 z^c;bk4t&|VBB+;4ujBW!>2qf<@2gW2BoMP|NA$-CFRE-9;lFCvXwd&FMVH@5j^q-)6f zCWr1=I&R+?=*vy|biU|aXzJ+S^z&|h`txDZkmIf)v1b}@7IRG-82zlB>|>7tU7Y9x z>qOT7Ij?*AiISUK$$C$&QrmhOV|PXe(l1Heg?@z}=ux^uJ%>tHyEs?bvS}NXbCqpd zPYWQinZUuGT;-XYW{Im!wN=oVsh~vjI8C&16dc}8N#vx%cdfJYSU>Kx{mc$KuvCVX z*)duB=F64FH!;j{??!DiSB_e@IfvR@lPgVA?t=Rk)P0m$reR1|*7HaFv%Pq7mB~$C zBS5-MuN3fi7FfG(X|7V=#6lD?Yd77fm~UF(@zYy#mHFutW+_aUDKS%GSdp6DcsZ5h z9!C2n8RJ5iB|7_XMRtMG&m}R~EPxN%$6*%3m!$A?km^nsZAPsv%J{2%--8mWL(YCi ze(Qj7G^e-|p6pnt!;&t^>#;K@bv5YH)EfB@zSp}dRfma^Pll?X zL(?-E=%|>!yW}|7&FR{Uawf!6y}8Q9nTZD?*Z7%o-G(B_E#$77BYo1#Wa7nb+@G(U zxo$p>ZaFGn+VpWM&E@(|y|A^JDe)YgJR$DvT7L4CNq3WQj=(t2`z_g#TkV^BFDCG7 zln@h2bLD5rF2m}Fg&&Sfrke(FXYaGXW$TX2SI*w_CnNJXM_V?{M|m!A7}J-}(o`he zF@0ISveUg?c^V0_2A$g^cb28JZuK>os;^#zeqmpm{hf3{5Mg-AD2_goxF2^ecchzT z%{NEdZG}aHI^HE)`lF!LPRUg+Rp8$hIGTgJtCMEvOte_w?QRM;W-4bI$4YQ#cg}1n zb>&<+Q(1jNS+V2({v=Ui(?=N6BGN7R?puC~!0ww~i@B;W8_jL}lli5hx` zj2x$i-Y9QZ_OmwtI)oZ(S`_O}yiF2Rrle}7RlTHIZB8yy(L1^`px^h*7T}eA*PvW=)@JLCm5`f>yGq?fP~*Y%(7KAgqa$Xu`L5J_V~d$gKNFehO?t_9 zs&+z`Vi-s@{pnm{eQI|;wGGM8RpZST8IHA8bggN=U~VJVaJg>*zE@_QeXp-Yc{?jB zJ;h3#uFvNT`4=R5AA-#BSE?JdG-!tn*3w^7EX`;hos35<_4O^U@imb#YtBV3D1^Pv zm^ZyyA6ihpo6#eDmob_CIXk)b_&gkD|4GGQe6V_+nN*RlS2%DN|7(0BJetAywKz_D zG>$wh=~elK$}QE2xlZl6XgpCXB$MOLmX9=^v}kv=>!N(RO6Udf^YP8BC9CEu z?0uN9vab07iXVNDAN$Z^|E!E^_;C6nn(Rb}-FygFMjvu~2;qagx&tfvaEn-N>tZV0 zgk@jyvLT-12{$m(*Tdp~%bo?^#_j(|wN?(yo{w^%DkH&;%DU}a?Zbrq)Yg_Adh4ey z&U&yo*j<6aRs{x=3bd&F|$zp0!rEWFpmEDrv6jSF9h+3j-J2g{vhV#rdlyoO>t$hgrmDRf@mEg|! z2T@s0oAOOW2|yR&0Y@8P_R)8PhPTMcl_%W=&WpI?PeL83l(U&!^ZB;qugJ6 zd{AG$FhP3}rQA=2G?A<|PjUTX!UZ?%+!%crB;9-4&h|zQZlpGbpJAQM=EJ_NL>$$c{j%O} zw-ay2)uXT`zE5P~Vfu{PMa+NK^|RzK%@@DcP7l@|nX5d0nz_vU%tI(c+6`2;j;tBA zum`KtykEW63gOwpGX_?e_zE+FWeVpzGs!-Ra+_ywRh#)!U&7}d%AMbpZ9G98#=6;c zp1qXm5DV=O!!};iiSl`LNDC$Xnr-9m77E$1Qj(x3yV4=D(|KJ#^APx=KW`7?NRo;= zJ5ANs=sS{K#eg>0?X5h_VgBxZ_dQ>?7uPr+3|IaI^yr_9>AmqF^q$>C?`Mai_r-(J zJ0@CGzQ1;t?`dGT@_lpR=gqbGqsxos#!ToifS3UqNN)UMtxASvUedN^)|=&@l{lJI zXg8G8W2U?-JX^iUFRkrsyh(+B4EgH) z27?p-D8<|R(?fcHy07tHomh(XqVG})(K<)C+H5utfb&v-d2}9ovuiZYWB)6vQ12?< zbX3Piu}aC?-1A1aJg;P4Wzy*JRdbao$&JgYg&Tj2;x4`hT2bPpp?q8@m!)3_bHK(s z$Tj|ii%C8dmc-bLcoy?bFZo_r67#M!jSKshK8gEa8kguT&SRu^ns5dHC(p!X%{wWQdl^yOVZH!WC%zYiwZj8$!@d)E(&$bWbInfz zvSwoQfRA6U`*40#^?C#vYApP);Q;B?q=lc?Q!0szN z-X5tz0tPbmqhJpR;RHxb=ZuLi5W+l&6*YB-uweSnTCemNd`S3eqmRF@h! zHTjy4=WmY=D0LgK!vRieVJr&YuLRfe(Oy=9I2GYVZxt`2F962g0=CjsjJ zoJo=d_~(FkCS+W0Cp;AG+uA6i4bu)v8&$o4c1OaC(k~LxIIn~r4R2g;GvH7hA*K85 z5Gij`%EH2w3F{V-dTfhVc3VNh9)0&3He_~5J~8jb%>@^IM{kF-cC%*vNv?TIXmvHC z?eV%seq93L9I^YNLk`}2%7pwjCI2m2`=F^@FBP>?5Pw?Y>}1Z7?dZ8ndORx$mbVBN z(q6F$z3Ov5;9S!ZjK_;UN3#gui#~_Y_$BU9h+jl8T{yl@-i1npvrIweOVBoZF5#Ce zm*dbgACyC0B!<)r@P|zYK8=g#GgJnLMfuP^j4|er{{M5W@6cR(dRwv_@9o}`RK6C+ zzP&^G-p3o3Kc(=CzVIXEEFEB1o20ZjVHJ?rF}LxXbZl_pR6$EF8h=XTcy-ga4*_)| zp}R~B`L;x5vpbC?Iiihxy|0vEw}v$t=_9|ieZ!bvDQsUi>SOdfd^3+%X3u7i~tl>F|l`Bit)^MBi3rSP8dZwB;+W zlY8M%4|&bp>+*7#rJR$08#9g~FV2@SW;~TDb-a7}EbL0&Jr$I9PX`!=7rlGBFx@U1 zednRlVT4=`t#}ne$=hcxfLYoOFxIyNB?a2S$(8m{w%p-MzJ{Q&g^-* z7d`V#tCKL|&w&tP)mh;41ne`BN%$_pme%qTk@!@;q+8V;Zk!FsP#t(9_|$m$dRA*a ztw3>L>M4M@=C1h#2%t(@DeE*Rm5$;GRM_-NvF@ z{b%7^dF%Sg7NIV9nNocymQe}Af{>P4fJOlNk#Es;IOk2g?+=647H`z}s& zfbz3?(-^BI><%>Jo-ii+(SWO%-e=eg-Fd5*X|YKdVHcS60Y^>PWgy4mc0R0b+r5U9 zxJU9#^VE*63|R@Pl}YE0J7>%}W#_DPPGz%mW$dV2IXmM#3LO*&Jhrk-sVrW!oWkne ziyr$%C}m3HQHP7;_q5~J9W0)*r|Bv7;`GmM$FDzF{N8r_hR*m~lS0=4y2*HppA-6m zhpR^!{p)8wh4J$oqoanNI-z+o&Bx&@CmZo`giHhyl9P~hACVsRN?z0tKbm}*788!2 z4je6u+b5$BgT55-sXWvtqt(C_zQtp%eZzMzG+J-~E{e#LpsDfy{2mu@Ws3c1r+%lMTmjQ^x>{P%o!5;(1GOSwzY{@p zHpl7UZvenZ{`7nQ4Ht_8kR0eF$wzb5P>W~{LTfNl@_ZUMIzqGtQ(Es7twCrF{v))O zKx>Jk#blc))2IY{t;S5XcZl; zyvNnFlcH5jX))o;6pPR*CbSOGjKfeFc2o*pu@J2kmEnX6BkC|DhSTDNM6O|-)<)EX z>1`8Y1X3f8ROl7Ms3KA$ZBiqU8hId6E%L24tu|kyp{m;RB1|cRrxW`vXBN3!rqs zW2>|;H?=N^`KD$t75RH$hr3=Eh2?tuUV#iA4bkn7e+h(xc(d>)JJeA0DZm>WiflfH zVJPO)oeZwRb6BPLBI#yXUI3HtR`e`fIO129FpMYBnY&#N&{rwQsz)+3~cL zz=jq9f%fRfv12cC?K_1L)SkeLhF_KjDp(`c&v9;2ZdL$mQzt~*$fo%tQ!BbGU9bF> zt}nxi_yuIbX|S|fyaDhsaIHcGD=Fkn{k)ovz}v_K;aGSt?fhftZR}@jW&hxC?}5?| zMpqYC&75+yWYy_@M%~PBNMpi=UvMTvng0RCg+Lj!yZucs$wWVaq&7HKro({^lE~G3P3n^Fm#4i?~&)vFp%5VON58(!^*IQuaLO3O(Z7`QI z&rj>m>SA}|q_eG}^OBA7 zdOr@umtN#D;frm?>B|@vf#443Qs(43DPPt>S*VLCF9%vbhnog)<6j~PeBtXT=2*YN z%dL+#ott6@`g1KxxsDbC(K^tVy60xeU5&ra9DA74;ga*~;pMe0UXCA{m#}e|(uj?W za$$Yfaw;mwzGEaWcW3F~>tS1Uy3MwBbf-9#RJmgpC!Zqqo(D}mL~4Edrdr|IFKkX_;1rIQZQTE=^DUqIWqdF%0SA(%{IZKT_*cS{`L2sbutiH|3< z4tue$c1g~3HF|4HVAJmUxq(f0r_Km$c3mIunie~tO~W^!mCjq2FtP*5%`){yOTRLyEUyVI<%KIo(OrU)mbb5y;+hQ$%6o8%Cab!* zLWQZHmI&m?0LO|Xz0n%viHn*f!&8Xwzb&MCQ1Lz1^Zds}jKHCP!B&0d_P2NsgBSe$ z_=E$kcUf7B%v_hsgENt&wO#A~jx=E+bsBkt`1e3sD|H4c$A3^Jwo=85T->L7l$Cd? z%)ywM76T-zZY*>3g7`Sl^vws))@?aGqHhk+boC+UX5&99Gku-XEwycOZu}>}rjYw< zqfQ-%*}$!?Wy^j0ONr+Fapy&(rE2RA`1P5|N4frRl5dAE{K}+tgK8^0hx*q$ir6qcnKAgg&-91PPrF+YJ-~-YwV1@mjt+^V zNxoY$dN7=)i_)~M`R%opFjjV+L1wl~ZXN)<`tAVc0r0F8U>*RwQ-FB@%%uSH0Ju5@ zmIlm62Yh321W)(Gpg zrZ&u=_Tk$)v}uRsRhvnP!_Ly^po!@U9-JX%Kbc@@bYn>jAK=h-RlnZni5 z!d`(4Zk9FjT#hyo={2!V!{}tZ)nlQabM`FlkvIa!$fu}h*-a? zA*d4IJ-pTLihh=IWO+K=E0DpX303YnDaONv!P<4WS0IB&%S8(AvV`KA%slLM->rt$ zelZIx?gA^j)RS%5_Vu2RRN*&z@vU@Xpyw-i_9$t7NE$XZSS@^%q3F*0hcm{-yA`~_ zYvhlnv)W}>eDh=lWoX_{xuTW$qD#7y{Ow>#DhElzT#|3@2Gy^2lHc>(wDy-lr^(bH z+$)g5qeBYT{> z>T8s!qdR>PL`NtIeblqPDCQc)sF$L|ocuxO@h(L;vy|IZa4QG&hS0pc9{Yi%CP$Z; z>w0q>C=BQO_`%;V|A73oUBoq|p{>R3W4wKd^?xPr%h{W4T0Fae2$Y_=Y|Uj(Bs}{V zez*bJa+(w2j#_vIh?fAJAL55svxPU?r!?N2Kyi^D`&jTix5!Zom1m=~Sp?X14yg5Y zU@Np!p=b?km>&`Ln9(bT-}?^5NvXe6eup1l1N&urj)FbER7sXu5?-|M<`j;3KP8-J znLyh{aw3`|p+25a-~a3+Rg%Q4%~hoHdliN%l29y_C9D z4m4Mg7)hRAi5vLy6*>AY3cDqV2H*=EiPDfL?7K!~Tc|mX0=q+VU`Nx-G@tkEP5{;! zy8789xu~Dj+VM!3!q$`Kk5mkI)ZkdJa&i|5I%fFgaQ_iW(j=XU z^9Q}?D3F}cac*5gM{#sdzvS+gTU;9>YogU9YbZQ-cELDevL^XSWvwdd5$$^+={VQ6_qGiW2S);%_kIxcvDxw*ro4J6EjfZQ$3JxoAqyU2V#@P|dl| z>$(Wg$R*L@i}t)ggIw4=iRHz; z@*6cDfbyEqIuI&Tr1t?{yB$=W{>xK8y~|DenLg>roeB z%w3xjG!KC1rvUS~{l#CB$4#v~*jm3@+QEx7`bTx@6ix9%Guz^%-Spqb;dFH|HoWs7 z59G^CUpG+24cvHG2nZTn-?*+{U5NQywC&IH2^;mpwaH`J@9~A5kEAI_dUNS#3UVEv zDd1Yf_!Tr${6q|nHMMnxov6bJ7A4WL+^3N1_-=t#BA+CzT*o&HC`o_b74776*dR_m zK0;${Q6)`Y*Havdg$@_nF$JC{Q{ZSw?RFq9{=1m(0vzo2OL4zU7t%@IRh|Eb^sUsX z-eaAhOYi-WLx|FQf51)b3whCdBcxLj6w&aR97cso*ifrFW^;D%cO!Gyn4+7ULmx`tN+DKcqOmn)vpp>9RM<~ zALG?eQeLs%obXCXI(Vhc_}T^V%1CkBE78WRc&~VLKS2{FdFFY$PCOE-@hC~7IL9OT zxbM<_MQP^KCQ?e*#VG@{Ic0P@IHj68dtEXmKES7>hDqgiG~S(#6KFR2zOCE4UcRI8 zmqW%S{9S@;a|honPrg<>4IioxO!d$?j_;X4S)#bja5ifxLXFgHn0P>{*FJ!j!h&EY z@&PdXI4ixikrz5_vnP5HZDw;3HS5iiAB}3ZF%$;2E2Qfs--x33a#`CNO1_8N`3b%B z`;1xn%Xh7Ntlg>RW9-!9lxb|!Fg71jRl z+}qRJEJ@Eyx+j?=lLQhj)7=BfuuKw`u*klH>`OpILG(g*g38b#ZipBVQBhGNMnOcy z72FVUdHUSrt_XREio4I}bLIKs|NA?2Z};t)Ny2;YpHF)3sZ&*_s!pA%I#qS5D$ZAM zle%>biZUB-qUSFKn{n5M>-+5=X%t@YYA{Yxn196zgd6%lqX9(pUNHl`+miIw?}pw6 zrb4qY;c^Oz9E|a%sa!4(jBDjsFNaI|011!7I>f`OwU;SFbJ${;4U%CKWM z#2u3(wa(so(|q-d)M|r?Ld;I5?nj+Gf=7F@u z#xLSDkEEQ|=Ovn&iq`5|{kCZnd4=Rkmw8BGM^Ss{RH^ zwcE}++i4!S>oj*K5H3v-=}c21()e{U&3CoaoY-}myAv9hrigT=DKTm={cM+$NoCw# zSMNH_-3fwAQ$#w`lxQ@58>h*bn!3B4=9*onxjSKTX^P17G@sM>l@cXAwZmugeYet0 z^b;LA!_yni2HiMd!_+2v1_qNj<-*uXIKCLuGq%+NfmFB<4Y3`P9yBn4r-!uq6y}o>R)$Qo1a*f{A z)PtK(Xn`%!aBfcax!ZTg3nIH#vtcO=sj_Nh+O-_PAxg_3T;kg1j@!>}`LnyKcO+HO zPme#lt5!!(m1y){vorp@E;%4CShedmwt+6OHRotEA$X;#HOaVWzOr778?Eo0to3)B z;=CoQ?UrP=F4b4caF!IgUElUE~<>R z#_-)`%=Jkk61OcUSMjV(`L?V!{+QsP<+nUl(k#CfEMp~+mSGpkjTx8Bz{A%hdHB}d z@sI`T8MqYu3&$m+s=Z4=$ehL~YCQG+HlGfj#wR7-;?wRDcYG3&7N0CT)0kk{X)!@z z>|CYRcYNKSHFF8{R|`pqJ(CVir&@6}&zVBLmHJYzo#5hDIMVoh zls65~ElL_WTe)~B3L#an6+${%%b`K4<#4`eoV&V0M*7Rz+bNW0A1C$Y6S<>OGcQfwWI`B~}% z3R^F&rk|6|f?uB>gJu-o?PtC491NbbX5d{&+Qqf@;yiYBi#4~F#Xjfp1P>n3Vwp?~ z3^+IO>UgjnFZY@k=}S(Z@1;^lkq>)UZ}pkD{NS@XM~%4_yCBqWYHxlE`4#zf@uQkk zhw+n$OFeuQza~GXu-XE$<7O8zy`ZM48eEawv&+kxv z?3|>|;y2E3FMgPeq%eW8n;zf5_x;h2UN0qc?TLH%;{~swNG7%nwKogCQaytgyg{(0 z!N6}8{6dGnQ?O(n{96Q1I{e!OtA&8SL-6w*{%wLKd*I(F_&SH*B3NPw{!N16fzo}e z;KdGqyI_{6g}+O%Bo+8x!5bZZt6)h#_*(^E>0Q0#| zC^Z4#_Y2k-0sJB7{XwA)cHSQlY&|v7XtMdZ0(CxkFH}n=b@odF_d(<>-EI)B_T3td~#`TTc)*FP_D+%R0s8gY%|jP$2=!__$w|$p9 zd6X>x*wlyACp2gV1$*d^_4}W~9!6T_w>mdt@rTEHGWCD7GM?>8vLhGSXZNIn{TwgY zMEr@^zR`@mFkEvc@^M&RZxGQrus5lI>ie#Ok_-R=Uko@coM_Ax&Yr#awellbpl?cj7`lF=MAumu?9O=U za8E$%cY7=4ycz8DWH~0fehu59-=KKc=DMRp$v@d%$X7FYbr*$4B`8i#%Bek8JKk7o zzg23kKSYdDA8Dr-r$*l$K3}2KXTBF|A0^C!o7Yi~T$i$7OQyVVOJ-=%mdw22Et&Zv zy<0NFBl#_vO9)Y!6FSnfC0|~!B|o%qOMc#>E&2JwTk^xi$S)v9ejzdPi$-Q| z$#V}|k-uCIxFx?y^N?YqppEa+qAkUAd6+*#L@cJ~5x$t7Pt;<16P;~(z6;8MYX$96 z&@KzwH4mc2u1(UfqCh$zPoRtfWh_u;9%&Xco22+eiE;v-QWnLHqS#RsKZ?eXVs?|3 zNx#?_4_Wj3!sc?HT_p!|H&$Zyi5g6a!iXqBvX zM(32eU$Pqf0i0j|FmmHYU=ynDN?+E5isPnXo|YXMrvExQ03$9f+m-n%oh)V83Y7IF zPY{Ox4rMbm;M|zPN^VZ#`+#K2v(v5?2CHKQrGd*TA!~niEnBIlG8`E#WS#AT*-NNF zB}@fYK3YaeF$w`gOQq#tJZU)^M@kEcgE6AWm?_@3{uudbZ&30aUfS)&^7v4^7c0>1 z#r`SUi}k@Y^~d&Nf2X}z@pTdH;x_ShQcqWU9{8Brx|_vXSg{j%g<|FBa~vEof-8y8Lhzo5lev!_afB38!_yFJJE z8SVCzJG0wUhGM(DRViDnDba`I+n$$-HEb{qIPsB7xfCZ$NBjRTug;!LQBr&Gfa_>)Uj7aEGsBcBRor zxOHdHjjud~+tAM$BE4Y%cKaPpBI&VyeIYnTS=5Iu!Ofx{LF{o|c zNq#;~e%PdKHQg0+>JQL0)IX;jm@)l*A z#2C-4iXL|M#K)KCf(Ao)k>OF*=i!mYKAw-v>C<6Dh^&3G)hrv?@`?zg!;BcKyfPk2 zxh`@UU6jKG2gNx|CcZNAJ*MRwETEM1|nR)$dBV|RrsRb-<)bL42OdNes!Iev!Ss)1Nf4kGxRv=+H%pj#+d?~<68TcG*lOX@E?BvRx3 zkU3W&vd=NIO)Co*6Gb`JV9x7pW_{O*EITB3r^f!q$7hkZPpM6$18j&g)nn4@)eRPW zGy^8(+^SHSi!~wh%|eft&2y`+m{#9w7b+S-HgL==Psx8La-MG_j-Q5 zE5vjOMc46WeroAKdP)rQeb>eEVDoy^ZEw_%*ESkwXt{!u7>v+dio*4g3A%eF0csy$h6eAZ~z28V9Wwvd{x&$c^2P|nTVP-@Br{1)P-4pLX} zeKX(W?+M&mxX@Ud*aXYiP=QHo=(dqT95S(rFSVK2wCHy?$~ zTiAT}#356|)IWDT5U=wqV$jq#hUnL zD}*~azfIJq2fK%0gCm8;r)Kun>d)Xv_fEVk&rjrEw`VoBiVPEgC^PF}sAn%EGZ4xP zZN65(-}1=C?s>o)U}-ViU0GZ|UX^|^jlfmq=C#C57|1#CTm7HB1A%->CuKd;`ll&< z$(*P!LAU<_#4nD!kzXde5y`k~D}AX2k-eCf)ih|0(m|$6u0d&mPlK1O^r7{*b4{+- zl%KfWYBoZkgGOP{F1f0Xx^q z(Q>*xAI?>IX^S1@oRs;0NGp=Eu-r1!Ssvb0k0QEKF>6L2QGTOoh0R+;3!}c*qgnAv z>2>-x&Ze#ggQMvVmph-)r5x!x2KVSnidsT%J64Xd#tO)7l2)e4nxgTYyj||X5Neyv zteSGWY1`;YNt7R8%yE%EC6uZ`q&=7k^YG_aDk z9?aS_>RyqwC3+^mYxzE;aiL>PNb6Dmw>6=7t@scXlr*FVFt|jvqqcHfaHHeU*y8%5 zaWNcf^SV~EvvDu8UQD$9S?!HMi1Fa#@Wh_~wo1%|$7x86Y%_J|xU1ZdRl&l_ANwH+ zZD#cMeqz|&poLSc9FIIKZu7w@%v};zj-G#)!i3i5{y0tS4zF$GLXG147DF#!?DiPdlB`bk0zc z$gZDa`mO1{UJg{05Iqs`*0C#@fM{=oYp7gD%wa7j8j(8pt7Jdyhm6Y5bbaw~YWM)B z)6FO?x2YgDLj2FA<@h6Z6E~8UlcEBt=W>;Iv1>!Tw?~=9uj&28QzE{L{$if`i_?yb zaxim$;h8dE2DYXQ%-nUH{X}qi^3(GyD2SQ}pJ)=|OZ9t7&zq5FZ5}%O#EAjRy(MBaki7O?gj1q0n&QU^R zgyuz`GufAt5`w388QeP$kP&05*rcYHknd}ZMy;g-# z@6)(KP(dq-MlxVLh|WFwsbR`-v&vzI#?0UEPg!cqGnP3hn34SGC%r%irZ>KgTCmga zx8Z7>BIyvy@WHBB;t-N}?CGDvCtCo5?Zfr&#-;J6HEQk+Qnp0{n(P2|^14liI_ zKQu;5Ce%kruBPuxCDe-pl=LpTi?X_lmn)EJdFJlI<{2~h5%GT0zbGFax`p<>{{QF} z8;wh@e%DZD$q#(et~3hQ-cFY&qh9QDOjL}WsTXR0Zk?{JUp&y#FVx&K;i(8%r+y)P zcp7Nw7c4fK&OJYPiL#~f>DlDzi>han=~e|YHL?0l&mTL=wS@3=i1b$WbbC#%DY{0; z5Q}zJsOGa4r)N74>0St;_TA*h)8MF%o667QH-LqPHTF=R>FVD_`LfyqFXNC z$pX4MA*c-(U+5o29@M=jPp}G zxLqLI9Drt>+ZH!$Gc#sTcowvl+Z*ntyIDEkPk6WgQDD(KI?Juag;(->KEDaLtbGr8 zv$fF8r(J|5%QV{ekZ0vsyydnPFDp}%wIoH-$2#r^6u+%xO>{eLhbVq@rrXkSbWAAk z<)(6U0=FIU6j0}x?svVbwf-+!9eWT<$+`4;E{woy<}=-*y^}NDqPJPBXEn(tcjzS| zWSa=>Y-*#xiaiU?o2+R+_FqZ2)c6O~>C2kpT84P0OmOdsec8FjQl=1|%O9y9TWI?F zzFpsIoZF@vrG4qZox5aH66#!i@=DSne{30Oz13e<%Px1j3!J7EF^kMgGNnv3bp~>C z;aCq>C|aTBq0!LVwA2sxs~L9@CN?Q*LiXOy>7=KBQ#=#P)7s9^7KXmIO5%lA6WuGN z1Fgq8k0}AJ68(+!H^=?ywiA&zJG$;>O}06{JO3}bd{#&5KiwrAa#C`t4vXn3nNNe? z9dY#^dr@v1Uv0gPp@2DsSmjiendTI4RJjWCN8_1`@j5wkiBw%EmJ1f8kQZqYh_@*lz|s2(9V^COOwU4kxRBaz23c^kFmYwh-g^|gLT1okj(I4%p>! zdC!B+S5#h?ORn{pO0V0>hXNz^Yx-u?mbfpqqS~zVv!!DNWS5FpqE#g->T{KWyJswF zD?2LNXybDJUP}io;x(sAMEOlSejk?O?(HC>t|rJE^alOqorD(Jc7(>CW&- zwQe`dupk^>Nfhn;W_jAT<#3Smw8!j1>=}6jv~m(x=e+>1C(GGMX*B)5Wv$j#8pv!v z9;Eaet9!2hbKfqO)73m#AJ@m(TUhvEsId!EsJ({^W3xL-OzNTwW6Pt(OthzVQtG_- zr1~gMYAm>lz?;+(q&HoSWAsdCfWol%PS9K&wpG3-F;aYww0xTq23lfgfb`7-a6#L- z483Gw+xbGAyq6gVz5-_=@P^L7*S4Lk1IY|<7Vj@vWVz{!JKR^wop=6pq){>oi4@Kn zneBWo^n6}psf#7)kwQg}`m`uk6t3vpZfq^XldoAF_osHuMME0q8oh6m{V0&e1nH=6 zA&ejG&6zUk>|`>*k5p7NF~aEn$G3Q?)Ylaj;Zr!jsxNo!;jVgfM?F0QI(*JEdI|pq zep12cuMNJRFP8+_@B0z%B(x2#H%Wbz-yir*aK}-~-ypu$hSKgk$KRk@sO8f3tuFSh zs|_}zs0Xg`1*3|S~~cKiWSkhRCN0Lxqi~<$Qi6R zI-TLjU!f2M60BQXH&{3qk+r8nPvkGSx1amnuW=bt-B(xpcj-HjPP?PK18F;yH89XW zV5hPMx+=X<{D+mNu72Ln2wrFuT*yomvk=A1R{Hz1i73I#h}X}CP4FVcN^hY58>U;o zyERxiQ;q?6AuqOkay6=rjUOtpnByMvQ_=N^D3K%L&)N~~tib>&%WI&!zrZWEFLtR^ zUEoE>$3v2D2Jr(uY4`07t|cIs+S7V@<<>soq>C$=C80ChaqWD;KwsK@XZQCNX9w3Q zaQ#gL@@xgX{ysosyK}qk&6COdwaBSw_X>PNa__3oG_8{tpQTQmxI zJzya-JeJQa(j)J^)j~kJ%hAx;rn)d>^a_ytZ706~I|nOt!<1F^ zGFE0d7nQ~)QgWS@_1IDWt+j}BY7X7Rx1gD>9+JN0^3sY4N4&Z(_GT^8Qgx&kauWVP zOjCIz8MRTqW)B^%1jl?tX?16#K1==8iTvmUQa|MPXMTtBJBnWq^#h|*hx0un@te33 zM?^VUIthFDcj=)!^Zd4XI$hNd;ZZASyDJLmDwR#;+sQ$HMD8w0MfiBa+q$=ww_M?m z65f)gYRg-$kTOn5Q_aK0+F7o@GcAsKyYP`jN+z1El;jGZm=^0{#rjDCZO6pIza%iz z*lB6oQ$4QYTxYO7M`vJ-Uu|D<>*mYinbY{4P-q^2?yDNNh_?TkxtJS8{IQC|`{p~& zv`C>G+kGcAU#Fcr1Gw_&0k(mP?r7tqKw|wiFqHf=Acr+y`Vw#Jav75q2ud(nu;nV1SQE^(OjJvBjaSqhpgO^Yv zQq**ML|>g2(O0KK^wnt)eRcXnU!C^QSEoDly*K*a8hv$IgMQnc&JbXyF%(j#FZ9)E z3p{)~k7Iy!`c%(IuTzR*JLT`f6KjW^cing);?7;h;$Y)X)JV_v!EBYC0eS&$>Z{^q zkXv_Lz}%M^$lSf$nwIXrS-!%-j5q(O3RQo0H+Aqm)uG!H_iW3rJ5yc3=>x)~_g(B) zhwI0j5Dj|i_66R~>YkNxUQiRYZ1sR_GR~WJ5hv^DxFb@2b$R_yoq;{;l%4&MnOfN* z#-P}Ewq%KZ{#~>Zaj|KDwSzM#3!PSnZSx#fj&vv2Y`)PwQv#iBb63Hp#FOm4rVa|I6yR?0i1pve9W>+;kO#51Fsuz8kE&=xYGZ-(E*I{vWsXDM<+D3r{e zuQ?BhWk2C3mMaYRgUVAje$A3REl=T7s%0iFS5fHdd4zI)%2FbPuC%|J5W(LF-YlD^ z{;pz@CDMYMeL@dek{C|YY-KoY8MsTZQ8pRi)kEhv4s@0IvAJBn=ZnZZi)NP7a=T0q z$;X@2$0apCN^1KRQ3P+&LffJwmeW~y&t+VbDob@)y?SD-R=MQVNZa;fPSzqOiNfly z*cGW6h`5zaA4n^kNjq!Vdg+&?fcl5jhzlKSoF{;%sYG?TD?4lPYA5%jsw`$_t^DlP z&f4;T4WuL)`8DB4*jYr6LR(vso^zY=U!*uNGuD%xw?@6v#JBiEXNs)0vxEu)C6@KE4 z3d0?s^0daYhdf;_!X1<@e5sn$UcwGpl*$>Ncb(k9%jC1C3vbaTl|64#DA$yhnOlFW ziy$hXIV{{fBgKmQnuuyd^5u}My`3k>DPEK-lh$+WSil^xPFj0`I@jTU``gw!yi(|p z(PJp2lTnq~WE3?cMTNJ1jBSp8oZm!4rR#S;cYm+4WAdpS#PYd+$~(}dsq>_JuI)^} zEuY5!gnUX0Og_!SST7m0Dli%3IdNBM#^xQRH!w%AkxBYdtglG6kk3eJoWS@^2@LWn zS?Q3^yJPt@0D*mXj4%MiJu$)nmyTo@HMB#9Mf-eRMR$E2U18MWd6P=niT!~cYrWaSlJulJOZ(1t^lXeTpHnH6i0z)gX^tmirxiPX z*`_uxj_uE_3?>K=x67rxpW?dQS;CpallNkYOXKT3OyM8;cY zp4itSBKNvpPX!nB7;iTkRD;Y|Ie_7H8dWVMy+&pBbr)_;kAWofc1^-_rx zlYv5i!A&e*K?fOyuo~;`@18NbdFpKui>@a{E{0B^==NGgtPm)7Xb-<_XH88Yp*`M? z(iR7{=3@Qv!~d`g)@i`5KQ60ZM0?7 zFX|9?`^@couj#goUc0Zg4kFRls<*Pf*7Y1Jfcjc1i1oFt{#5-O{b|&Lxz5XPs`H{h zRlmj45M9+SKg|;={PEO*#iRdw;=a>>cHjBqDShW^$f)mJ#W(6Z1-ia-DTP$uxdu#A ze}E4be2{|=6?}+bB|S`N8~-1o7>^qNL@J?6--^dOV6MJ0(w}%Wf9OLkMQ>76UB7rF z5JE2e#HkA7O$z1u#kKPECiU5Xs^>Ki6Jk<-SN#;~F27;7TGv$sbl%Fo;ldY7qh@+T z9Q~~>A&h_~`-5s|N|lE8lt{Tec#|sRsxN`5kDb&~YFi`|o3c@Q;jK#K86r5(2v!cn zNAB=!sVGOt$D7ngBZf9HT=Mgy5UX-~T%epoq$)-)MPgw>8oA5^YV=ZEejwOor6fOqM8&)4QFY>PCK6N9NaRhiWsl!>Bd5 zhTu2V5NL;L108zJy>ZJk;Hdf+s3On)25)8zqR)tR@yDjL#bY3)ws{P37-sYwh`i>S<^52Uq7a&L6}BYiG(!+|G77f3Wo1 z?aX8*(at2f*3Qhs#6@k%icLYZbMFMoRsW9C?K90E)E;POk)%5z_nQ)O+L`3Lqn+Is zw=)Cob#rgOUO1WlIWi-8A3?mvO;mg^mkRWPGJoBgKWRntFBHQxwWqN5V544|42Bil zaNeW>gj{k{7}<0DJajI(%V#(B@#>3}+#WNA9vfR;zYOnbbnFJ3;12i_YcVblyk-NT zOeq-RQ=^j?8UquT8B4F7&3%?6h-WQ-Q|Y?7SvvJ2CJWo)ZK+V=9feZw1hZ;JN#jnt zbUKhW&|mBy*?Zr`{9U}}^RNgYaI??7aox*r;sz=d^w^q*o&S06jRkFXJO{5E6y_2D zm;LmL<6TNLX_X*-PB;WB2fDbtrO`(@?aWwL*aKM1Rr(uigyY;8yZ5Vv%d*kJm3gnG z5=$J(W`lMfXmd}g3!^{BE9?!75u6yEK^Cmes%XK$z@)ZkFu3gE?XD9No&tA?EdpY?U8=q4yOes~T zyhUX!b(ec8r*~C@VtVA@u|@nnXl#hTOUBs29yw&Jhrid2aiDNy`FOhATM4q&a{ZIY zVlh2cNTwub2_!R`$*=kr$M9T66COKe4X~(aRl4Fi4&PbDrJH5n5N@X82KtJ9os8^j zF_P!Ac>&z2zZf%;ZGUja$Tc8z+F$Ig`CUw?)$UyDDfT)!=MF4H@81y4 z&La6E=Z&RD_Qts3f`V7?IVEndJ89#4jcb!-DKf_T%akTEa;SMOFi+lD)0Z^0Z-RAS z>T#uQEV28a7t_ZL(%kyfJLU@JiDLK7xbMU~;!I0JvOltTe5ikxBNaTCe!}$u6ThV0 z7PJ1^ek3smG&0u!k!?5sx>*%e z$RVw_05xV&r~xE77yc6!w%9$IFRfU|^(`wfVeTM63rG;?&6mf!`@4$0mfs4mWkz75 zAc6=0RyjT(Kv&r1fJ~S*0Aqn&Wpy@t_7}s2z_L20@!w=@Kyow3t~Lt)OBpSW!nf+$ zmrx(sfua7PsjL}_Swk1skyx&lX}pG#_r&GvcMPIq8fYhL%;^-YWXIg9@QEX-8*(x_ ze#(^4yA?futXyADbrrKy+o+XTwN}1){qv@lZ(dx!!Qx>KvFapWQp95Q(v;wvMHGe79!|VyY{Cc5l=I<#(|LM^nJKL->fTNI>kxN)Dx6%kn6T47HiDkNuRft zQvL9MUMkb9dc3InDVy3t*F14*tIKie8OD^P!2!mIsh#THV>9%$*Nrg|ni`V9Y+i3= zg%>QLn7vVH+SI*Z5qOfAnrvfSc&-b`h5G;%3;A#__nkM6y-1b^>AylB60R`hK-ct? z_a2{{tyWFo2Q`MGZVbgzC*E0v?NRbnWWk^ETIB|`^45|uMQkZY%t zbLr$}OlOLcdFWRd`V$pOgW=y;>KS(CMtjY&U18CMac@dx6*41x=}Ns3GBuiU{X;G@ zQd`T;bjrQyg}lBNMlSDcD-&-ez)a*8%S34J@hjYuT0OaWreG}Fb_O$p;5G<_uj9|$ zvE{kNzkr1GcPxc}nx3he&AUq!>({k}Gq=!%NC&ScS~Z7ibPWp2Xd=kW8FZtq%c1os zhn~c&vT{^rWc~OcM?V+Db-!QP-C>y-xlA7Cw>*YRvBwL>XM6SMwmdk~kVsy7#bWsT zGx%#9o6>x#|NO{* zdHthsbXuTYcZZdIv!pV&Gb7FjVoL9gC4>`^X`?|Jp4Wffs!gq_oI~M$ZnCI?7yRB5 zx2+tINAb|?tvi~~S(WV*^)4Cn%8qArl&F#}^=zNV9eQVLE|hnp#lv34rg~*}_RA+7 z_BQRG6NC;1uk7gl>Z7N{vVb*=SKl{wvL9bRAa+!}A^Z+%JGqdvet6qCALmhR=R%w( zw4Dn^>!;vyW1`bVe?#sN4f_2F&EZ@djOUSwL1$`{^~VpGQYAbE#F;CaN28x+tXom$ z@Xd|d%&nJ>O?rENhF-8bKBZN=J~@M~bvxuZ9&BVQPjh^m-sJXD^-Gy|1;>hgO4qeA z>pL%cJlX2$#S4xy*Iz8y$5_4UX_hrpaCMphT85FV%P4ifSkV%1MoG8 z@;Z=jQ?8#N*XbQ4RvcR9?#bv~mAP!(DY_otQuJ!N+_QZN$X4{OWc1RgI|zkU(k%8? zywvj4(qmlNJw}G5uWa$*!ML~vz!-XC#~1@#UG&h${mRNZM%rAbqtGYgyz}GG-_io>qt6mf%pCE8)#VKH)o2wq%fnB*8>}k0w(?Uns!tS#t z*n@J_g&o*^`@k;ex70C@BH4=I5+r#$6Lzk8N;_k((r7+9i%?2E`Hxf&dBo1eB!#uz zNw!xU3k|?eeV^6?e+{47i*nxN`3#I&Pd<-tw4N-`ttTJAvY*zIF96fjAK;4wUnp2> z$omk2HDpiYd$fkE=%mTFA(=H~BkN5ns#`<81c)U+;U`|9Fy5q4ZVh>zJiSSM zT{gcDI&Z^+d=S7GK^?8thF;*!)zWXTy;|Yg)!bAq+uExuwb-n+S7SE~%k6PEKk-$5#$WR@*%=~(k{#AwBdKr# z;Ws4^9gD7?iDl0K;>EJZnA0J9ml0F4_iVnA>ed(y`Av{Hli}Mi$XUSo3}%9L7CvX`~&(PGmNpPpaOe{#Fln z-{{1#cy0xDE1Rc4MxpGylq>qYsOa0D7nQqGN%BdJPszE!^W(sWw3#GdcX6xOG4Yu8 zJsjh${as`GAcs-SuKgXNmO%SU?m2FU>-wpK*FV~#s->eXYOc#T!TduNyz@Ory;ZH$ z+I#kkQ{K{68#lV`HfBPUXk(IQYh&hN#ZWskIU<8>>Zu*59jP7Ajv@(n!tFOD-0gO> z6jkJESq{fHXX)xPNxdlvFSS?Bxz4!#E~Vdmn0AL<;pf!+2)Mt@+W8(3eGiPj6VZ27 z^xaQi%i9s;4Wljei6XcvMw+5!6@*1M?E5Uv%$U|bPoN=;Qojli9FugMgrkf;RciLr zOM2nBkvIAmK%c=^XK9sJ&HRp4RNq9CB>FS{SfB6ir8L1FUl3jO8VBVJoz6%HCt8vj zD{Pz%m-2G26dXjFC9XoU?73{~ege&v5UkX1l?OY8*OCSGzXg8e*^Z}GmX7o`wxI2d zj`T&}+3u^CD>1s~b(Z=q=+usmI~DLIY25Bekd;^4Ay!^%=-em5OW1MF1Lc-!gBVDq ziL+(Nsbqv2OZ`suz&-ke(#7d-Co9#39?+dYR=}vLTagKE6(Jhw)CUo{Z+4cGN;Ms* zm+xGD3;FHKPt|@VKaLmK+YVYjyo=u__fY(Dq^_3qbqs8rE5s{$gbKTrTVB?YjHh=ThC zF~@m;uV-@wkE0B?n@gL-aVrnFM9QS_SwM zd0f!O{@t*_Hn77Edj(;cH4#>}KpU^4|Klw1MJk5KeAm3})W^a$_InPyku|Uc_WKTd zO(*sT4tqr>_J8(4+PJC`J>jD6l|UZ_nhcQ+2dP^DS0ZFEQ4<8zbqu?;?nUCjZc4UqK(YP!_wwqLbX40a>G>-Eo zuYyE6d^Q2XcW6L#;|tnE>fc50NTX*fHcbUJn$PHcHEfFAFW;#`O@vM@Pb~)@uw=~ul+6gFiJEx zUYZ&{*v56~g@2}Zu=N%LK>Q^}7y#n0F~R^4e~S?YfcSfiFaX3;F~R^4{}m$)0P&9) zVE~B#ju8fc*byTP0P)WlVE_o`hA!&{fS45{3;^N92m?U)F~R^4=@?-Eh^`o60EkSC zFaSh0Mi>Ah7b6S+!KGy`V+MdI#0UdGbjJt-K=i~213>h~2m?U$#RvmH%#INTfS3~_ z3;E%DfEbJs27s6wBMbn635+Y80U-XQdf{7+Jq!TBB?2y_0n#&T z$n$?lo`ZKH@~Ck2#S-SzS!8aCjBBH4Q6HfZ@Oh8g!b-1kwi@D>UBi$rNH3H6qqU1W zGOc#8XWTCQ#y1JdG&%fEGX7Uxe6=g(<3BC_0db^`E8u)fY-evQl~aW!uKjR@pv&9W z+j*mRlVZqyhZpxoc}v&Zc}q9Wr7+6e`FyS4aQ6ZInK-tu(s|CY9KJ*SST^_?Nkl9C zw?%wvybCTi=fP&LahJehfqrwo7{480f!vb{;D>h;fWuM1;hCfyBNW9CABMOezMCL+ zU&~6$K=;e!Mihu!!+S)|c}T~tSX!D|S(K<;swcYPA_IXsDKFzJ9~VND z>C*Q}w40KBkMHsts9S$Ot_&R*0Z^!| z=z??S-J)=}C~#06p#*XXz8lC7KPaDPx^Hj@j0rzXMh50og8n(dM+9=4kOFb0;-fe{ zzW4KWG?0@5;XcNv_Dz=Z=jzg26gm}>r=fZq>axTLW@19D$*d|`= zBz~WWTbTs8{Coh&r){{k|EFf{zmI44<#?&Hy!|&jSoga;j$opkau>`AOe&cp@5TK8 z8k$i3o_6g@iQl{qf2-nP8`F<#GxguoA#&@}E757IgN-kdU=KIT>fyTZ3pjGjqKwdA z*g8$LvZp$oJ8+uzYmKfqAG`wHsn%l=@sPJ*$oaxnp4C zGf|~hZ=|)4ENpy2KJ_&HL@D^B!GmX{t|~|HeBhx7UJg7jf)4?nAHin;4@dAi-~|zU z6Y#gA`W=D=IT6JQx3NV|-o!4Oyo->4A3g5jNPNQ8K^LVRgjh;|0vq5zykokF4=;B5-Re&RQ5#SvPuyhvz-mU<%rUgip^9>5Y)OKpcnk0Qfo}X)ZMzs+BPQB`< zxVtmz`AZ$?)E|7`n$_8XMU%$=^nR5fRzGNuQVRE zt^K%@PtIoH=+xdlSJ zR?7Vk@m^Yf#QSo)^!M$$^scl$l@pT}1S1HqXS@v`grW`sofR=Kx>~(`QZx$axhsTS z-D;u`y;Jbs-C1lABzpR3`c!$I z3uroI%siXF7=ugUU2Wc$%@G%IQS_KXGQOK=n50E{eq{TKTovJ?KPWsJYgV_$9B`SM zs#!(yxGpt%Q@dPGkl7ukyGZJKazkT1xkYQ<1a^WYFP7L!!6WEOaT~cZY9m=I_M)-9 zvRS8${eIVJW0~nxxZvL?xGtm%egxTCPd^6nECdc0GnLsOKMh}tUF#Z36H85#-p$Et zxY<=QRnX{Iu+g~qr=7ja78KX(^3;pAxbka0ul2KkQvQvHYDULx_z#hTTB-iUm{{~Q zkzH8R-l#jA<;Kqt(wn?m+QclIbFy4TBFOkrwsz(<sm+(s5h zjuS-cdgs`r;%ch9R$pDaV*rT5VuS%84v!HAuz>h=?GkA9T0GH;Upn}vpqIvw*A@JN zTK4+V!B6em75rS{4zZ(SVg{VaDOeD-OmLM}5}eC&BecRFrSC(`s(b=8<>Hhkf0+fs z9!_%tM~eXpVNJw%dKNtO;HeAl{)S&94io<`iOn;4{HxIv{a~#sDO>HM(`Y4K$$Ep9 z2fN_YmQ6~*UsN(Kec~Qv1GROa#h$ctKH!^zZwsG^MHDU%Rn|Suvv85{tf5lyl;~&; zc2;UJdH2b?A5`oW_v&CKd@&q$QyBJxGQ)c!z89)U(u(1gVQ0ry+f(J$+~L~>N8)0F-@1``WR$i_j&qF z`4;C`pf+E;2vZ9FPNId_SvF_4EB5LeNZ!?VyaZCcCOtHEST5X5q>;734nDP&xn<_o zb)In#(;xLP{q!(J>tROLx*o>#>#k}w7rvCpc75g=I-Y6|_h^2Vo|P5t%B*s=Cs%H3 zsyW0|5>lMABXg|U^jBd-a2UL)E~uYD6SF})Dp6wT!V7*+8WBF^Ay5qa!k_S2Hju9I z)b&ptSe?Vt%Kp@Y=ABGKF*A?i*le`XMX=yMpp>nmZ2Un$sF^^QZV{I=kyVF?;|G7m zH`L5v3jS}xYgWKQ3_6#Hj9hPBtDAqYT#?F8-bI-QIA6j*m!T?9tx_lRW3M3fEor3$ zx`^Mz3-}WyFfxaS5TVwl)tR!ZZ_9q1$^3feTHJ6?tcleLN{gR1rI_<-I=ZdW(~EW0 zJgZo*f~!;~Huz2egUi{B&|=Uk79OHJn`&qSyUVH@zq!ven{21n%}m_UiWTQR9sF~K z;yQtx+dtQ2Z~k~5NP{0YldL)u8gX{+BRi`!os1CMUdgav7r&RouOVcs_iiQF)&t|n zha-SmmI}X4$bnL2tXK-aA&`>~;Wq)yz&-degZu#Iz^Y_Z7K`1X6h%VYSo`J2zCeW* zOBf`UoN|#5e=Lz(N9L*puk7kUY>dRO*we1w339yi%8#c2ZTYIXUJ_V!1WQJpv4YNXRO{6jwE_ux#8 z(RXzDbOfXR=psLTk;ZWKSu%*oXxy-bOk1@{aXLIS3%PA@vUlR$1j>is0>)DHS>RW{ zLD9lGpk1`{JgT=$MW=%+Tt(N$cpP`Vymgb#3*;UAgZ$Naf#5pOwZ2Tak*|9}1on0l z{sItOVa?wxJ&}zNJ(=)%xT{6Xu?1L#+5|4D)AvC%6P|`w&KAR+4z*gR6q0I`AAC?1 z8r5ORsrpXuU6A_3_hS9XOTCeTvDBfvTTNk;Eqk}$gZg65ZY-irf6G_;z)5|}U1S0= zkoHZ@a~hrTA`*IR8gxJ8{PDH4O)dvALOtBc?G(W*lrlzXD59i0X+&lSD!I7nh(^hs z=PuJOa^$g8pi+l@C#wS^YjshtN}2Nm%!~`H9S5JKSLn|6yEwy z|Hp4RiXVTqS1tPSH^z@d`1l*AD|h@;Ut3v{DX$x4jN{KDesav`Hx$9R>wBLU&we(4 zfKvI1TXlF*>)UXzsZlH1LPoP4FJJvn?o1?;>;Lf0En|{*cBAzH;G>D=ucu6oT_4e#njhUmsyWmc4XL0$(+e}itYO?IeM*bp(xP;6 zu3)KF^lYK>LC_o@-^NBwhO84vk6h0|X4j2e6j~v?uwdbCg*bwNu}(6SrG3T*`$cIbc)w|a-~!b4o!+o4DK(4mDNHgqYp zD&|4c2z^h4wkr3+v53gM5s`gx`!?=ZN4=0MVt4?=y{Hndz~N9XKyW##LU07V&vGhj zrA7QWWNdu1+M-%@VVrvAb>X-LxP<`KWnQ=-qI^4k;X--Af=67!f8CO8B?j$qn8s`Mo~_o822>4%5okq*C4c-tQ| zclqWk=nu8;SW0hYm+=`S9-Jx)mAR20nzsD99Ga5_B$5e#C^Br7I@gbI@i;*)-8hN3 zl`PMyoC1I$u>7;(Blz<+r-t8bcqBf-D*k}^pka=RF=^8%tD~i!%8-}MIcKy>xrRXO zPxeGux3~C6+IAGlN!CHZ!30Z(+LCifLBT(dCi8eHS2*)rHJaQh7Ezdv9%k7 zDSJ!yiM+-miZYfFjedKMKU> zem=o!@-fr<^=%!jkP24D`bC!+3uoB+v5=F@NqC~&%2mxdM1MPI#)LQiReWUvf&eQou)0@|BSL&ut+D*{AOSeuV zbmLE?v`Hw#2S=0PjaSAYPFD!*_X?YYGQ7Rn6JTh;H)UDnOdIYha1VRH`!p_YJTt#!A8N!)~ExgI(6qtxt^uiIF5B8j#D-j z%L`m3esQrOtD#!vIK` ztRC-8%FnsXOsL9h7K#-4X)0Pq3{Jz` zd;on(M--U~_~FZmGTl!$1%7zLjD9ae`uy<54nL=yO8=9(gXOucSh_4bKPh}a#xJ;t z!Z@9*wntPZnPYVDSsI(YZBg0Nccb@$X+fPwaGsHqF4rO_i;fO*@@!X-lJ7{E# zByusUWj*37f`SVYXc>t_CQ63(g9{VBG7j-WY0sPYpUQFBiuj>a=;?kk9dTOp^xBXm zi62UBp6(}G5S`<2VwIsNKR-zBo%^nLgtpU@%cb?;v zP3gNUeU8Pb#m3^OL`>=1Ruc*SM*G7zrsi*TW#XX0j#;wmr(7!EXZX&geA_l4sP#NpuX-P)xYw6-`OurbeHvSvWO+pzyI9`MG2{s^x zJMe;Aj9{v-jJeC>18G?CPrQQ1DPgFQY7{Fy3&Ak~3^xYy;Vgh|wwPN%qP^pvCl@`_ z)_B}GZ!h(l)X06VoX2%l`(h#K3jd}AF7pBpl79V-T33tCI$ck$r9Rk~cbxSNpCnTl zcsqwroY6%*%-l72Dj{tUA6>aI4cZI4YeDI>vsq9447zdgBXcP`812Me}B?PMhOHDC+e zxw7%)q_fOcek+WOaqwEUktb*+lWP?Ca(xI3IRMNPUQEoWr|Sw1Bu?U9je}AX>)jm) zto&cedXA(q0lIv@nVy0*;9|MpXMz=4;q^xj3hD&k_$qQ^viCMpX<$iL*d&zUgOenC zY+_Y<8okO?c4!St|0zG%2O6wjdqJI8j?hgpp)D;!LT%KaHlcy8T-XPxfkNe4%y?%D zgk|fAQyVO1wqb#k+|j8$v)IM#dk(>>1#MAr0H#n`Tg(JZ4=M>%jjg!>(5H5yOWC3E ze$elxsO9loOo5d9A+-8hE&BKM7j~4s38SK^V*PDMG$z{*5T|-+-rJG6E-q2K9KDs} zqJnf+_QG`73c^mAZs3@uZKi6Gt)>AIsgY{V@=Y+MTH8jF-N_{L>OY*l@aEJ_B{w&t zhn}_Hs~oKJ5C;-wNV2zq9$^++1QpspQWxB-d@gd1klwXm8_@N?s$IUG0D5_k6SkUD z{U;C)JcS*$5B9FJrqop2KItHK4*b5H>gs20Ls}MF^1d zo=k4?+njg~4bzLdi9^x^?3y9&Tg9>%P@-Z zvsF2(sekIFbVsiP%6D+GU>m27ov4SHMi;7ci|K7lINh+}P;B7T&pSWbw(!D|GWU8) z<4t`hN@df0d4clk2d^T`##hJf@$I-87||9s31#@;3<_MxY}_1&xl>`R@e5`600jX9 zk5(tGdGkf2u~2DDZeZf(huEv3pXteq7vc`NvXd32$!p}t-BGx_$@Ms@bGkODXti9I zZO6^w9Q=#GXNGQOVSE;MrlhxK%UxTu;eSDJx$3GbweQSn*~8{9Ch}l8j+}`iuJ5O| zY<_<|ozx=L^NGwGIXw`ZY2{_;^n;yL(()PVs90#%2(qVYYN|YmDh{5d3SPEtMO>Lf zHzQ;`+F9%_<+m2Q%SF~ryTf64(VeZ2U4TiF3!q~t1n98dcZAhIkE(y09KEb`kF zk6W0tg%M{XOg21681X&AaPuB!nw6$FTP*CzoTNGP9<-N%%(jiOU`46xybG!KTI#)) zJ>9$)E+iWPD-IQQ{as$@yNs$>E~+Ps>RzHsWBv{X1DwC1Up~g#C5u_+&WFe0=A`kq zTAZ-kp{Ju$yVCaX2=(KS>=%xZANhrey%;GD-`TSuoc?n+S72Wj% z;H103D#DHDP=c1?JL+${A+C(^BmDWsZbWQbBgP_YNykvqF)!%|_Yl27$)lHALY@~} zo(C<@9XV>JPH4B*(d4^C;ln+l!WyTVZ{ue8(oN^Y1I?AQHMZT+lM9#OqxTnk(hd%9 zB^15qoV@LD=fdR#81n{u^R=7{Q7w7-T=+7WWnE)Vw z*ZE#ZU`#!*01E#~7+&IbS$`!Cwa2WDMSD^vZLsvu>i7D6s_#a;G1~CMUkV5=fB~3+ z`Qa~cX3dGd;)hS-%$YMU=g)EG&50ICc7KJNjWA~06}N}>5hQ;ZX}NhzAD=$vFMXN8 zQ=`!~9EDc{`3Y(-#S=gkTwE(V*fZG6fxbcRb4RzRDhM-x?g=U`Rpe3UJJeLe8u-&RB0j@5@!x+wO{cEJ@1i$W(PvI(>?6Eoh7piDTucwmZOw`{3kqREu?Y94ps~ z)zy`V)ios+TU?|?m+Z6=JtSpmE$K`5B~!!EnOv_$yeE!WOvf>o_I33oQ^e63lTJ%% zzB3*iie2rfnZAt6EOJ|b$BOz-m2riYkwLPXK2EpE7jC)y(EGV535Ku4Z}rQ7QLXbk zN;BaZNF%FG_&zb-W8~XuggZCkXG=<*mHmNB# zpC5mMYlQLCK7wyHE7TnN^ntX%Sf9>#%XVbnLY8guJ*-;ew6x}s78l77ekd6pT3$+i z*stMt@{E3?=C^uAKPHmI+nbi#%7f8-7@8Bvnjc(3QP6{Kl@RId=Vkydo|Ou3?xu6s zV)v_^dn|U}WbU>)G}fPKJHi9th>^M3MSDX>v~8F|I__nhUaJg53EV~mi+PKS`C8}B zxC|1`GA8~EQkE*^^vpyFT|Ad5yTzB%sMh+~`>=o8N^xqQrB)l^WpZ^rm4uI(JGsmZ zw#(rnXa-#xy~W!mMb0XHtUuv!g^g{ix>BD&o@&Zhx;+)>svcOs2Mr~-7?p9p>8b2o zd0R6mxtXDaCciZ^PrFTTCVx(wp^@=$QSHKxxM(lnQCm=xJ7Q<&d0VrI*j{*`YGP^q z!I%J+39V^EI(Snn9Tr;{IJUi~Rm3IrQ!kofrjf9cO1InVc+;=0@Nc<%XuRT=?l5g) z+kP>r@v>izaIc6P_?p*JH}$W^DL9sJuV^B7TXSV^Yi_7bXKQZWwibb{xkNGj>Ut-lNn{0v!ed+Y6(cM#Bsl&+On90|B;Sx6t1^4Ki^_)GoRb~CKi>1J; zH&A_s6L6bKb@MUmaTRW-|IM;}dj!Aeg=eYFvT%A8!cg<(jsm_Ikbqh>aL$kGL2qF(`)@mV|0rqT@~I*u(bv*7Egz7Bs^+jHk&u)4=-C^c$7|%z3KLn zMt0*Z4AQpBvy~`~)ns#%P=*hf)m4IZ{E;pht#K|(1t+?0Qa1FmZ0AECb1W@emL=*t zv#DG7t^gnDm2PrndL=4=fbp;Ku|@Yb+0RRi2fruJd!@!4Q=p z*sO9}sRexq=(*!PjB0ZiBQV8$g~um^bmuCKU@klq1V;IV9dl1nAeIr!ZPk=S(h}cF z4PIQrw`D^+km>6xk1Z_?WYfX3S{?&g-ju0vHG!e(^(Sb6ox zYrDLpH=9@Qj=8My4HtXm^>6Z$o@`!yJLVoIuReJ_E-&fD<~4iATB!=Xc*Z1+K%bVc+NZB;$hlcK7CI8f*7D0G-sH7R!Tpl;KDJPD*Odsg z=^;#xQ{!rfr!YImv`0;^{t-G6*VODV|Hg-XvY~Yb#?JnX>;FZ;4RNfiWNq4DHw#yq zN{l`EQ#IW`j7Y7F9Oq3=DkHY|W936bVA_@fOFeQgV`rg;qGxSGZ_yjg!b9ZNBQRoO8B3GSqm<=#lYc`K#B zhT^qW7;jR}@L00xO$ue;#iJMc8#Xbt+p4F3m%!jdB6Nd`FngB88=vDM;Z$5xtHk?R zsa5cvjSSYZ-$>jlmmTU`s4Vd}yj6%kf4#op9_qL&-SyvSJk(*jYct{NRh`6_%(38? z`i{m}KX`!jWg&Mw1z)ZJ@;?aw3GvkVv+}{U87B~;wikD~-$tf*s!Sj6I{mdV-kx0T z&R|P;A_22viX+}-2y1WB)k!<1t8_)R)kd_&MSq%FMcT7dlW%}_fiK3MX$GKUGr>uO z<|da?{h~`EWhLWIX4s&g<47Hn$a2qu`rG0F*<5%sv7AC?!SXbUQd01$7A5e9&GbBr(m#2qoh01$795e9&G zYm6`e#M@$o0U)--2m{V^`=JQScU)$_7v=8#aWDgjcVCP!0K^AkgaIHv7$Xb-@u3)D zz!g0H4MK*=S_Wv!;ZUP^y(j4Ngh~`^Na@qeYc)*zIZ_8 zei)XT_!BQe4N-K)8VZe9Okqqo1RQ*c8}@F*0KI-OQ(zC*Rc@o(T-w;z0juc>UM z=DVHGI)!?>U~f_%o&3?{xaRv6@})ySO)U}PZ7YS_MLdGPKxf>%GvTS@c+IUsSm13- z8DZQaNsi0G--X9$}Yg%8LSx`z6W>VfVXUSxcjgLbhl$q3vRu5fcj*+Q;?Hd+(3)mK!}d-M%2akR7Hvm(-6;o>%vf7!|8n8yqDbv%v@ zMYJzC0)3mOPhKZA)a?Q?8&7Z63dGh-cqs`icY8MT3Cr4hv2g~9BKy5fMd7M}XG(7z zmLd^TmcGzs>v@iLQ?y$%{g}3vZ>G{`S-;pgGor6(&_7G`M;!ghk5c^6CsC~gc;>7w zrBTW0j*hDBYMOxomypf-6@!!X_N7CJzYhp6ix&g%_*jfE0K~^*gaIHv5hDzc-picJ z&d$?M{LMO}=m`D6%%jn;I3?`>o9qN>3cQ+XEns*Tlt7`2mgwI9* zf}-%j9R5}>#pB0#*m35dS03f&-HNbnkGR7q+cu$Aq=Fs-Y|Yu8X!BEq;?dEF&>Tl6 zyo?0OJ3KZgg4qO~fUBu(JuxZY))iOXEIx1Rj;uZ#won)ptLuL{| zZG*ek?{6!#2-}wT@@dTL&Bx5k8}nRVr{xiLmV*JY?eE5+bWE3SM%EImegv9JC5nti zr8``8S@mseg>;+ldr!-O*016`uq>lZ_nl;dYbZ&oTJg;Xq>Q-C|m3%2KJ+?P zjIPx8VFjB-^rfE$wfbIhX4`$z13u0?ZznSQAVHmcwZ+?np;nH>PDVnBGVjrrQb%%X zO%}M@Jl4OTGT0m~ zow}Gpv583;A0kri7%%99FIs<k{2aM&umiGt8Gfv z`Zjp$Kn(za6{tfP0OGqb!T=E8ixCEZ_DmR}He}riyvqi=Azn~}2pb}f z2=+hL`o2j7Z&H6-^5M7%S7ge;9K@{)nT(3OH>tmoj8Z%mh^P_%q1Qk(Qrt z5wx~uD(82aomOfll8Wq2>aP~hGzfbOOh6=}KO%&Qr~x1zi4g{X_;HLd00g6< zi(&wX$6|y5AhyQ{13>&+j4%Mi<1xYjoq=XuMOQZ#z3YC6pB>v>4OdcL$xJDl!g|5M z)C0>=rQkX6ms)kk0_HjKDuoWrL=P@=fciPP_(}*}*-$&qUHBlA4KuF5{vukxPIJS7 zZO?}C9E7-`ebzi8xHhD5TD#q9Fi0zw?OEo_2 z^vf^CibOe9B-Czf>m^uA0tjmxaX1Lo)K6lT8E_LMtSaX@67D92;3UO%1A^lGB93DK zh@T6=jYv%aUT}tJs~vc$)8O7wCU^3pKP)w$RA8v->!R|Sdu2H*Ll`wOaS1-khogrh z7mf9D83OOsL~-oQY}P&5_$}q*m!c$1(f|;@iV+5Y_;rjh0K{)%gaIIa8zT$=@w*sd z0Epkm2m?U;dyFsu#2;dW0U-V(Mi>C%k1@gk5I++_PbvNM|FQNa@NrdT-26HmT5-tt>^Tpp-?^f+7e4Ww|(M5gHPTqU<|@qAVh~;Kr^3f}kRs zSU|-EB8d8;FDmY@yjuR>=Q-!j+;maj-{+rC=AP|2&)J`I&U2pg94wST-Iuslh{z4) zP(svp=;6dhrc*Yd3PXJg?@{&y$d@zU{2TF!~PzxTf#~y0I<9}lhwXk&&xhu)w zKjHwj;PKDcLoIl0jy=?Z#~ZPSTBtwiR4`r*(qe>Q5I1&>E4p7C@m7h4piY&`2FEkv z6WT9m3WpO0xlO3q651&X7C9e;^DcgJV?MuBj)FZ^3R6v?7R-dK74nQAvhix30pI0q##D2!t@OI$#={q6p+nSI!ppBfj6m z3$}8B=5on7SD;02*d{8krP5>6<1~30tpGn{iaxuCO*bLdK7o7KhRWrMq+aml;2=N zs4o+Dp@;O@6gKQ*&oHr`rAXTgeO3x1H~GPDP6l5%M87BJ!NGtskUP z`kRn+N@v2Kv;Bp$Evc0<0R9O4ezoXT<(PL=sx?|br3TSI2|&}4qe`K=hWaw=E~G#R2Sn|pfHDSM`c_1ZLN^{>wzD(* zDwg?uUag1f&=U`H^bk%_c>_gRTF#nFbmV*%*iIzkB%Pk2-MnZP7JZ_r#>qZfwzb#J zvydiO4@?t~EjH9-a@x>9W*sB|g%fggK4h~g%b^OdO!M%bZ0Wbg>H&d(`1=X-j`2YG^1 z%^e?3AFd-!C`~6-cr(_xF?QqKmyFrph4+ib!sN!*iSW8cs{DWL4m3n#+ank8QvuBbQN7I(&W`nQ=(}Mv-_rzxfW@(ESMIw zxSc_#x1L_b;GYX@F1&`gtc^T0gguN^5@cI-HP+4Ct^`u(2{)RYYj1Oqk#JHB)If$) zv+It`6?U(Il^dV?{I=qo;LS;oS*idh{dPRXeAt z^ZOruPw;~ytv}&?iv1q@6PWlH!z_6YPeVe5*0pBBTO=jxlj#gUXPjmP=>SE1CJ4_ZE=dO4K(C{_ z$we0DD1hRm5x~{4KgrX0X@2zCEr`l5>F&uvM@@0d%TN~Sz{_q$NYktBc|6@my>+d- zH&t?=j5%!peVb6Kn!@l#h!NN9wC+k*?IT3)tG%G#!UzWu82 z=PSpxayzWmk3L8(R`b@9uN;I@U%C24&9WF0H4mg%pGhYcUk=GF%9YJa4 zH8EA^D^onxN{Q%@nkpF8u`sWy?B7QEmh!pY6nBazlZ>=C!pctgX-U-0^l^-Nt5^|< z3_ppb&-6igrG!2wl_0-%YGOBQ-i5h@Veb^1(@G9oTDh#+nn56m^m3#Ui29PRgRH~P zns*usz61nHHv7`+uA*u?I1=uqL3)-y!~jT;>sm`XChSW;O;DY-3v`KhDQlmjwzu8J zbm9U_gU(KRwGb|@_L(`PK*0>v&$MQi%~7<441&9N2vok1Tl!Io6+q@{Q`cI8$wg#Z zAwjm&D%EWc>lOj|+P{EooXQF06DMvDCwE@nL>7cnUvkp+fZRgfD`cbsbxPuL-+ngU zdU~#2_NjIumV7a-lIoDVHHAEvYvggye4mAk`CzSuRt;^{bA-M^em(Tct+o{M>%@BNTx({XPLMfrk+CymJwGB}#mMtdw%PaTQ=g(ty1F%kOy;#?VR{@y zpKQ$`xt{G@6*oUZ1dX8vFL3T-#3o0M|{ z^9=rS6Z!^gFPv)grm+%DYWm%lD+XbO%gQ6W6gow+((`(Tz_a>&+riVygOIvFJDkDE z>gNu6&MLcr+$XVs>>k|7xVn=wWo@u#@n&1I2kGL=RGzE|J9Qmc>MJ!ZnM(TxwO{)6 z@o`0Re9R(HiDyeIGpNYot%T$vi$_aE8>F8%aRXFualEHB4Fpnd3egNiI?4$|OM8of zSkf8*(U549_2{_*F{OQqfk5$=E)QR2d06SjSFVFp+CZR|3~7l)xU@?V1ajb;a1-VI zEI({SCNB}gPe*I1td7jYw2rJ-`#@Y1MpI}Z8@37YE@b*kUTtD>py^w-mUmCoa?jvG z0*b46ktw4KvsJds zl$t8FAh|ZJ*nn23xwO!heJv4jX;AwOsoF*Djy57R?V$8Qkkw3U?jW6tzAY zesiW*TeHsA*EU8pZ&jKVVSjUSHYH(6=NbCtDw%)m?9y1!$TB1R3>~SdHNEUy?YgDTqcskgtXo*(&M}EM(AwIlCu>^PYKa? zAuzdUMD~a4_;5*=^Q34RWrI7nB`Id?IW}*YBEmfr&K0zs}Z82Q9o=Rw$*oWIg8ZjLXFmPKY zhJquDes!sDc2&Z8z>_Nn1*f^#g!$(HuVU`1Dxcpqblv9=W^le(8KMBz30u+9kkm{Z> z2%3Gi1nE+c{+U6z7ZpM`PwV{PMJE$8d@C6f1JE!-cbGI+E*Xu-MS7d-5mTB-mpgtsx|=>X z(G5HHym~yHR01=7H|8UB&>!h^%Q%X4dW)Q_kUIZ~`%jmM!4Q_r$K8};NZ%s5AoANjNWaL+_P>>eC4uE{H7XKWkz8p~oo z9#(&+Dx?3U7jhTx|0SKp|CeXt`%V zzSD+gu(W_@nlJfL7rE!M?0?IYi%Kxm2&@2Px&qFq19oi-aJtKS-!O2r^tR-}TIvWU z=67WM+S*1l%pxHRaSg;U-U(2VTJ~I$<=N~fI6ArNw49lEJKP-5Qi+DI*^#UCNPO{W z)S%&UcI3EYgvuP)9Qla@I`VD?X2}(*>3;2u zabfrOlIe?<(+XjO@x*GIVXe%k4KSZ@wn}d>IsOV+(Y|pP7Ng&nownorz&UkAYQE4( zvH#;~nA6y$&&{LHt)|bJg|RLs^KoB81C+ss?5$YRx}?+|#3Q)%?t)GNbDL}A4CX4? zp?T2;Y`h16UI^1exeLzyB|L-W9pu6FGucFqS5LN`2|m%Zfny8J<<_BTL^zWO^D)N+ zZ#qtG2Pw=kvLIxxGk z*T_GCXS{J`+?0g(cAK=O3r+Nz-4hiiHCBp`jb2ZYuB%*IOqMdl z?tsv&huP2PoG|W_*V8g^rETK2%HDOtER(i-=9Pm8`Mv_M1%Tm zMe{^jqZbYblubI2#7h!|>fyFwP=+;a;E+O&E}E9Xy5E)rBGDNGLm!ScslgY7JH*w+tm%(gNJe{hJN*%cgVd+=M?*YN7NOm7u;6#(Z8R7(dD9=8=#TlW z`eVlSN8iHN`{M-UVCmnI#3k7oGTIr0xR|y(-5LFpbFQ>qd?bjn-+WP2{^mRTcH$wC zaeAX_Wg(8pf{4sBm(p0D9ZV_Q(Q(9#MRMURffFxtWk%1hPW2t<2w)jRf0G_5r^0^p z7J!idORU=La*VCb3iEW!IJ)+Hy(IiifJZihd!u-%|2TT=OyIX9@N5YbFZBcXXM+Gkq<~l z#7q6hQJrUU`G^F5Py)qE{loW?%MO3!9DKQ;8+}O3o+X>8+s=;c$S^Y7qPVTl6MdMF zF{$H%Ki(8${ElEeS1^i~`WJHA5*^dpr3(nLT+=gS|rIY!b7;c(%&kgrwMg$ydrK9&TOBl z2&-O~T+Y2jV)v*7)Uvsv->$jPgSOBfBeLI0nW9Sp3EA9NlwZ*y(-(xMRn$-E`~??3 zuM-%PoYqo#iBOnAS!+hwn9}n)xWlU{ceJ>L=0c0v3Qy%_b=eW3;G{+O!b^^pxXrrC zU&b!ODYPu*a3tPi$niFzvI#YB9Kj*C$Jy^MwCZ^_&mP4%bKgF&dn;!qLOBrO0pT4 zw*0dK(P|DZI=9Hf)WX!I=Sg^{WzrX>#!ULo!c=9_cN80eEseky6Id#gBBZtR9kVNQ z3bQqzx4c#I(p4z7cZHWx!x)!i2(8WoqEc<&pO{*hZ8ANlFo#Ufv6(KLHh(*0h&C@1 zQZ^yk>WXZ1g*4dQ%G|=-=t{A2YWrqwrS|UdDoLt4{D>qqS3KvMq@D%OT=2{_c;py_ zm5QvNgYX-`$#D-)vMZXtJWC;o_C=>3ZMn9M=?C;p$uy%6)K zTlgPH;O*erjDHf(ROs6x;P=Ih{pB3@Gx*6~%TStXa*y3TX!qFN$u&yt{Fwg0|Jgu> zwFtKCx-|mGu1#n})ArS#m!g!@ST<0<7pg!If1lV)Oc25EBs@Oyh3JEtLc7oMr#y zT%%&lO!LD2!9!RbIb~xY!Xly$h-yGD#T&T{)wyCM9ZKoi-e+4Ho=q^ZbLPpfzx~UE zP_;AzTBNcMorr>vg3tiFDot0qB~9_M84}?LJyT2vIq1?gRML_OQb_C4zJGgp*+!f7 z#NDCCFyJiz?IZP~7zXQ>-NDYCuR*U$Lo?I07wYg#O)gwf6G2b4(Rfsy?xqposAn7A z=0T`+iatulD`8sKUzJ|YE2gJ)^I{r$%gsxspB|ulmp}dUjW>+Ukn4P$a@x z`t$;B;E&!6e=U#9#fl6dGQ3LscH}2Z&R%|y5H)PfG?0kw2_5#x^_PQSs5B``*$(TCZUvffmQBl+($hn2_heiA~z~Fuebf->X`3k%rRUcZlES_SL z#WTQimkME_o?!LlD>IERtiO5!0u?8qe5c+IZZEf@%t4=NVC5$J!Wy-W_$YdS(q{LU z{@07Hw2sR0=6HSaC`p?|mw2iFI7)ZTa^^7!)J2zgslQotP2PE$ts_FgcIiEtYTOW0 zjnjl`tmk7`4d&3&7(2#1g(R0gXQnUIMD3A3RXNnWgMQ{s^HBr@hV z$e20yv?rT@2jN5DhCCJ0k_RvRf+X9V%+SP25pziAlGOp9#qQq_C2TM&dP~j!npcsn zvnrM`jc4u7Ql({dXUQl)dPnD8>1OdJb5G@2II3S=?h5~jA6o|zo>88~f!NDQ|o^M1f%{)BnWWrgZI>aeG=~D2znA|1q>n@SFWi*69tMnQ>a@k@itKr!C!x z6}I}vpm-hWC9?EGcK=#jvUmA7W)tQoFwr8M$(EK2_ba1f*{Vhn3YYJnk&bpFPpT|Y zJ%qgm1B{`@$vP+6Vrj|B@_2>NI}w+G_v0+Nn@_GZ;ODxA*v7B=knNsE+%`dVGIlD= za0ItSKgyW%g1w#rYclki z?Ph3VA@i-5wsOHq4j3CG&>-CIm)I-`Q^jxvsMYJJ#bwva(oc0i`KkIH-8~mm5&Z4U z4{t~Mhpe}xy`;k0_?>{?8T?wY%ipzrb#}U1PP5wUg~B7mVP!ze%>#{HM&GqYn9!Fa zNns~cI46<0O7!gNGBI5mUid2NDU=a2)(Pq2<(1cvU6r#)-o;Y zAQo~e-yr*gwC)VX+693-DtMynDKN@AI>Zaj5a5I#r81M@_i#*vO(GA8xa19F$nO4u zD2D$n)m9gSoNy3{>{QIpbJnQiXkVxGP{Uhsoqe4p<5E?QgKXqf5>wg8c`#PS#AW>Y zYFi7G%7W5LmC7DIaNY@ybx(MFIJCkoG34azGJHj{&)qA}JYawtDY?iRPT=jS zJeHBi$6w<5A$%>)>5vzK-JbN5F)4bvj-f5zL%kvx?M2@cFho+QQ;w32Uea9XTBMidU89n$6dNBG^ykCQy#$gp`>S? z^;S~CgTR1$}@ zY0Wdw`>g|Fo9Bf;BcR&Gy@``0SLVP~HPxH(0>8^SR??_;A~tXftH%p?PKHj~(H6IQ3Y+Yn!=Z8PWL(-A6&39nRpRM{`CsotH z7S;5pM#gnftX=8nb*aM1$ESbS0rr1RW6pWDDUwIN+e_nhO+)r8UtoM4Cv`6cl=8=8 z;tfVWogto^o+pTBsHh6K5tU=jHX##zQaZQ+%eMO*?)((Ees^Ly0wEU)HV@&cEJ)0B zyrUixWR+QMTa~97bU8y}fti)%JkQCLhMS;@!m@~NB9Xz1)6xDomOe+N8>=6McnE8C z>BD%kss0pz9nDK*;Rl=UW^rX)R*AP@)5SqYR-B)%JCTU9!G$cG{@)0`rWmBNkdur* zjc2vXfstE115<3<-W>yurb%5e_Ler5gkg!9GI%{!zr@3Zc9j;Bo_bMGO+WpBZa{aEZv z_rNYpUO#+QoXlF*`CD<$GLQ#h@1NNkpX$rni}DDBA%}a)fIl#^g@%&MHB`z4N$1Qf|o{Gy( zBGRUOS?7I}PtuCztA0y=uv7j2$Sij_n?mMNoiF}%`n#WBpD(sfUnHt0rymO^ZE2Dp zk2?4xru?ywwd*t;t19LyU5B1i57BPJMN{22q$8znCdb=m5yvy!#yH1D0BhURobRRG z@JUjPP&Eq$)tdO%cz^Vt;N2c6pkZX+#A4gw>4Ji<(xh_U>q}?X^InRcNzn6*DY2J{ zJLj*+EiB@%(qRo*Z{blY7?@C|j_i_)sa4MXmxwE!j$DA}_2=fh5bN(^htp9=^G;KJ z+;VP2kW$26vDz>thU^A7-7-=#x+m*{C?nQk#0BD6ps_d0C1!yM#2--e?mtgvlxQ9& zL~|++EU~0A4=iy27E{l!QJ8GiZi%*6cUm!KCQpUZdyaHg-RATeI(not_B~B)xFY!lI=RYO!+P;4#%@c)=2bY|{ zZKz?zBzOIrGOTN}S6#0c`h&qgn073-EV+XinILz4=8_Zq=(9{3n^P+J|6%-LN_-BV z|Nq-_SK1T4y-I&<(VP%2R0|I`TGZYe7SD{VAkI$L4+}oU0 zH#%siH*)iLQHqnOk4Y3(^hRt=Va+B73TvMI$h%!}$CpiZ6GKJR8pCk1o9(SAF#7&! zMYE_i8*sT4V91k^N$BrO&W}cPW?p~O{DwrfnJh(SjGH;^m-Zz8@|V~qm4@sN$@=|? zb}EIsC+gzHG1u*MSuF|-w%i+ej!5F5GD9Sr(8#8@NHP^9CghfhJdMI!pYK1K{k%?w zD|IrIS^HeV^?7;)Sfck-()JcgTDb!`fsm&z6=I7!CV{zH(#CYUoD`^JS1sI%^}?5k zDH5}8&|~Z;rmIuUlGH2@l&3Lp7}Ka#wFC&Lwt_?pu3d90?P zeGsB=;fclR1Wq8pK;lY$15K|_;*7AJ$=G%0AO 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¸L&> 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

    AB%VY|KxiO} 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 X243lbTB2xd&)+-9{{i4@fPw!X`5MsQ literal 0 HcmV?d00001 diff --git a/src/wp8/PushPlugin.cs b/src/wp8/PushPlugin.cs index 005b5f1a..06cd8e6d 100644 --- a/src/wp8/PushPlugin.cs +++ b/src/wp8/PushPlugin.cs @@ -1,11 +1,13 @@ -using Microsoft.Phone.Controls; -using Microsoft.Phone.Notification; using System; +using System.Collections.Generic; using System.Diagnostics; -using System.Text; +using System.IO; using System.Runtime.Serialization; using System.Windows; -using WPCordovaClassLib.Cordova.JSON; +using Microsoft.Phone.Controls; +using Microsoft.Phone.Notification; +using Microsoft.Phone.Shell; +using Newtonsoft.Json; namespace WPCordovaClassLib.Cordova.Commands { @@ -27,7 +29,7 @@ public void register(string options) if (pushChannel == null) { pushChannel = new HttpNotificationChannel(this.pushOptions.ChannelName); - SubscribePushChannelEvents(pushChannel); + try { pushChannel.Open(); @@ -42,6 +44,7 @@ public void register(string options) pushChannel.BindToShellTile(); } + SubscribePushChannelEvents(pushChannel); var result = new RegisterResult { ChannelName = this.pushOptions.ChannelName, @@ -74,6 +77,18 @@ public void unregister(string options) } } + public void showToastNotification(string options) + { + ShellToast toast; + if (!TryDeserializeOptions(options, out toast)) + { + this.DispatchCommandResult(new PluginResult(PluginResult.Status.JSON_EXCEPTION)); + return; + } + + Deployment.Current.Dispatcher.BeginInvoke(toast.Show); + } + void PushChannel_ChannelUriUpdated(object sender, NotificationChannelUriEventArgs e) { // return uri to js @@ -82,7 +97,7 @@ void PushChannel_ChannelUriUpdated(object sender, NotificationChannelUriEventArg ChannelName = this.pushOptions.ChannelName, Uri = e.ChannelUri.ToString() }; - this.ExecuteCallback(this.pushOptions.UriChangedCallback, JsonHelper.Serialize(result)); + this.ExecuteCallback(this.pushOptions.UriChangedCallback, JsonConvert.SerializeObject(result)); } void PushChannel_ErrorOccurred(object sender, NotificationChannelErrorEventArgs e) @@ -93,32 +108,40 @@ void PushChannel_ErrorOccurred(object sender, NotificationChannelErrorEventArgs Code = e.ErrorCode.ToString(), Message = e.Message }; - this.ExecuteCallback(this.pushOptions.ErrorCallback, JsonHelper.Serialize(err)); + this.ExecuteCallback(this.pushOptions.ErrorCallback, JsonConvert.SerializeObject(err)); } void PushChannel_ShellToastNotificationReceived(object sender, NotificationEventArgs e) { - StringBuilder message = new StringBuilder(); - string relativeUri = string.Empty; + var toast = new PushNotification + { + Type = "toast" + }; - Toast toast = new Toast(); - if (e.Collection.ContainsKey("wp:Text1")) + foreach (var item in e.Collection) { - toast.Title = e.Collection["wp:Text1"]; + toast.JsonContent.Add(item.Key, item.Value); } - if (e.Collection.ContainsKey("wp:Text2")) + + this.ExecuteCallback(this.pushOptions.NotificationCallback, JsonConvert.SerializeObject(toast)); + } + + void PushChannel_HttpNotificationReceived(object sender, HttpNotificationEventArgs e) + { + var raw = new PushNotification { - toast.Subtitle = e.Collection["wp:Text2"]; - } - if (e.Collection.ContainsKey("wp:Param")) + Type = "raw" + }; + + using (var reader = new StreamReader(e.Notification.Body)) { - toast.Param = e.Collection["wp:Param"]; + raw.JsonContent.Add("Body", reader.ReadToEnd()); } - this.ExecuteCallback(this.pushOptions.NotificationCallback, JsonHelper.Serialize(toast)); + this.ExecuteCallback(this.pushOptions.NotificationCallback, JsonConvert.SerializeObject(raw)); } - private void ExecuteCallback(string callback, string callbackResult) + void ExecuteCallback(string callback, string callbackResult) { Deployment.Current.Dispatcher.BeginInvoke(() => { @@ -145,13 +168,13 @@ private void ExecuteCallback(string callback, string callbackResult) }); } - private static bool TryDeserializeOptions(string options, out T result) where T : class + static bool TryDeserializeOptions(string options, out T result) where T : class { result = null; try { - var args = JsonHelper.Deserialize(options); - result = JsonHelper.Deserialize(args[0]); + var args = JsonConvert.DeserializeObject(options); + result = JsonConvert.DeserializeObject(args[0]); return true; } catch @@ -160,30 +183,18 @@ private static bool TryDeserializeOptions(string options, out T result) where } } - private static bool TryCast(object obj, out T result) where T : class + static bool TryCast(object obj, out T result) where T : class { result = obj as T; return result != null; } - private void SubscribePushChannelEvents(HttpNotificationChannel channel) + void SubscribePushChannelEvents(HttpNotificationChannel channel) { channel.ChannelUriUpdated += new EventHandler(PushChannel_ChannelUriUpdated); channel.ErrorOccurred += new EventHandler(PushChannel_ErrorOccurred); channel.ShellToastNotificationReceived += new EventHandler(PushChannel_ShellToastNotificationReceived); - } - - [DataContract] - public class Toast - { - [DataMember(Name = "text1", IsRequired = false)] - public string Title { get; set; } - - [DataMember(Name = "text2", IsRequired = false)] - public string Subtitle { get; set; } - - [DataMember(Name = "param", IsRequired = false)] - public string Param { get; set; } + channel.HttpNotificationReceived += new EventHandler(PushChannel_HttpNotificationReceived); } [DataContract] @@ -212,6 +223,21 @@ public class RegisterResult public string ChannelName { get; set; } } + [DataContract] + public class PushNotification + { + public PushNotification() + { + this.JsonContent = new Dictionary(); + } + + [DataMember(Name = "jsonContent", IsRequired = true)] + public IDictionary JsonContent { get; set; } + + [DataMember(Name = "type", IsRequired = true)] + public string Type { get; set; } + } + [DataContract] public class RegisterError { diff --git a/www/PushNotification.js b/www/PushNotification.js index a327b67b..1bb8008e 100644 --- a/www/PushNotification.js +++ b/www/PushNotification.js @@ -16,7 +16,7 @@ PushNotification.prototype.register = function(successCallback, errorCallback, o return } - cordova.exec(successCallback, errorCallback, "PushPlugin", "register", [options]); + cordova.exec(successCallback, errorCallback, "PushPlugin", "register", [options]); }; // Call this to unregister for push notifications @@ -35,6 +35,18 @@ PushNotification.prototype.unregister = function(successCallback, errorCallback, cordova.exec(successCallback, errorCallback, "PushPlugin", "unregister", [options]); }; + + // Call this if you want to show toast notification on WP8 + PushNotification.prototype.showToastNotification = function (successCallback, errorCallback, options) { + if (errorCallback == null) { errorCallback = function () { } } + + if (typeof errorCallback != "function") { + console.log("PushNotification.register failure: failure parameter not a function"); + return + } + + cordova.exec(successCallback, errorCallback, "PushPlugin", "showToastNotification", [options]); + } // Call this to set the application icon badge PushNotification.prototype.setApplicationIconBadgeNumber = function(successCallback, errorCallback, badge) { if (errorCallback == null) { errorCallback = function() {}} From 4aa9dc15fd5196c1ce6a14f706aaa452752d6a26 Mon Sep 17 00:00:00 2001 From: Nadya Atanasova Date: Tue, 8 Apr 2014 18:54:49 +0300 Subject: [PATCH 123/133] Update readme file Align correctly tabs. --- README.md | 123 ++++++++++++++++++++++++++++++++++++++---- src/wp8/PushPlugin.cs | 2 +- 2 files changed, 113 insertions(+), 12 deletions(-) diff --git a/README.md b/README.md index e7188a2a..f11f1512 100644 --- a/README.md +++ b/README.md @@ -5,8 +5,9 @@ ## DESCRIPTION This plugin is for use with [Cordova](http://incubator.apache.org/cordova/), and allows your application to receive push notifications on Amazon Fire OS, Android and iOS devices. The Amazon Fire OS implementation uses [Amazon's ADM(Amazon Device Messaging) service](https://developer.amazon.com/sdk/adm.html), Android implementation uses [Google's GCM (Google Cloud Messaging) service](http://developer.android.com/guide/google/gcm/index.html) and the iOS version is based on [Apple APNS Notifications](http://developer.apple.com/library/mac/#documentation/NetworkingInternet/Conceptual/RemoteNotificationsPG/ApplePushService/ApplePushService.html) +This plugin is for use with [Cordova](http://incubator.apache.org/cordova/), and allows your application to receive push notifications on Android, iOS and WP8 devices. The Android implementation uses [Google's GCM (Google Cloud Messaging) service](http://developer.android.com/guide/google/gcm/index.html), whereas the iOS version is based on [Apple APNS Notifications](http://developer.apple.com/library/mac/#documentation/NetworkingInternet/Conceptual/RemoteNotificationsPG/ApplePushService/ApplePushService.html). The WP8 implementation is based on [MPNS](http://msdn.microsoft.com/en-us/library/windowsphone/develop/ff402558(v=vs.105).aspx). -**Important** - Push notifications are intended for real devices. The registration process will fail on the iOS simulator. Notifications can be made to work on the Android Emulator. However, doing so requires installation of some helper libraries, as outlined [here,](http://www.androidhive.info/2012/10/android-push-notifications-using-google-cloud-messaging-gcm-php-and-mysql/) under the section titled "Installing helper libraries and setting up the Emulator". +**Important** - Push notifications are intended for real devices. They are not tested for WP8 Emulator. The registration process will fail on the iOS simulator. Notifications can be made to work on the Android Emulator. However, doing so requires installation of some helper libraries, as outlined [here,](http://www.androidhive.info/2012/10/android-push-notifications-using-google-cloud-messaging-gcm-php-and-mysql/) under the section titled "Installing helper libraries and setting up the Emulator". ## LICENSE @@ -134,6 +135,7 @@ xmlns:amazon="http://schemas.amazon.com/apk/res/android" ``` + 4) Modify your **res/xml/config.xml** to include the following line in order to tell Cordova to include this plugin and where it can be found: (See the Sample_config.xml file in the Example folder) ```xml @@ -190,10 +192,19 @@ Add a reference to this plugin in **config.xml**: ``` Add the **PushNotification.js** script to your assets/www folder (or javascripts folder, wherever you want really) and reference it in your main index.html file. + ```html ``` +Do not forget to reference the **cordova.js** as well. + + + +In your Visual Studio project add reference to the **Newtonsoft.Json.dll** as well - it is needed for serialization and deserialization of the objects. + +Also you need to enable the **"ID_CAP_PUSH_NOTIFICATION"** capability in **Properties->WMAppManifest.xml** of your project. + ## Automatic Installation This plugin is based on [plugman](https://github.com/apache/cordova-plugman). to install it to your app, simply execute plugman as follows; @@ -202,26 +213,25 @@ simply execute plugman as follows; plugman install --platform [PLATFORM] --project [TARGET-PATH] --plugin [PLUGIN-PATH] where - [PLATFORM] = ios or android + [PLATFORM] = ios, android or wp8 [TARGET-PATH] = path to folder containing your phonegap project [PLUGIN-PATH] = path to folder containing this plugin ``` Alternatively this plugin can be installed using the Phonegap CLI: +1) Navigate to the root folder for your phonegap project. +2) Run the command. ```sh phonegap local plugin add https://github.com/phonegap-build/PushPlugin.git - ``` - or the Cordova CLI: - ```sh cordova plugin add https://github.com/phonegap-build/PushPlugin.git ``` -For additional info, take a look at the [Plugman Documentation](https://github.com/apache/cordova-plugman/blob/master/README.md) +For additional info, take a look at the [Plugman Documentation](https://github.com/apache/cordova-plugman/blob/master/README.md) and [Cordova Plugin Specification](https://github.com/alunny/cordova-plugin-spec) Note: For Amazon Fire OS, you will have to follow 2 steps below after automatic installation: @@ -250,7 +260,7 @@ pushNotification = window.plugins.pushNotification; ``` #### register -This should be called as soon as the device becomes ready. On success, you will get a call to tokenHandler (iOS), or onNotificationGCM (Amazon Fire OS or Android), allowing you to obtain the device token or registration ID, respectively. Those values will typically get posted to your intermediary push server so it knows who it can send notifications to. +This should be called as soon as the device becomes ready. On success, you will get a call to tokenHandler (iOS), or onNotificationGCM (Amazon Fire OS and Android), or onNotificationWP8 (WP8), allowing you to obtain the device token or registration ID, or push channel name and Uri respectively. Those values will typically get posted to your intermediary push server so it knows who it can send notifications to. For Amazon Fire OS, if you have not already registered with Amazon developer portal,you will have to obtain credentials and api_key for your app. This is described more in detail in the **Registering your app for Amazon Device Messaging(ADM)** section below. @@ -367,10 +377,12 @@ function onNotificationGCM(e) { if ( e.coldstart ) { $("#app-status-ul").append('

  • --COLDSTART NOTIFICATION--' + '
    • '); + } else { $("#app-status-ul").append('
  • --BACKGROUND NOTIFICATION--' + '
    • '); + } } @@ -398,12 +410,88 @@ For Amazon Fire OS platform, offline message can also be received when app is la Also make note of the **payload** object. Since the Android notification data model is much more flexible than that of iOS, there may be additional elements beyond **message**, **soundname**, and **msgcnt**. You can access those elements and any additional ones via the **payload** element. This means that if your data model should change in the future, there will be no need to change and recompile the plugin. +**channelHandler (WP8 only)** - Called after a push notification channel is opened and push notification URI is returned. [The application is now set to receive notifications.](http://msdn.microsoft.com/en-us/library/windowsphone/develop/hh202940(v=vs.105).aspx) + + +##### wp8 +Register as + +```js +pushNotification = window.plugins.pushNotification; +pushNotification.register(channelHandler, errorHandler, { "channelName": channelName, "ecb": "onNotificationWP8", "uccb": "channelHandler", "errcb": "jsonErrorHandler" }); + +function successHandler(result) { + console.log('registered###' + result.uri); + // send uri to your notification server +} +``` + +**onNotificationWP8** is fired if the app is running when you receive the toast notification, or raw notification. + +```js +//handle MPNS notifications for WP8 +function onNotificationWP8(e) { + + if (e.type == "toast" && e.jsonContent) { + pushNotification.showToastNotification(successHandler, errorHandler, + { + "Title": e.jsonContent["wp:Text1"], "Subtitle": e.jsonContent["wp:Text2"], "NavigationUri": e.jsonContent["wp:Param"] + }); + } + + if (e.type == "raw" && e.jsonContent) { + alert(e.jsonContent.Body); + } +} + +**uccb** - event callback that gets called when the channel you have opened gets its Uri updated. This function is needed in case the MPNS updates the opened channel Uri. This function will take care of showing updated Uri. + +**errcb** - event callback that gets called when server error occurs when receiving notification from the MPNS server. **jsonErrorHandler** is fired by the plugin if server error occurs while receiving notification (for example invalid format of the notification) + + function jsonErrorHandler(error) { + $("#app-status-ul").append('
  • error:' + error.code + '
    • '); + $("#app-status-ul").append('
  • error:' + error.message + '
    • '); + } + +To control the launch page when the user taps on your toast notification when the app is not running, add the following code to your mainpage.xaml.cs + + protected override void OnNavigatedTo(System.Windows.Navigation.NavigationEventArgs e) + { + base.OnNavigatedTo(e); + try + { + if (this.NavigationContext.QueryString["NavigatedFrom"] == "toast") // this is set on the server + { + this.PGView.StartPageUri = new Uri("//www/index.html#notification-page", UriKind.Relative); + } + } + catch (KeyNotFoundException) + { + } + } +Or you can add another **Page2.xaml** just for testing toast navigate url. Like the [MSDN Toast Sample](http://msdn.microsoft.com/en-us/library/windowsphone/develop/hh202967(v=vs.105).aspx) + +To test the tile notification, you will need to add tile images like the [MSDN Tile Sample](http://msdn.microsoft.com/en-us/library/windowsphone/develop/hh202970(v=vs.105).aspx#BKMK_CreatingaPushClienttoReceiveTileNotifications) + #### unregister +##### android and iOS You will typically call this when your app is exiting, to cleanup any used resources. Its not strictly necessary to call it, and indeed it may be desireable to NOT call it if you are debugging your intermediarry push server. When you call unregister(), the current token for a particular device will get invalidated, and the next call to register() will return a new token. If you do NOT call unregister(), the last token will remain in effect until it is invalidated for some reason at the GCM side. Since such invalidations are beyond your control, its recommended that, in a production environment, that you have a matching unregister() call, for every call to register(), and that your server updates the devices' records each time. ```js -pushNotification.unregister(successHandler, errorHandler); -``` +pushNotification.unregister(successHandler, errorHandler, options); +``` +For Android and iOS you may emit the options as they are not used by the plugin. +##### wp8 +When using the plugin for wp8 you will need to unregister the push channel you have register in case you would want to open another one. You need to know the name of the channel you have opened in order to close it. Please keep in mind that one application can have only one opened channel at time and in order to open another you will have to close any already opened channel. + + function unregister() { + var channelName = $("#channel-btn").val(); + pushNotification.unregister( + successHandler, errorHandler, + { + "channelName": channelName + }); + } You'll probably want to trap on the **backbutton** event and only call this when the home page is showing. Remember, the back button on android is not the same as the Home button. When you hit the back button from the home page, your activity gets dismissed. Here is an example of how to trap the backbutton event; @@ -427,7 +515,7 @@ function onDeviceReady() { } }, false); - // aditional onDeviceReady work… + // aditional onDeviceReady work... } ``` @@ -452,6 +540,10 @@ pushNotification.setApplicationIconBadgeNumber(successCallback, errorCallback, b **badgeCount** - an integer indicating what number should show up in the badge. Passing 0 will clear the badge. +#### showToastNotification (WP8 only) +Show toast notification if app is deactivated. The toast notification's properties are set explicitly using json. They can be get in onNotificationWP8 and used for whatever purposes needed. + + pushNotification.showToastNotification(successCallback, errorCallback, options); ## Test Environment The notification system consists of several interdependent components. @@ -468,7 +560,6 @@ This plugin and its target Cordova application comprise the client application.T - You have successfully built a client with this plugin, on both iOS and Android and have installed them on a device. - #### 1) [Get the gem](https://github.com/NicosKaralis/pushmeup) $ sudo gem install pushmeup @@ -525,6 +616,16 @@ If you're not up to building and maintaining your own intermediary push server, [kony](http://www.kony.com/push-notification-services) and many others. [Amazon Simple Notification Service](https://aws.amazon.com/sns/) +#### 4) Send MPNS Notification for WP8 +The simplest way to test the plugin is to create create an ASP.NET webpage that sends different notifications by using the URI that is returned when the push channel is created on the device. + +You can see how to create one from MSDN Samples: + +[Send Toast Notifications (MSDN Sample)](http://msdn.microsoft.com/en-us/library/windowsphone/develop/hh202967(v=vs.105).aspx#BKMK_SendingaToastNotification) + +[Send Tile Notification (MSDN Sample)](http://msdn.microsoft.com/en-us/library/windowsphone/develop/hh202970(v=vs.105).aspx#BKMK_SendingaTileNotification) + +[Send Raw Notification (MSDN Sample)](http://msdn.microsoft.com/en-us/library/windowsphone/develop/hh202977(v=vs.105).aspx#BKMK_RunningtheRawNotificationSample) ## Notes diff --git a/src/wp8/PushPlugin.cs b/src/wp8/PushPlugin.cs index 06cd8e6d..53d318f9 100644 --- a/src/wp8/PushPlugin.cs +++ b/src/wp8/PushPlugin.cs @@ -108,7 +108,7 @@ void PushChannel_ErrorOccurred(object sender, NotificationChannelErrorEventArgs Code = e.ErrorCode.ToString(), Message = e.Message }; - this.ExecuteCallback(this.pushOptions.ErrorCallback, JsonConvert.SerializeObject(err)); + this.ExecuteCallback(this.pushOptions.ErrorCallback, JsonConvert.SerializeObject(err)); } void PushChannel_ShellToastNotificationReceived(object sender, NotificationEventArgs e) From 334cc099e617244526ffee83b54c55cbcf02b1c9 Mon Sep 17 00:00:00 2001 From: EddyVerbruggen Date: Thu, 1 May 2014 23:56:26 +0200 Subject: [PATCH 124/133] Update readme file --- README.md | 13 ++++--------- 1 file changed, 4 insertions(+), 9 deletions(-) diff --git a/README.md b/README.md index f11f1512..9f3e76ff 100644 --- a/README.md +++ b/README.md @@ -4,8 +4,7 @@ ## DESCRIPTION -This plugin is for use with [Cordova](http://incubator.apache.org/cordova/), and allows your application to receive push notifications on Amazon Fire OS, Android and iOS devices. The Amazon Fire OS implementation uses [Amazon's ADM(Amazon Device Messaging) service](https://developer.amazon.com/sdk/adm.html), Android implementation uses [Google's GCM (Google Cloud Messaging) service](http://developer.android.com/guide/google/gcm/index.html) and the iOS version is based on [Apple APNS Notifications](http://developer.apple.com/library/mac/#documentation/NetworkingInternet/Conceptual/RemoteNotificationsPG/ApplePushService/ApplePushService.html) -This plugin is for use with [Cordova](http://incubator.apache.org/cordova/), and allows your application to receive push notifications on Android, iOS and WP8 devices. The Android implementation uses [Google's GCM (Google Cloud Messaging) service](http://developer.android.com/guide/google/gcm/index.html), whereas the iOS version is based on [Apple APNS Notifications](http://developer.apple.com/library/mac/#documentation/NetworkingInternet/Conceptual/RemoteNotificationsPG/ApplePushService/ApplePushService.html). The WP8 implementation is based on [MPNS](http://msdn.microsoft.com/en-us/library/windowsphone/develop/ff402558(v=vs.105).aspx). +This plugin is for use with [Cordova](http://incubator.apache.org/cordova/), and allows your application to receive push notifications on Amazon Fire OS, Android, iOS and WP8 devices. The Amazon Fire OS implementation uses [Amazon's ADM(Amazon Device Messaging) service](https://developer.amazon.com/sdk/adm.html), the Android implementation uses [Google's GCM (Google Cloud Messaging) service](http://developer.android.com/guide/google/gcm/index.html), whereas the iOS version is based on [Apple APNS Notifications](http://developer.apple.com/library/mac/#documentation/NetworkingInternet/Conceptual/RemoteNotificationsPG/ApplePushService/ApplePushService.html). The WP8 implementation is based on [MPNS](http://msdn.microsoft.com/en-us/library/windowsphone/develop/ff402558(v=vs.105).aspx). **Important** - Push notifications are intended for real devices. They are not tested for WP8 Emulator. The registration process will fail on the iOS simulator. Notifications can be made to work on the Android Emulator. However, doing so requires installation of some helper libraries, as outlined [here,](http://www.androidhive.info/2012/10/android-push-notifications-using-google-cloud-messaging-gcm-php-and-mysql/) under the section titled "Installing helper libraries and setting up the Emulator". @@ -135,7 +134,6 @@ xmlns:amazon="http://schemas.amazon.com/apk/res/android" ``` - 4) Modify your **res/xml/config.xml** to include the following line in order to tell Cordova to include this plugin and where it can be found: (See the Sample_config.xml file in the Example folder) ```xml @@ -192,7 +190,6 @@ Add a reference to this plugin in **config.xml**: ``` Add the **PushNotification.js** script to your assets/www folder (or javascripts folder, wherever you want really) and reference it in your main index.html file. - ```html ``` @@ -377,12 +374,10 @@ function onNotificationGCM(e) { if ( e.coldstart ) { $("#app-status-ul").append('
  • --COLDSTART NOTIFICATION--' + '
    • '); - } else { $("#app-status-ul").append('
  • --BACKGROUND NOTIFICATION--' + '
    • '); - } } @@ -412,7 +407,6 @@ Also make note of the **payload** object. Since the Android notification data mo **channelHandler (WP8 only)** - Called after a push notification channel is opened and push notification URI is returned. [The application is now set to receive notifications.](http://msdn.microsoft.com/en-us/library/windowsphone/develop/hh202940(v=vs.105).aspx) - ##### wp8 Register as @@ -515,7 +509,7 @@ function onDeviceReady() { } }, false); - // aditional onDeviceReady work... + // additional onDeviceReady work... } ``` @@ -616,8 +610,9 @@ If you're not up to building and maintaining your own intermediary push server, [kony](http://www.kony.com/push-notification-services) and many others. [Amazon Simple Notification Service](https://aws.amazon.com/sns/) + #### 4) Send MPNS Notification for WP8 -The simplest way to test the plugin is to create create an ASP.NET webpage that sends different notifications by using the URI that is returned when the push channel is created on the device. +The simplest way to test the plugin is to create an ASP.NET webpage that sends different notifications by using the URI that is returned when the push channel is created on the device. You can see how to create one from MSDN Samples: From ad3993e3455eb32d7da402394dd7f689717eaacc Mon Sep 17 00:00:00 2001 From: Eddy Verbruggen Date: Fri, 9 May 2014 22:48:11 +0200 Subject: [PATCH 125/133] Formatting fix --- README.md | 1 + 1 file changed, 1 insertion(+) diff --git a/README.md b/README.md index 9f3e76ff..c095ce95 100644 --- a/README.md +++ b/README.md @@ -437,6 +437,7 @@ function onNotificationWP8(e) { alert(e.jsonContent.Body); } } +``` **uccb** - event callback that gets called when the channel you have opened gets its Uri updated. This function is needed in case the MPNS updates the opened channel Uri. This function will take care of showing updated Uri. From ecb94e6d6fbc5018411f8c40328255e5f536b502 Mon Sep 17 00:00:00 2001 From: Archana Naik Date: Tue, 13 May 2014 14:20:07 -0700 Subject: [PATCH 126/133] [PushPlugin] Coldstart property missing from notification event in JavaScript in Cordova Push Notifications Plugin Added logic for Coldstart support. Client JS can parse this flag. --- src/amazon/ADMHandlerActivity.java | 1 + 1 file changed, 1 insertion(+) diff --git a/src/amazon/ADMHandlerActivity.java b/src/amazon/ADMHandlerActivity.java index 14ceece2..6d7e3dd3 100644 --- a/src/amazon/ADMHandlerActivity.java +++ b/src/amazon/ADMHandlerActivity.java @@ -48,6 +48,7 @@ private void processPushBundle(boolean isCordovaActive) { if (extras != null) { Bundle originalExtras = extras .getBundle(ADMMessageHandler.PUSH_BUNDLE); + originalExtras.putBoolean(PushPlugin.COLDSTART, !isCordovaActive); ADMMessageHandler.cancelNotification(this); PushPlugin.sendExtras(originalExtras); // clean up the noticiationIntent extra From 7814be0f3e8f06d8465d55fe8b97a2a4bb0bd91b Mon Sep 17 00:00:00 2001 From: Archana Naik Date: Tue, 13 May 2014 16:03:53 -0700 Subject: [PATCH 127/133] Updated README file. Updated index.html. New nodeJS based server script to test amazon ADM push notification services. --- Example/server/PushADM_README.txt | 40 --- Example/server/pushADM.js | 158 +++++++++ Example/server/pushADM.py | 431 ------------------------ Example/www/index.html | 19 +- README.md | 535 +++++++++++++++++------------- 5 files changed, 473 insertions(+), 710 deletions(-) delete mode 100644 Example/server/PushADM_README.txt create mode 100644 Example/server/pushADM.js delete mode 100644 Example/server/pushADM.py diff --git a/Example/server/PushADM_README.txt b/Example/server/PushADM_README.txt deleted file mode 100644 index d149e02c..00000000 --- a/Example/server/PushADM_README.txt +++ /dev/null @@ -1,40 +0,0 @@ -In this document, "your server" refers to the server-side software -that you must implement to use Amazon Device Messaging(ADM - https://developer.amazon.com/sdk/adm.html) services. - -== Server == - -Server: A self-contained web sample application written as a Python -script. The web application simulates a range of tasks your server -could implement to send messages to client applications. The server -runs on port 80 by default. - -There are two main classes in server.py: -SampleWebApp: handles the logic for interacting with ADM -services, as well as keeping a list of all devices that have been -registered with the server. - -ServerHandler: handles the minimal tasks required to process incoming -and outgoing web requests and responses. It also generates a very -simple html GUI. - -The web application exposes the following routes: -/: displays 'Server running'. -/register: accepts registration IDs from instances of your app and -registers them with your server. -/show-devices: returns html GUI that displayes all the devices registered -with your server and that allows you to send custom messages to them. -/sendmsg: Sends a message to ADM Servers for relaying to an instance of -your app. - -To run the server perform the following actions: -1. Change the value of PORT at the beginning of server.py to the port you - would like the server to listen on. Make sure this port is opened and - accessible before proceeding. -2. Change the values of PROD_CLIENT_ID and PROD_CLIENT_SECRET to the ones - you received from Amazon. These are also located at the beggining of - server.py -3. Run from the command line: - > python server.py -4. See it in browser: http://localhost:port -5. Register a device: http://localhost:4000/register?device=device_id -6. List registered devices: http://localhost:4000/show-devices diff --git a/Example/server/pushADM.js b/Example/server/pushADM.js new file mode 100644 index 00000000..746e4ac8 --- /dev/null +++ b/Example/server/pushADM.js @@ -0,0 +1,158 @@ + + + +// Client ID and Client Secret received from ADM +// For more info, see: https://developer.amazon.com/public/apis/engage/device-messaging/tech-docs/02-obtaining-adm-credentials +var CLIENT_ID = "amzn1.application-oa2-client.8e838f6629554e26ae3f43a6c663cd60"; +var CLIENT_SECRET = "0af96083320f5d70dc4f358cc783ac65a22e78b297ba257df34d5f723f24543f"; + +// Registration ID, received on device after it registers with ADM server +var REGISTRATION_IDS = ["amzn1.adm-registration.v2.Y29tLmFtYXpvbi5EZXZpY2VNZXNzYWdpbmcuUmVnaXN0cmF0aW9uSWRFbmNyeXB0aW9uS2V5ITEhOE9rZ2h5TXlhVEFFczg2ejNWL3JMcmhTa255Uk5BclhBbE1XMFZzcnU1aFF6cTlvdU5FbVEwclZmdk5oTFBVRXVDN1luQlRSNnRVRUViREdQSlBvSzRNaXVRRUlyUy9NYWZCYS9VWTJUaGZwb3ZVTHhlRTM0MGhvampBK01hVktsMEhxakdmQStOSXRjUXBTQUhNU1NlVVVUVkFreVRhRTBCYktaQ2ZkUFdqSmIwcHgzRDhMQnllVXdxQ2EwdHNXRmFVNklYL0U4UXovcHg0K3Jjb25VbVFLRUVVOFVabnh4RDhjYmtIcHd1ZThiekorbGtzR2taMG95cC92Y3NtZytrcTRPNjhXUUpiZEk3QzFvQThBRTFWWXM2NHkyMjdYVGV5RlhhMWNHS0k9IW5GNEJMSXNleC9xbWpHSU52NnczY0E9PQ"]; + +// Message payload to be sent to client +var payload = { + data: { + message: "PushPlugin works!!", + sound: "beep.wav", + url: "http://www.amazon.com", + timeStamp: new Date().toISOString(), + foo: "baz" + }, + consolidationKey: "my app", + expiresAfter: 3600 +}; + + +//********************************* + + +var https = require("https"); +var querystring = require("querystring"); + + +if(CLIENT_ID == "" || CLIENT_SECRET == "" || REGISTRATION_IDS.length == 0){ + console.log("******************\nSetup Error: \nYou need to edit the pushADM.js file and enter your ADM credentials and device registration ID(s).\n******************"); + process.exit(1); +} + + +// Get access token from server, and use it to post message to device +getAccessToken(function(accessToken){ + + for(var i = 0; i < REGISTRATION_IDS.length; i++){ + + var registrationID = REGISTRATION_IDS[i]; + + postMessage(accessToken, registrationID, payload); + } + +}); + + + + +// Query OAuth server for access token +// For more info, see: https://developer.amazon.com/public/apis/engage/device-messaging/tech-docs/05-requesting-an-access-token + +function getAccessToken(callback){ + + console.log("Requesting access token from server..."); + + var credentials = { + scope: "messaging:push", + grant_type: "client_credentials", + client_id: CLIENT_ID, + client_secret: CLIENT_SECRET + } + + var post_data = querystring.stringify(credentials); + + var post_options = { + host: "api.amazon.com", + port: "443", + path: "/auth/O2/token", + method: "POST", + headers: { + "Content-Type": "application/x-www-form-urlencoded;charset=UTF-8" + } + }; + + var req = https.request(post_options, function(res) { + + var data = ""; + + res.on("data", function (chunk) { + data += chunk; + }); + + res.on("end", function() { + console.log("\nAccess token response:", data); + var accessToken = JSON.parse(data).access_token; + callback(accessToken); + }); + + }); + + req.on("error", function(e) { + console.log("\nProblem with access token request: ", e.message); + }); + + req.write(post_data); + req.end(); + +} + + +// Post message payload to ADM server +// For more info, see: https://developer.amazon.com/public/apis/engage/device-messaging/tech-docs/06-sending-a-message + +function postMessage(accessToken, registrationID, payload){ + + if(accessToken == undefined || registrationID == undefined || payload == undefined){ + return; + } + + console.log("\nSending message..."); + + var post_data = JSON.stringify(payload); + + var api_path = "/messaging/registrations/" + registrationID + "/messages"; + + var post_options = { + host: "api.amazon.com", + port: "443", + path: api_path, + method: "POST", + headers: { + "Authorization": "Bearer " + accessToken, + "X-Amzn-Type-Version": "com.amazon.device.messaging.ADMMessage@1.0", + "X-Amzn-Accept-Type" : "com.amazon.device.messaging.ADMSendResult@1.0", + "Content-Type": "application/json", + "Accept": "application/json", + } + }; + + var req = https.request(post_options, function(res) { + + var data = ""; + + res.on("data", function (chunk) { + data += chunk; + }); + + res.on("end", function() { + console.log("\nSend message response: ", data); + }); + + }); + + req.on("error", function(e) { + console.log("\nProblem with send message request: ", e.message); + }); + + req.write(post_data); + req.end(); + +} + + diff --git a/Example/server/pushADM.py b/Example/server/pushADM.py deleted file mode 100644 index f5480388..00000000 --- a/Example/server/pushADM.py +++ /dev/null @@ -1,431 +0,0 @@ -# -# Copyright 2014 Amazon.com, Inc. or its affiliates. All Rights Reserved. -# -# Licensed under the Apache License, Version 2.0 (the "License"); -# you may not use this file except in compliance with the License. -# You may obtain a copy of the License at -# -# http://www.apache.org/licenses/LICENSE-2.0 -# -# Unless required by applicable law or agreed to in writing, software -# distributed under the License is distributed on an "AS IS" BASIS, -# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. -# See the License for the specific language governing permissions and -# limitations under the License. -# - -# -# To run the server, perform the following actions: -# 1. Change the value of PORT to the port you would like the server -# to listen on. Make sure this port is opened and accessible before proceeding. -# 2. Change the values of PROD_CLIENT_ID and PROD_CLIENT_SECRET to the ones -# you received from ADM. -# 3. Run -# > python server.py -# - -import SimpleHTTPServer -import SocketServer -import logging -from urlparse import urlparse,parse_qs -import json -import urllib -import urllib2 -import threading -import datetime -import hashlib -import base64 - -# Port on which your server will be listening. -PORT = 4000 - -# Client ID received from ADM. -PROD_CLIENT_ID = "$CLIENT_ID" - -# Client secret received from ADM. -PROD_CLIENT_SECRET = "$CLIENT_SECRET" - -# Oauth2.0 token endpoint. This endpoint is used to request authorization tokens. -AMAZON_TOKEN_URL = "https://api.amazon.com/auth/O2/token" - -# ADM services endpoint. This endpoint is used to perform ADM requests. -AMAZON_ADM_URL = "https://api.amazon.com/messaging/registrations/" - -# Data used to request authorization tokens. -ACCESS_TOKEN_REQUEST_DATA = { - "scope" : "messaging:push", - "grant_type" : "client_credentials", - "client_secret" : PROD_CLIENT_SECRET, - "client_id": PROD_CLIENT_ID - } - -# JSON used to perform EnqueueMessage requests. -JSON_MSG_REQUEST = { - "data" : {}, - "consolidationKey" : "", - "expiresAfter" : "", - "md5" : "" - } - -class SampleADMWebapp: - """ - SampleADMWebapp is a class that handles the logic for sending messages to the ADM server - as well as the tasks involved in calling ADM services. - """ - def __init__(self): - """ - SampleADMWebapp constructor. - self.devices is a dictionary of registration IDs registered with your server. - self.token_lock is a lock which will be used to block execution on self.token_data. - self.token_data contains the data returned with an authorization token request response. - """ - self.devices = dict() - self.token_lock = threading.Lock() - self.request_token() - - def register_device(self, url_device): - """ - Registers an instance of our app with this web application and sends it a confirmation - message. The registration id is required to communicate with our app. - - Args: - url_device: A url path containing an app's instance registration ID. - - Returns: - {'status': 'ok'} - """ - params = parse_qs(url_device) - device = params['device'][0] - self.devices[device] = device - print 'registering device ' + device - self.send_message_to_device("You are registered", device, "Registration Confirmation", 3600) - return {'status': 'ok'} - - def unregister_device(self, url_device): - """ - Unregisters an instance of our app from this web application. - The registration ID associated with this app instance should no longer be used. - - Args: - url_device: A url path containing an app's instance registration ID. - - Returns: - {'status': 'ok'} - """ - params = parse_qs(url_device) - device = params['device'][0] - print 'unregistering device ' + device - if self.devices.has_key(device): - self.devices.pop(device) - return {'status': 'ok'} - - def query_devices(self): - """ - Returns: - The registration IDs registered with your server. - """ - return self.devices - - def send_message_to_device(self, message, device, consolidationKey, expiresAfter): - """ - Constructs and sends a request to ADM Servers to enqueue a message for delivery to a specific app instance. - Updates registration id if a newer one is received with the ADM server response. - - Args: - message: Message to send. - device: The registration ID the instance of the app to which the message is to be sent. - consolidationKey: An arbitrary string used to indicate that multiple messages are logically the same. - expiresAfter: The number of seconds that ADM must retain the message if the device is offline. - - Returns: - A message string representative of the outcome of the call. - """ - url = AMAZON_ADM_URL + device + '/messages' - req = urllib2.Request(url) - req.add_header('Content-Type', 'application/json') - req.add_header('Accept', 'application/json') - req.add_header('x-amzn-type-version', 'com.amazon.device.messaging.ADMMessage@1.0') - req.add_header('x-amzn-accept-type', 'com.amazon.device.messaging.ADMSendResult@1.0') - self.token_lock.acquire() - req.add_header('Authorization', "Bearer " + self.token_data['access_token']) - self.token_lock.release() - - timeStamp = str(datetime.datetime.now().isoformat(' ')) - JSON_MSG_REQUEST['data'] = {"message": message, "timeStamp": timeStamp} - JSON_MSG_REQUEST['consolidationKey'] = consolidationKey - JSON_MSG_REQUEST['expiresAfter'] = int(expiresAfter) - JSON_MSG_REQUEST['md5'] = self.calculate_checksum(JSON_MSG_REQUEST['data']) - print req.headers - print req.get_full_url() - print JSON_MSG_REQUEST - try: - # POST EnqueueMessage request to AMD Servers. - response = urllib2.urlopen(req,json.dumps(JSON_MSG_REQUEST)) - - # Retreiving Amazon ADM request ID. Include this with troubleshooting reports. - X_Amzn_RequestId = response.info().get('x-amzn-RequestId') - - # Retreiving the MD5 value computed by ADM servers. - MD5_from_ADM = response.info().get('x-amzn-data-md5') - print "ADM server md5_checksum " + MD5_from_ADM - - # Checking if the app's registration ID needs to be updated. - response_data = json.load(response) - canonical_reg_id = response_data['registrationID'] - if device != canonical_reg_id: - print "Updating registration Id" - if self.devices.has_key(device): - self.devices.pop(device) - self.devices[canonical_reg_id] = canonical_reg_id - return 'Message sent.' - except urllib2.HTTPError as e: - error_reason = json.load(e)['reason'] - if e.code == 400: - return 'Handle ' + str(e) + '. invalid input. Reason: ' + error_reason - elif e.code == 401: - return self.handle_invalid_token_error(e) - elif e.code == 403: - return 'Handle ' + str(e) + '. max rate exceeded. Reason: ' + error_reason - elif e.code == 413: - return 'Handle ' + str(e) + '. message greater than 6KB. Reason: ' + error_reason - elif e.code == 500: - return 'Handle ' + str(e) + '. internal server error' - elif e.code == 503: - return self.handle_server_temporarily_unavailable_error(e) - else: - return 'Message was not sent', str(e) - except urllib2.URLError as e: - return 'Message was not sent', 'URLError: ' + str(e.reason) - except urllib2.HTTPException as e: - return 'Message was not sent', 'HTTPException: ' + str(e) - except Exception as e: - return 'Message was not sent', 'Exception: ' + str(e) - - def handle_invalid_token_error(self, error): - """ - Handles 401 (invalid token error) raised in send_message_to_device(). - This assumes that the 401 error raised in send_message_to_device() - is due to an expired token. This won't help if the invalid token error - is caused for other reasons. - - Args: - error: HTTPError raised in send_message_to_device(). - - Returns: - 'Token refreshed. Please try again.' - """ - self.request_token() - return 'Token refreshed. Please try again.' - - def handle_server_temporarily_unavailable_error(self, error): - """ - Handles 503 (server temporarily unavailable) raised in send_message_to_device(). - 'Retry-After' header will either contain an integer in which case 'Retry-After' - is a delay of time in seconds or a date in HTTP format in which case - 'Retry-After' is the date and time at which it would be suggested to try again. - - Args: - error: HTTPError raised in send_message_to_device(). - - Returns: - A message detailing when the send_message_to_device request should be attempted again. - """ - retry_after = error.info().get('Retry-After') - if retry_after.isdigit(): - return 'Please retry in ' + retry_after + ' seconds' - else: - return 'Please retry at the following time: ' + retry_after - - def calculate_checksum(self, data): - """ - Computes MD5 checksum of the 'data' parameter as per the algorithm detailed - in the ADM documentation. - - Args: - data: a dictionary. - - Returns: - MD5 checksum of key/value pairs within data. - """ - md5_checksum = "" - utf8_data = dict() - utf8_keys = [] - - # Retreiving the list of keys in message. - message_keys = data.keys() - - # Converting data to UTF-8. - for key in message_keys: - utf8_keys.append(key.encode('utf-8')) - utf8_data[key.encode('utf-8')] = data[key].encode('utf-8') - - # UTF-8 sorting of the keys. - utf8_keys.sort() - utf8_string = "" - - # Concatenating the series of key-value pairs. - for key in utf8_keys: - utf8_string = utf8_string + key - utf8_string = utf8_string + ':' - utf8_string = utf8_string + utf8_data[key] - if key != utf8_keys[-1]: - utf8_string = utf8_string + ',' - - # Computing MD5 as per RFC 1321. - md5 = hashlib.md5(utf8_string).digest() - - # Base 64 encoding. - md5_checksum = base64.standard_b64encode(md5) - - print "App server md5_checksum " + md5_checksum - return md5_checksum - - def request_token(self): - """ - Requests and stores an access token from the OAuth2.0 Servers. - We must obtain an access token prior to sending a request to enqueue a message for delivery. - Also, when an access token expires, a new one is requested. - """ - print 'Requesting token' - req = urllib2.Request(AMAZON_TOKEN_URL) - req_data = urllib.urlencode(ACCESS_TOKEN_REQUEST_DATA) - print req_data, str(len(req_data)) - req.add_header('Content-Type', 'application/x-www-form-urlencoded') - - try: - self.token_lock.acquire() - - # POST access token request to OAuth2.0 Servers. - response = urllib2.urlopen(req, req_data) - - # Retreiving Amazon ADM request ID. Include this with troubleshooting reports. - X_Amzn_RequestId = response.info().get('x-amzn-RequestId') - - self.token_data = json.load(response) - self.token_lock.release() - - print 'Token acquired: ' + self.token_data['access_token'] + ' and valid for ' + \ - str(self.token_data['expires_in']) + ' seconds.' - response.close() - interval = int(self.token_data['expires_in']) - t = threading.Timer(interval, self.request_token) - t.daemon = True - t.start() - except urllib2.HTTPError as e: - self.token_lock.release() - error=json.load(e) - print 'Could not acquire token ', error - exit() - -class ServerHandler(SimpleHTTPServer.SimpleHTTPRequestHandler): - """ - Class ServerHandler performs the minimal tasks required to process - web requests coming from our clients, as well as outgoing responses. - """ - - def send_server_response(self, content_type, content): - """ - Sends your server's response. - - Args: - content_type: Content type of response to send (text/html or application/json). - content: Content to send back with the response. - """ - self.send_response(200) - self.send_header('Content-type', content_type) - self.send_header('Content-length', len(content)) - self.end_headers() - self.wfile.write(content) - self.wfile.close() - - def send_html_response(self, html): - """ - Sends an HTML response. - - Args: - html: HTML response to send. - """ - self.send_server_response('text/html', ""+html+"") - - def send_json_response(self, json): - """ - Sends a JSON response. - - Args: - json: JSON response to send. - """ - self.send_server_response('application/json', json) - - def do_GET(self): - """ - SimpleHTTPServer do_GET() implementation. - This method gets called when your server receives GET requests. - """ - self.route_request() - - def route_request(self): - """ - All the routes handled by our web application are handled here. - GUI HTML is generated here. - """ - query = urlparse(self.path).query - if self.path == "/": - server_running = 'Server running' - self.send_html_response(server_running) - elif self.path.startswith("/register"): - ret = theWebApp.register_device(query) - self.send_json_response(json.dumps(ret)) - elif self.path.startswith("/unregister"): - ret = theWebApp.unregister_device(query) - self.send_json_response(json.dumps(ret)) - elif self.path.startswith("/show-devices"): - devices = theWebApp.query_devices() - html = '' - html = html + '

    Select A Device And Send A Message

    ' - if len(devices) == 0: - html = html + '

    No devices registered with server

    ' - html = html + 'Please register a device by restarting the Amazon ADM Sample App or registering from within the app
    ' - else: - html = html + '
    ' - html = html + '' - for device in devices: - html = html + '' - html = html + '' - html = html + '' - html = html + '' - html = html + '' - html = html + '' - html = html + '' - html = html + '' - html = html + '' - html = html + '' - html = html + '' - html = html + '' - html = html + '' - html = html + '' - html = html + '' - html = html + '' - html = html + '
    '+device+'
    Message:
    Consolidation key:
    Expires after:
    ' - html = html + '
    ' - html = html + '' - self.send_html_response(html) - elif self.path.startswith("/sendmsg"): - device=parse_qs(query)['device'][0] - msg = parse_qs(query)['msg'][0] - consolidationKey = parse_qs(query)['consolidationKey'][0] - expiresAfter = parse_qs(query)['expiresAfter'][0] - response = theWebApp.send_message_to_device(msg, device, consolidationKey, expiresAfter) - print response - self.send_json_response(response) - else: - self.send_html_response("not found") - -# Instantiate a new global SampleADMWebapp. -theWebApp = SampleADMWebapp() - -# Instantiate a new ServerHandler and listen on port PORT. -httpd = SocketServer.TCPServer(("",PORT), ServerHandler) - -# Listen forever. -print "starting server in port ", PORT -httpd.serve_forever() diff --git a/Example/www/index.html b/Example/www/index.html index 9ec8dc38..7d28938f 100755 --- a/Example/www/index.html +++ b/Example/www/index.html @@ -4,7 +4,17 @@ com.PhoneGap.c2dm - + +/* +NOTE: + This demo uses these plugins: + Cordova Device Plugin: http://plugins.cordova.io/#/package/org.apache.cordova.device + Cordova Media Plugin: http://plugins.cordova.io/#/package/org.apache.cordova.media + + To add them via the CLI: + $ cordova plugin add org.apache.cordova.device + $ cordova plugin add org.apache.cordova.media +*/ @@ -36,12 +46,11 @@ try { pushNotification = window.plugins.pushNotification; + $("#app-status-ul").append('
  • registering ' + device.platform + '
    • '); if (device.platform == 'android' || device.platform == 'Android' || device.platform == 'amazon-fireos' ) { - $("#app-status-ul").append('
  • registering ' + device.platform + '
    • '); - pushNotification.register(successHandler, errorHandler, {"senderID":"661780372179","ecb":"onNotificationGCM"}); // required! + pushNotification.register(successHandler, errorHandler, {"senderID":"661780372179","ecb":"onNotification"}); // required! } else { - $("#app-status-ul").append('
  • registering iOS
    • '); pushNotification.register(tokenHandler, errorHandler, {"badge":"true","sound":"true","alert":"true","ecb":"onNotificationAPN"}); // required! } } @@ -71,7 +80,7 @@ } // handle GCM notifications for Android - function onNotificationGCM(e) { + function onNotification(e) { $("#app-status-ul").append('
  • EVENT -> RECEIVED:' + e.event + '
    • '); switch( e.event ) diff --git a/README.md b/README.md index c56e3f24..8a0d02af 100644 --- a/README.md +++ b/README.md @@ -4,11 +4,23 @@ ## DESCRIPTION -This plugin is for use with [Cordova](http://incubator.apache.org/cordova/), and allows your application to receive push notifications on Amazon Fire OS, Android, iOS and WP8 devices. The Amazon Fire OS implementation uses [Amazon's ADM(Amazon Device Messaging) service](https://developer.amazon.com/sdk/adm.html), the Android implementation uses [Google's GCM (Google Cloud Messaging) service](http://developer.android.com/guide/google/gcm/index.html), whereas the iOS version is based on [Apple APNS Notifications](http://developer.apple.com/library/mac/#documentation/NetworkingInternet/Conceptual/RemoteNotificationsPG/ApplePushService/ApplePushService.html). The WP8 implementation is based on [MPNS](http://msdn.microsoft.com/en-us/library/windowsphone/develop/ff402558(v=vs.105).aspx). +This plugin is for use with [Cordova](http://incubator.apache.org/cordova/), and allows your application to receive push notifications on Amazon Fire OS, Android, iOS and WP8 devices. The Amazon Fire OS implementation uses [Amazon's ADM (Amazon Device Messaging) service](https://developer.amazon.com/sdk/adm.html), the Android implementation uses [Google's GCM (Google Cloud Messaging) service](http://developer.android.com/guide/google/gcm/index.html), whereas the iOS version is based on [Apple APNS Notifications](http://developer.apple.com/library/mac/#documentation/NetworkingInternet/Conceptual/RemoteNotificationsPG/ApplePushService/ApplePushService.html). The WP8 implementation is based on [MPNS](http://msdn.microsoft.com/en-us/library/windowsphone/develop/ff402558(v=vs.105).aspx). -**Important** - Push notifications are intended for real devices. They are not tested for WP8 Emulator. The registration process will fail on the iOS simulator. Notifications can be made to work on the Android Emulator. However, doing so requires installation of some helper libraries, as outlined [here,](http://www.androidhive.info/2012/10/android-push-notifications-using-google-cloud-messaging-gcm-php-and-mysql/) under the section titled "Installing helper libraries and setting up the Emulator". +**Important** - Push notifications are intended for real devices. They are not tested for WP8 Emulator. The registration process will fail on the iOS simulator. Notifications can be made to work on the Android Emulator, however doing so requires installation of some helper libraries, as outlined [here,](http://www.androidhive.info/2012/10/android-push-notifications-using-google-cloud-messaging-gcm-php-and-mysql/) under the section titled "Installing helper libraries and setting up the Emulator". -## LICENSE +### Contents + +- [LICENSE](#license) +- [Manual Installation](#manual_installation) +- [Automatic Installation](#automatic_installation) +- [Plugin API](#plugin_api) +- [Testing](#testing) +- [Additional Resources](#additional_resources) +- [Acknowledgments](#acknowledgments) + + + +##     LICENSE The MIT License @@ -33,11 +45,24 @@ This plugin is for use with [Cordova](http://incubator.apache.org/cordova/), and OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. -## Manual Installation for Amazon Fire OS -1) Copy the contents of **src/amazon/com/** to your project's **src/com/** folder. -2) Modify your **AndroidManifest.xml** and add the following lines to your manifest tag: + +##Manual Installation + +### Manual Installation for Amazon Fire OS + +1) Install the ADM library + +- Download the [Amazon Mobile App SDK](https://developer.amazon.com/public/resources/development-tools/sdk) and unzip. +- Create a folder called `ext_libs` in your project's `platforms/amazon-fireos` folder. +- Copy `amazon-device-messaging-x.x.x.jar` into the `ext_libs` folder above. +- Create a new text file called `ant.properties` in the `platforms/amazon-fireos` folder, and add a java.compiler.classpath entry pointing at the library. For example: `java.compiler.classpath=./ext_libs/amazon-device-messaging-1.0.1.jar` + + +2) Copy the contents of the Push Notification Plugin's `src/amazon/com` folder to your project's `platforms/amazon-fireos/src/com` folder. + +3) Modify your `AndroidManifest.xml` and add the following lines to your manifest tag: ```xml @@ -46,7 +71,7 @@ This plugin is for use with [Cordova](http://incubator.apache.org/cordova/), and ``` -3) Modify your **AndroidManifest.xml** and add the following **activity**, **receiver** and **service** tags to your **application** section. +4) Modify your `AndroidManifest.xml` and add the following **activity**, **receiver** and **service** tags to your **application** section. ```xml @@ -58,16 +83,16 @@ This plugin is for use with [Cordova](http://incubator.apache.org/cordova/), and - + ``` -4) Modify your **AndroidManifest.xml** and add "amazon" XML namespace to tag: +5) If you are using Cordova 3.4.0 or earlier, modify your `AndroidManifest.xml` and add "amazon" XML namespace to tag: ```xml xmlns:amazon="http://schemas.amazon.com/apk/res/android" ``` -5) Modify your res/xml/config.xml to add a reference to PushPlugin: +6) Modify `res/xml/config.xml` to add a reference to PushPlugin: ```xml @@ -75,22 +100,26 @@ xmlns:amazon="http://schemas.amazon.com/apk/res/android" ``` -6) Modify your res/xml/config.xml to set some config options to let Cordova know whether to display ADM message in the notification center or not. If not, provide the default message. By default, message will be visible in the notification. These config options are used if message arrives and app is not in the foreground(either Killed or running in the background). +7) Modify `res/xml/config.xml` to set config options to let Cordova know whether to display ADM message in the notification center or not. If not, provide the default message. By default, message will be visible in the notification. These config options are used if message arrives and app is not in the foreground (either killed or running in the background). ```xml ``` -7) Finally, put api_key.txt (given to you when you register your app on [Amazon Developer Portal](https://developer.amazon.com/sdk/adm.html). For detailed steps on how to register for ADM please refer to section "Registering your app for Amazon Device Messaging(ADM)" +8) Create an file called `api_key.txt` in the platforms/amazon-fireos/assets folder containing the API Key from the "Security Profile Android/Kindle Settings" tab on the [Amazon Developer Portal](https://developer.amazon.com/sdk/adm.html). For detailed steps on how to register for ADM please refer to section below: [Registering your app for Amazon Device Messaging (ADM)](#registering_for_adm) + + -## Manual Installation for Android +### Manual Installation for Android +1) Install GCM support files -1) copy the contents of **src/android/com/** to your project's **src/com/** folder. - copy the contents of **libs/** to your **libs/** folder. - copy **{android_sdk_path}/extras/android/support/v13/android-support-v13.jar** to your **libs/** folder. - The final hierarchy will likely look something like this: +- copy the contents of `src/android/com/` to your project's `src/com/` folder. +- copy the contents of `libs/` to your `libs/` folder. +- copy `{android_sdk_path}/extras/android/support/v13/android-support-v13.jar` to your `libs/` folder. + +The final hierarchy will likely look something like this: {project_folder} libs @@ -109,7 +138,7 @@ xmlns:amazon="http://schemas.amazon.com/apk/res/android" {intent_name} {intent_name}.java -2) Modify your **AndroidManifest.xml** and add the following lines to your manifest tag: +2) Modify your `AndroidManifest.xml` and add the following lines to your manifest tag: ```xml @@ -120,7 +149,7 @@ xmlns:amazon="http://schemas.amazon.com/apk/res/android" ``` -3) Modify your **AndroidManifest.xml** and add the following **activity**, **receiver** and **service** tags to your **application** section. (See the Sample_AndroidManifest.xml file in the Example folder.) +3) Modify your `AndroidManifest.xml` and add the following **activity**, **receiver** and **service** tags to your **application** section. (See the Sample_AndroidManifest.xml file in the Example folder.) ```xml @@ -134,7 +163,7 @@ xmlns:amazon="http://schemas.amazon.com/apk/res/android" ``` -4) Modify your **res/xml/config.xml** to include the following line in order to tell Cordova to include this plugin and where it can be found: (See the Sample_config.xml file in the Example folder) +4) Modify your `res/xml/config.xml` to include the following line in order to tell Cordova to include this plugin and where it can be found: (See the Sample_config.xml file in the Example folder) ```xml @@ -142,13 +171,13 @@ xmlns:amazon="http://schemas.amazon.com/apk/res/android" ``` -5) Add the **PushNotification.js** script to your assets/www folder (or javascripts folder, wherever you want really) and reference it in your main index.html file. This file's usage is described in the **Plugin API** section below. +5) Add the `PushNotification.js` script to your assets/www folder (or javascripts folder, wherever you want really) and reference it in your main index.html file. This file's usage is described in the **Plugin API** section below. ```html ``` -## Manual Installation for iOS +### Manual Installation for iOS Copy the following files to your project's Plugins folder: @@ -159,7 +188,7 @@ PushPlugin.h PushPlugin.m ``` -Add a reference for this plugin to the plugins section in **config.xml**: +Add a reference for this plugin to the plugins section in `config.xml`: ```xml @@ -167,13 +196,13 @@ Add a reference for this plugin to the plugins section in **config.xml**: ``` -Add the **PushNotification.js** script to your assets/www folder (or javascripts folder, wherever you want really) and reference it in your main index.html file. +Add the `PushNotification.js` script to your assets/www folder (or javascripts folder, wherever you want really) and reference it in your main index.html file. ```html ``` -## Manual Installation for WP8 +### Manual Installation for WP8 Copy the following files to your project's Commands folder and add it to the VS project: @@ -181,7 +210,7 @@ Copy the following files to your project's Commands folder and add it to the VS PushPlugin.cs ``` -Add a reference to this plugin in **config.xml**: +Add a reference to this plugin in `config.xml`: ```xml @@ -189,118 +218,120 @@ Add a reference to this plugin in **config.xml**: ``` -Add the **PushNotification.js** script to your assets/www folder (or javascripts folder, wherever you want really) and reference it in your main index.html file. +Add the `PushNotification.js` script to your assets/www folder (or javascripts folder, wherever you want really) and reference it in your main index.html file. ```html ``` -Do not forget to reference the **cordova.js** as well. +Do not forget to reference the `cordova.js` as well. -In your Visual Studio project add reference to the **Newtonsoft.Json.dll** as well - it is needed for serialization and deserialization of the objects. +In your Visual Studio project add reference to the `Newtonsoft.Json.dll` as well - it is needed for serialization and deserialization of the objects. Also you need to enable the **"ID_CAP_PUSH_NOTIFICATION"** capability in **Properties->WMAppManifest.xml** of your project. -## Automatic Installation -This plugin is based on [plugman](https://github.com/apache/cordova-plugman). to install it to your app, -simply execute plugman as follows; -```sh -plugman install --platform [PLATFORM] --project [TARGET-PATH] --plugin [PLUGIN-PATH] -where - [PLATFORM] = ios, android or wp8 - [TARGET-PATH] = path to folder containing your phonegap project - [PLUGIN-PATH] = path to folder containing this plugin -``` -Alternatively this plugin can be installed using the Phonegap CLI: +##Automatic Installation + +Below are the methods for installing this plugin automatically using command line tools. For additional info, take a look at the [Plugman Documentation](https://github.com/apache/cordova-plugman/blob/master/README.md) and [Cordova Plugin Specification](https://github.com/alunny/cordova-plugin-spec). + +**Note:** For each service supported - ADM, APNS, GCM or MPNS - you may need to download the SDK and other support files. See the [Manual Installation](#manual_installation) instructions below for more details about each platform. + +### Cordova + +The plugin can be installed via the Cordova command line interface: + +1) Navigate to the root folder for your phonegap project. 2) Run the command. -1) Navigate to the root folder for your phonegap project. -2) Run the command. -```sh -phonegap local plugin add https://github.com/phonegap-build/PushPlugin.git -``` -or the Cordova CLI: ```sh cordova plugin add https://github.com/phonegap-build/PushPlugin.git - ``` -For additional info, take a look at the [Plugman Documentation](https://github.com/apache/cordova-plugman/blob/master/README.md) and [Cordova Plugin Specification](https://github.com/alunny/cordova-plugin-spec) +### Phonegap -Note: For Amazon Fire OS, you will have to follow 2 steps below after automatic installation: +The plugin can be installed using the Phonegap command line interface: -1) Modify your **AndroidManifest.xml** and add "amazon" XML namespace to tag: +1) Navigate to the root folder for your phonegap project. 2) Run the command. -```xml -xmlns:amazon="http://schemas.amazon.com/apk/res/android" +```sh +phonegap local plugin add https://github.com/phonegap-build/PushPlugin.git ``` -2) Put api_key.txt (given to you when you register your app on [Amazon Developer Portal](https://developer.amazon.com/sdk/adm.html) in your app's assets folder ($path to app/platforms/amazon-fireos/assets/). For detailed steps on how to register for ADM please refer to section "Registering your app for Amazon Device Messaging(ADM)" +### Plugman -Note: For Amazon Fire OS, you will have to follow 2 steps below after automatic installation: +The plugin is based on [plugman](https://github.com/apache/cordova-plugman) and can be installed using the Plugman command line interface: -1) Modify your **AndroidManifest.xml** and add "amazon" XML namespace to tag: +```sh +plugman install --platform [PLATFORM] --project [TARGET-PATH] --plugin [PLUGIN-PATH] -```xml -xmlns:amazon="http://schemas.amazon.com/apk/res/android" +where + [PLATFORM] = ios, amazon-fireos, android or wp8 + [TARGET-PATH] = path to folder containing your phonegap project + [PLUGIN-PATH] = path to folder containing this plugin ``` -2) Put api_key.txt (given to you when you register your app on [Amazon Developer Portal](https://developer.amazon.com/sdk/adm.html) in your app's assets folder ($path to app/platforms/amazon-fireos/assets/). For detailed steps on how to register for ADM please refer to section "Registering your app for Amazon Device Messaging(ADM)" -## Plugin API -In the Examples folder you will find a sample implementation showing how to interact with the PushPlugin. Modify it to suit your needs. -First create the plugin instance variable. + +## Plugin API + +In the plugin `examples` folder you will find a sample implementation showing how to interact with the PushPlugin. Modify it to suit your needs. + +#### pushNotification +The plugin instance variable. ```js var pushNotification; + +document.addEventListener("deviceready", function(){ + pushNotification = window.plugins.pushNotification; + ... +}); ``` -When deviceReady fires, get the plugin reference +#### register +To be called as soon as the device becomes ready. ```js -pushNotification = window.plugins.pushNotification; +$("#app-status-ul").append('
  • registering ' + device.platform + '
    • '); +if ( device.platform == 'android' || device.platform == 'Android' || device.platform == "amazon-fireos" ){ + + pushNotification.register( + successHandler, + errorHandler, + { + "senderID":"replace_with_sender_id", + "ecb":"onNotification" + }); +} else { + pushNotification.register( + tokenHandler, + errorHandler, + { + "badge":"true", + "sound":"true", + "alert":"true", + "ecb":"onNotificationAPN" + }); +} ``` -#### register -This should be called as soon as the device becomes ready. On success, you will get a call to tokenHandler (iOS), or onNotificationGCM (Amazon Fire OS and Android), or onNotificationWP8 (WP8), allowing you to obtain the device token or registration ID, or push channel name and Uri respectively. Those values will typically get posted to your intermediary push server so it knows who it can send notifications to. +On success, you will get a call to tokenHandler (iOS), onNotification (Android and Amazon Fire OS), or onNotificationWP8 (WP8), allowing you to obtain the device token or registration ID, or push channel name and Uri respectively. Those values will typically get posted to your intermediary push server so it knows who it can send notifications to. -For Amazon Fire OS, if you have not already registered with Amazon developer portal,you will have to obtain credentials and api_key for your app. This is described more in detail in the **Registering your app for Amazon Device Messaging(ADM)** section below. +***Note*** -For Android, If you have not already done so, you'll need to set up a Google API project, to generate your senderID. [Follow these steps](http://developer.android.com/guide/google/gcm/gs.html) to do so. This is described more fully in the **Test Environment** section below. +- **Amazon Fire OS**: "ecb" MUST be provided in order to get callback notifications. If you have not already registered with Amazon developer portal,you will have to obtain credentials and api_key for your app. This is described more in detail in the [Registering your app for Amazon Device Messaging (ADM)](#registering_for_adm) section below. -In this example, be sure and substitute your own senderID. Get your senderID by signing into to your [google dashboard](https://code.google.com/apis/console/). The senderID is found at **Overview->Dashboard->Project Number**. +- **Android**: If you have not already done so, you'll need to set up a Google API project, to generate your senderID. [Follow these steps](http://developer.android.com/guide/google/gcm/gs.html) to do so. This is described more fully in the **Testing** section below. In this example, be sure and substitute your own senderID. Get your senderID by signing into to your [google dashboard](https://code.google.com/apis/console/). The senderID is found at *Overview->Dashboard->Project Number*. -Note: For Amazon Fire OS platform, sender_id is not needed. If you provide one, it will be ignored. "ecb" MUST be provided in order to get callback notifications. -```js -if ( device.platform == 'android' || device.platform == 'Android' || device.platform == "Amazon" || device.platform == "amazon") -{ - pushNotification.register( - successHandler, - errorHandler, { - "senderID":"replace_with_sender_id", - "ecb":"onNotificationGCM" - }); -} -else -{ - pushNotification.register( - tokenHandler, - errorHandler, { - "badge":"true", - "sound":"true", - "alert":"true", - "ecb":"onNotificationAPN" - }); -} -``` -**successHandler** - called when a plugin method returns without error +#### successHandler +Called when a plugin method returns without error ```js // result contains any message sent from the plugin call @@ -309,7 +340,8 @@ function successHandler (result) { } ``` -**errorHandler** - called when the plugin returns an error +#### errorHandler +Called when the plugin returns an error ```js // result contains any error description text returned from the plugin call @@ -318,19 +350,8 @@ function errorHandler (error) { } ``` -**tokenHandler (iOS only)** - called when the device has registered with a unique device token. - -```js -function tokenHandler (result) { - // Your iOS push server needs to know the token before it can push to this device - // here is where you might want to send it the token for later use. - alert('device token = ' + result); -} -``` - -**senderID (Android only)** - This is the Google project ID you need to obtain by [registering your application](http://developer.android.com/guide/google/gcm/gs.html) for GCM - -**ecb** - event callback that gets called when your device receives a notification +#### ecb (Amazon Fire OS, Android and iOS) +Event callback that gets called when your device receives a notification ```js // iOS @@ -351,9 +372,11 @@ function onNotificationAPN (event) { pushNotification.setApplicationIconBadgeNumber(successHandler, errorHandler, event.badge); } } +``` -// Android -function onNotificationGCM(e) { +```js +// Android and Amazon Fire OS +function onNotification(e) { $("#app-status-ul").append('
  • EVENT -> RECEIVED:' + e.event + '
    • '); switch( e.event ) @@ -391,11 +414,11 @@ function onNotificationGCM(e) { } } - $("#app-status-ul").append('
  • MESSAGE -> MSG: ' + e.payload.message + '
    • '); - //Only works for GCM - $("#app-status-ul").append('
  • MESSAGE -> MSGCNT: ' + e.payload.msgcnt + '
    • '); - //Only works on Amazon Fire OS - $status.append('
  • MESSAGE -> TIME: ' + e.payload.timeStamp + '
    • '); + $("#app-status-ul").append('
  • MESSAGE -> MSG: ' + e.payload.message + '
    • '); + //Only works for GCM + $("#app-status-ul").append('
  • MESSAGE -> MSGCNT: ' + e.payload.msgcnt + '
    • '); + //Only works on Amazon Fire OS + $status.append('
  • MESSAGE -> TIME: ' + e.payload.timeStamp + '
    • '); break; case 'error': @@ -408,30 +431,72 @@ function onNotificationGCM(e) { } } ``` - Looking at the above message handling code for Android/Amazon Fire OS, a few things bear explanation. Your app may receive a notification while it is active (INLINE). If you background the app by hitting the Home button on your device, you may later receive a status bar notification. Selecting that notification from the status will bring your app to the front and allow you to process the notification (BACKGROUND). Finally, should you completely exit the app by hitting the back button from the home page, you may still receive a notification. Touching that notification in the notification tray will relaunch your app and allow you to process the notification (COLDSTART). In this case the **coldstart** flag will be set on the incoming event. You can look at the **foreground** flag on the event to determine whether you are processing a background or an in-line notification. You may choose, for example to play a sound or show a dialog only for inline or coldstart notifications since the user has already been alerted via the status bar. -For Amazon Fire OS platform, offline message can also be received when app is launched via carousel or by tapping on app icon from apps. In either case once app delivers the offline message to JS, notification will be cleared. +For Amazon Fire OS, offline message can also be received when app is launched via carousel or by tapping on app icon from apps. In either case once app delivers the offline message to JS, notification will be cleared. -Also make note of the **payload** object. Since the Android notification data model is much more flexible than that of iOS, there may be additional elements beyond **message**, **soundname**, and **msgcnt**. You can access those elements and any additional ones via the **payload** element. This means that if your data model should change in the future, there will be no need to change and recompile the plugin. -**payload** for Amazon Fire OS is mostly similar to Android with minor differences. It does NOT have **msgcnt** but instead it has **timestamp**. +Since the Android and Amazon Fire OS notification data models are much more flexible than that of iOS, there may be additional elements beyond **message**. You can access those elements and any additional ones via the **payload** element. This means that if your data model should change in the future, there will be no need to change and recompile the plugin. -**channelHandler (WP8 only)** - Called after a push notification channel is opened and push notification URI is returned. [The application is now set to receive notifications.](http://msdn.microsoft.com/en-us/library/windowsphone/develop/hh202940(v=vs.105).aspx) -##### wp8 -Register as + +#### senderID (Android only) +This is the Google project ID you need to obtain by [registering your application](http://developer.android.com/guide/google/gcm/gs.html) for GCM + + +#### tokenHandler (iOS only) +Called when the device has registered with a unique device token. ```js -pushNotification = window.plugins.pushNotification; -pushNotification.register(channelHandler, errorHandler, { "channelName": channelName, "ecb": "onNotificationWP8", "uccb": "channelHandler", "errcb": "jsonErrorHandler" }); +function tokenHandler (result) { + // Your iOS push server needs to know the token before it can push to this device + // here is where you might want to send it the token for later use. + alert('device token = ' + result); +} +``` + +#### setApplicationIconBadgeNumber (iOS only) +Set the badge count visible when the app is not running + +```js +pushNotification.setApplicationIconBadgeNumber(successCallback, errorCallback, badgeCount); +``` + +The `badgeCount` is an integer indicating what number should show up in the badge. Passing 0 will clear the badge. -function successHandler(result) { - console.log('registered###' + result.uri); - // send uri to your notification server +#### unregister (Amazon Fire OS, Android and iOS) +You will typically call this when your app is exiting, to cleanup any used resources. Its not strictly necessary to call it, and indeed it may be desireable to NOT call it if you are debugging your intermediarry push server. When you call unregister(), the current token for a particular device will get invalidated, and the next call to register() will return a new token. If you do NOT call unregister(), the last token will remain in effect until it is invalidated for some reason at the GCM/ADM side. Since such invalidations are beyond your control, its recommended that, in a production environment, that you have a matching unregister() call, for every call to register(), and that your server updates the devices' records each time. + +```js +pushNotification.unregister(successHandler, errorHandler, options); +``` + + +### WP8 + +#### register (WP8 Only) + +```js + +if(device.platform == "Win32NT"){ + pushNotification.register( + channelHandler, + errorHandler, + { + "channelName": channelName, + "ecb": "onNotificationWP8", + "uccb": "channelHandler", + "errcb": "jsonErrorHandler" + }); } + ``` -**onNotificationWP8** is fired if the app is running when you receive the toast notification, or raw notification. +#### channelHandler (WP8 only) +Called after a push notification channel is opened and push notification URI is returned. [The application is now set to receive notifications.](http://msdn.microsoft.com/en-us/library/windowsphone/develop/hh202940(v=vs.105).aspx) + + +#### ecb (WP8 Only) +Event callback that gets called when your device receives a notification. This is fired if the app is running when you receive the toast notification, or raw notification. ```js //handle MPNS notifications for WP8 @@ -448,55 +513,67 @@ function onNotificationWP8(e) { alert(e.jsonContent.Body); } } +``` -**uccb** - event callback that gets called when the channel you have opened gets its Uri updated. This function is needed in case the MPNS updates the opened channel Uri. This function will take care of showing updated Uri. +#### uccb (WP8 only) +Event callback that gets called when the channel you have opened gets its Uri updated. This function is needed in case the MPNS updates the opened channel Uri. This function will take care of showing updated Uri. -**errcb** - event callback that gets called when server error occurs when receiving notification from the MPNS server. **jsonErrorHandler** is fired by the plugin if server error occurs while receiving notification (for example invalid format of the notification) - function jsonErrorHandler(error) { - $("#app-status-ul").append('
  • error:' + error.code + '
    • '); - $("#app-status-ul").append('
  • error:' + error.message + '
    • '); - } +#### errcb (WP8 only) +Event callback that gets called when server error occurs when receiving notification from the MPNS server (for example invalid format of the notification). -To control the launch page when the user taps on your toast notification when the app is not running, add the following code to your mainpage.xaml.cs +```js +function jsonErrorHandler(error) { + $("#app-status-ul").append('
  • error:' + error.code + '
    • '); + $("#app-status-ul").append('
  • error:' + error.message + '
    • '); + } +``` + +#### showToastNotification (WP8 only) +Show toast notification if app is deactivated. - protected override void OnNavigatedTo(System.Windows.Navigation.NavigationEventArgs e) + pushNotification.showToastNotification(successCallback, errorCallback, options); + +The toast notification's properties are set explicitly using json. They can be get in onNotificationWP8 and used for whatever purposes needed. + + +To control the launch page when the user taps on your toast notification when the app is not running, add the following code to your mainpage.xaml.cs +```cs +protected override void OnNavigatedTo(System.Windows.Navigation.NavigationEventArgs e) +{ + base.OnNavigatedTo(e); + try + { + if (this.NavigationContext.QueryString["NavigatedFrom"] == "toast") // this is set on the server { - base.OnNavigatedTo(e); - try - { - if (this.NavigationContext.QueryString["NavigatedFrom"] == "toast") // this is set on the server - { - this.PGView.StartPageUri = new Uri("//www/index.html#notification-page", UriKind.Relative); - } - } - catch (KeyNotFoundException) - { - } + this.PGView.StartPageUri = new Uri("//www/index.html#notification-page", UriKind.Relative); } -Or you can add another **Page2.xaml** just for testing toast navigate url. Like the [MSDN Toast Sample](http://msdn.microsoft.com/en-us/library/windowsphone/develop/hh202967(v=vs.105).aspx) + } + catch (KeyNotFoundException) + { + } +} +``` +Or you can add another `Page2.xaml` just for testing toast navigate url. Like the [MSDN Toast Sample](http://msdn.microsoft.com/en-us/library/windowsphone/develop/hh202967(v=vs.105).aspx) To test the tile notification, you will need to add tile images like the [MSDN Tile Sample](http://msdn.microsoft.com/en-us/library/windowsphone/develop/hh202970(v=vs.105).aspx#BKMK_CreatingaPushClienttoReceiveTileNotifications) -#### unregister -##### android and iOS -You will typically call this when your app is exiting, to cleanup any used resources. Its not strictly necessary to call it, and indeed it may be desireable to NOT call it if you are debugging your intermediarry push server. When you call unregister(), the current token for a particular device will get invalidated, and the next call to register() will return a new token. If you do NOT call unregister(), the last token will remain in effect until it is invalidated for some reason at the GCM side. Since such invalidations are beyond your control, its recommended that, in a production environment, that you have a matching unregister() call, for every call to register(), and that your server updates the devices' records each time. -```js -pushNotification.unregister(successHandler, errorHandler, options); -``` -For Android and iOS you may emit the options as they are not used by the plugin. -##### wp8 + +#### unregister (WP8 Only) + When using the plugin for wp8 you will need to unregister the push channel you have register in case you would want to open another one. You need to know the name of the channel you have opened in order to close it. Please keep in mind that one application can have only one opened channel at time and in order to open another you will have to close any already opened channel. - function unregister() { - var channelName = $("#channel-btn").val(); - pushNotification.unregister( - successHandler, errorHandler, - { - "channelName": channelName - }); - } +```cs +function unregister() { + var channelName = $("#channel-btn").val(); + pushNotification.unregister( + successHandler, errorHandler, + { + "channelName": channelName + }); +} +``` You'll probably want to trap on the **backbutton** event and only call this when the home page is showing. Remember, the back button on android is not the same as the Home button. When you hit the back button from the home page, your activity gets dismissed. Here is an example of how to trap the backbutton event; @@ -536,124 +613,114 @@ For the above to work, make sure the content for your home page is wrapped in an
    ``` -#### setApplicationIconBadgeNumber (iOS only) -set the badge count visible when the app is not running -```js -pushNotification.setApplicationIconBadgeNumber(successCallback, errorCallback, badgeCount); -``` -**badgeCount** - an integer indicating what number should show up in the badge. Passing 0 will clear the badge. -#### showToastNotification (WP8 only) -Show toast notification if app is deactivated. The toast notification's properties are set explicitly using json. They can be get in onNotificationWP8 and used for whatever purposes needed. +## Testing +The notification system consists of several interdependent components. - pushNotification.showToastNotification(successCallback, errorCallback, options); +1. The client application which runs on a device and receives notifications. +2. The notification service provider (ADM for Amazon Fire OS, APNS for Apple, GCM for Google, MPNS for WP8) +3. Intermediary servers that collect device IDs from clients and push notifications through ADM, APNS GCM or MPNS. -## Test Environment -The notification system consists of several interdependent components. +This plugin and its target Cordova application comprise the client application.The ADM, APNS, GCM and MPNS infrastructure are maintained by Amazon, Apple, Google and Microsoft, respectively. In order to send push notifications to your users, you would typically run an intermediary server or employ a 3rd party push service. This is true for all ADM (Amazon), APNS (iOS), GCM (Android) and MPNS (WP8) notifications. However, when testing the notification client applications, it may be desirable to be able to push notifications directly from your desktop, without having to design and build those server's first. There are a number of solutions out there to allow you to push from a desktop machine, sans server. - 1) The client application which runs on a device and receives notifications. - 2) The notification service provider (ADM for Amazon Fire OS, APNS for Apple, GCM for Google) - 3) Intermediary servers that collect device IDs from clients and push notifications through Amazon ADM servers, APNS and/or GCM. +### Testing APNS and GCM notifications -This plugin and its target Cordova application comprise the client application.The ADM, APNS and GCM infrastructure are maintained by Amazon, Apple and Google, respectively. In order to send push notifications to your users, you would typically run an intermediary server or employ a 3rd party push service. This is true for all ADM(Amazon), GCM (Android) and APNS (iOS) notifications. However, when testing the notification client applications, it may be desirable to be able to push notifications directly from your desktop, without having to design and build those server's first. There are a number of solutions out there to allow you to push from a desktop machine, sans server. The easiest I've found to work with is a ruby gem called [pushmeup](http://rubygems.org/gems/pushmeup). I've only tried this on Mac, but it probably works fine on Windows as well. Here's a rough outline; +An easy solution to test APNS and GCM is a ruby gem called [pushmeup](http://rubygems.org/gems/pushmeup) (tested only on Mac, but it probably works fine on Windows as well). -**Prerequisites**. +#### Prerequisites: - Ruby gems is installed and working. - - You have successfully built a client with this plugin, on both iOS and Android and have installed them on a device. +- You have installed the [PushMeUp gem](https://github.com/NicosKaralis/pushmeup): `$ sudo gem install pushmeup` -#### 1) [Get the gem](https://github.com/NicosKaralis/pushmeup) - $ sudo gem install pushmeup - -#### 2) (iOS) [Follow this tutorial](http://www.raywenderlich.com/3443/apple-push-notification-services-tutorial-part-12) to create a file called ck.pem. -Start at the section entitled "Generating the Certificate Signing Request (CSR)", and substitute your own Bundle Identifier, and Description. - - a) go the this plugin's Example/server folder and open pushAPNS.rb in the text editor of your choice. - b) set the APNS.pem variable to the path of the ck.pem file you just created - c) set APNS.pass to the password associated with the certificate you just created. (warning this is cleartext, so don't share this file) - d) set device_token to the token for the device you want to send a push to. (you can run the Cordova app / plugin in Xcode and extract the token from the log messages) - e) save your changes. - -#### 3) (Android) [Follow these steps](http://developer.android.com/guide/google/gcm/gs.html) to generate a project ID and a server based API key. - - a) go the this plugin's Example/server folder and open pushGCM.rb in the text editor of your choice. - b) set the GCM.key variable to the API key you just generated. - c) set the destination variable to the Registration ID of the device. (you can run the Cordova app / plugin in on a device via Eclipse and extract the regID from the log messages) - -#### 4) Push a notification - a) cd to the directory containing the two .rb files we just edited. - b) Run the Cordova app / plugin on both the Android and iOS devices you used to obtain the regID / device token, respectively. - c) $ ruby pushGCM.rb - d) $ ruby pushAPNS.rb -**Server for ADM** +#### APNS/iOS Setup +[Follow this tutorial](http://www.raywenderlich.com/3443/apple-push-notification-services-tutorial-part-12) to create a file called ck.pem. -There is a python script that runs a simple web server from your local machine. Goto Example/Server folder. Follow the steps below: +Start at the section entitled "Generating the Certificate Signing Request (CSR)", and substitute your own Bundle Identifier, and Description. -#### 1) open ADMServer.py in text editor and change the PORT, PROD_CLIENT_ID and PROD_CLIENT_SECRET values. +1. Go the this plugin's Example/server folder and open pushAPNS.rb in the text editor of your choice. +2. Set the APNS.pem variable to the path of the ck.pem file you just created +3. Set APNS.pass to the password associated with the certificate you just created. (warning this is cleartext, so don't share this file) +4. Set device_token to the token for the device you want to send a push to. (you can run the Cordova app / plugin in Xcode and extract the token from the log messages) +5. Save your changes. -#### 2) From command line run this command - "python ADMServer.py". -#### 3) Open your favorite browser and load server url : http://localhost:4000/. It should report "Server Running". If you don't see this then check on command line for any errors. This also means something went wrong with ADM registration. Double check your Client_ID and Secret_Code. Also, make sure your app on Amazon dev portal has Device Messaging switch turned ON. +#### Android/GCM Setup +[Follow these steps](http://developer.android.com/guide/google/gcm/gs.html) to generate a project ID and a server based API key. -#### 4) Once you register through the app and have valid registrationId, you should register that with the server too using this url: http://localhost:4000/register?device=registraionId. +1. Go the this plugin's Example/server folder and open pushGCM.rb in the text editor of your choice. +2. Set the GCM.key variable to the API key you just generated. +3. Set the destination variable to the Registration ID of the device. (you can run the Cordova app / plugin in on a device via Eclipse and extract the regID from the log messages) -#### 5) To see list of registered devices with your server use this url: http://localhost:4000/show-devices +#### Sending a test notification -#### 6) To send a message to one or more registered devices use this url: http://localhost:4000/show-devices, click on the radio button next to device id and type in the message. +1. cd to the directory containing the two .rb files we just edited. +2. Run the Cordova app / plugin on both the Android and iOS devices you used to obtain the regID / device token, respectively. +3. `$ ruby pushGCM.rb` or `$ ruby pushAPNS.rb` -If all went well, you should see a notification show up on each device. If not, make sure you are not being blocked by a firewall, and that you have internet access. Check and recheck the token id, the registration ID and the certificate generating process. +If you run this demo using the emulator you will not receive notifications from GCM. You need to run it on an actual device to receive messages or install the proper libraries on your emulator (You can follow [this guide](http://www.androidhive.info/2012/10/android-push-notifications-using-google-cloud-messaging-gcm-php-and-mysql/) under the section titled "Installing helper libraries and setting up the Emulator") If everything seems right and you are not receiving a registration id response back from Google, try uninstalling and reinstalling your app. That has worked for some devs out there. -In a production environment, your app, upon registration, would send the device id (iOS) or the registration id (Android), to your intermediary push server. For iOS, the push certificate would also be stored there, and would be used to authenticate push requests to the APNS server. When a push request is processed, this information is then used to target specific apps running on individual devices. +While the data model for iOS is somewhat fixed, it should be noted that GCM is far more flexible. The Android implementation in this plugin, for example, assumes the incoming message will contain a '**message**' and a '**msgcnt**' node. This is reflected in both the plugin (see GCMIntentService.java) as well as in provided example ruby script (pushGCM.rb). Should you employ a commercial service, their data model may differ. As mentioned earlier, this is where you will want to take a look at the **payload** element of the message event. In addition to the cannonical message and msgcnt elements, any additional elements in the incoming JSON object will be accessible here, obviating the need to edit and recompile the plugin. Many thanks to Tobias Hößl for this functionality! -If you're not up to building and maintaining your own intermediary push server, there are a number of commercial push services out there which support both APNS and GCM. +### Testing ADM Notifications for Amazon Fire OS -[Urban Airship](http://urbanairship.com/products/push-notifications/) +####Register your app for Amazon Device Messaging (ADM) -[Pushwoosh](http://www.pushwoosh.com/) +1. Create a developer account on [Amazon Developer Portal](https://developer.amazon.com/home.html) +2. [Add a new app](https://developer.amazon.com/application/new.html) and turn Device Messaging switch to ON. Create a sample app for your device so you have the app name and package name used to register online. +3. Create [Security Profile](https://developer.amazon.com/iba-sp/overview.html) and obtain [ADM credentials](https://developer.amazon.com/sdk/adm/credentials.html) for your app. -[openpush](http://openpush.im) +#### Sending a test notification -[kony](http://www.kony.com/push-notification-services) and many others. +1. Inside the plugin's examples/server folder, open the `pushADM.js` NodeJS script with a text editor. (You should already have NodeJS installed). +2. Edit the CLIENT_ID and CLIENT_SECRET variables with the values from the ADM Security Profile page for your app. This will allow your app to securely identify itself to Amazon services. +3. Compile and run the sample app on your device. Note the sample app requires the Cordova Device and Media plugins to work. +4. The sample app will display your device's registration ID. Copy that value (it's very long) from your device into `pushADM.js`, entered in the REGISTRATION_IDS array. To test sending messages to more than one device, you can enter in multiple REGISTRATION_IDS into the array. +5. To send a test push notification, run the test script via a command line using NodeJS: `$ node pushADM.js`. -[Amazon Simple Notification Service](https://aws.amazon.com/sns/) -#### 4) Send MPNS Notification for WP8 +### Testing MPNS Notification for WP8 The simplest way to test the plugin is to create an ASP.NET webpage that sends different notifications by using the URI that is returned when the push channel is created on the device. You can see how to create one from MSDN Samples: -[Send Toast Notifications (MSDN Sample)](http://msdn.microsoft.com/en-us/library/windowsphone/develop/hh202967(v=vs.105).aspx#BKMK_SendingaToastNotification) +- [Send Toast Notifications (MSDN Sample)](http://msdn.microsoft.com/en-us/library/windowsphone/develop/hh202967(v=vs.105).aspx#BKMK_SendingaToastNotification) +- [Send Tile Notification (MSDN Sample)](http://msdn.microsoft.com/en-us/library/windowsphone/develop/hh202970(v=vs.105).aspx#BKMK_SendingaTileNotification) +- [Send Raw Notification (MSDN Sample)](http://msdn.microsoft.com/en-us/library/windowsphone/develop/hh202977(v=vs.105).aspx#BKMK_RunningtheRawNotificationSample) -[Send Tile Notification (MSDN Sample)](http://msdn.microsoft.com/en-us/library/windowsphone/develop/hh202970(v=vs.105).aspx#BKMK_SendingaTileNotification) -[Send Raw Notification (MSDN Sample)](http://msdn.microsoft.com/en-us/library/windowsphone/develop/hh202977(v=vs.105).aspx#BKMK_RunningtheRawNotificationSample) - -## Notes +### Troubleshooting and next steps +If all went well, you should see a notification show up on each device. If not, make sure you are not being blocked by a firewall, and that you have internet access. Check and recheck the token id, the registration ID and the certificate generating process. -If you run this demo using the emulator you will not receive notifications from GCM. You need to run it on an actual device to receive messages or install the proper libraries on your emulator (You can follow [this guide](http://www.androidhive.info/2012/10/android-push-notifications-using-google-cloud-messaging-gcm-php-and-mysql/) under the section titled "Installing helper libraries and setting up the Emulator") +In a production environment, your app, upon registration, would send the device id (iOS) or the registration id (Android/Amazon), to your intermediary push server. For iOS, the push certificate would also be stored there, and would be used to authenticate push requests to the APNS server. When a push request is processed, this information is then used to target specific apps running on individual devices. -If everything seems right and you are not receiving a registration id response back from Google, try uninstalling and reinstalling your app. That has worked for some devs out there. +If you're not up to building and maintaining your own intermediary push server, there are a number of commercial push services out there which support both APNS and GCM. -While the data model for iOS is somewhat fixed, it should be noted that GCM is far more flexible. The Android implementation in this plugin, for example, assumes the incoming message will contain a '**message**' and a '**msgcnt**' node. This is reflected in both the plugin (see GCMIntentService.java) as well as in provided example ruby script (pushGCM.rb). Should you employ a commercial service, their data model may differ. As mentioned earlier, this is where you will want to take a look at the **payload** element of the message event. In addition to the cannonical message and msgcnt elements, any additional elements in the incoming JSON object will be accessible here, obviating the need to edit and recompile the plugin. Many thanks to Tobias Hößl for this functionality! +- [Amazon Simple Notification Service](https://aws.amazon.com/sns/) +- [kony](http://www.kony.com/push-notification-services) +- [openpush](http://openpush.im) +- [Pushwoosh](http://www.pushwoosh.com/) +- [Urban Airship](http://urbanairship.com/products/push-notifications/) +- etc. -## Additional Resources -[Local and Push Notification Programming Guide](http://developer.apple.com/library/mac/#documentation/NetworkingInternet/Conceptual/RemoteNotificationsPG/ApplePushService/ApplePushService.html) (Apple) -[Google Cloud Messaging for Android](http://developer.android.com/guide/google/gcm/index.html) (Android) -[Apple Push Notification Services Tutorial: Part 1/2](http://www.raywenderlich.com/3443/apple-push-notification-services-tutorial-part-12) +##Additional Resources -[Apple Push Notification Services Tutorial: Part 2/2](http://www.raywenderlich.com/3525/apple-push-notification-services-tutorial-part-2) +- [Amazon Device Messaging](https://developer.amazon.com/sdk/adm/credentials.html) +- [Apple Push Notification Services Tutorial: Part 1/2](http://www.raywenderlich.com/3443/apple-push-notification-services-tutorial-part-12) +- [Apple Push Notification Services Tutorial: Part 2/2](http://www.raywenderlich.com/3525/apple-push-notification-services-tutorial-part-2) +- [Google Cloud Messaging for Android](http://developer.android.com/guide/google/gcm/index.html) (Android) +- [How to Implement Push Notifications for Android](http://tokudu.com/2010/how-to-implement-push-notifications-for-android/) +- [Local and Push Notification Programming Guide](http://developer.apple.com/library/mac/#documentation/NetworkingInternet/Conceptual/RemoteNotificationsPG/ApplePushService/ApplePushService.html) (Apple) -[How to Implement Push Notifications for Android](http://tokudu.com/2010/how-to-implement-push-notifications-for-android/) -## Acknowledgments +## Acknowledgments Huge thanks to Mark Nutter whose [GCM-Cordova plugin](https://github.com/marknutter/GCM-Cordova) forms the basis for the Android side implimentation. From f70b1045fd03a6aa9f5e2de3e3dfae0f0172810b Mon Sep 17 00:00:00 2001 From: Russell Beattie Date: Tue, 13 May 2014 16:43:09 -0700 Subject: [PATCH 128/133] Update README.md Updating sound file section as e.soundname doesn't work on Fire OS. Probably should test it though. --- README.md | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 8a0d02af..459837ed 100644 --- a/README.md +++ b/README.md @@ -397,9 +397,12 @@ function onNotification(e) { if ( e.foreground ) { $("#app-status-ul").append('
  • --INLINE NOTIFICATION--' + '
    • '); - + + // on Android soundname is outside the payload. + // On Amazon FireOS all custom attributes are contained within payload + var soundfile = e.soundname || e.payload.sound; // if the notification contains a soundname, play it. - var my_media = new Media("/android_asset/www/"+e.soundname); + var my_media = new Media("/android_asset/www/"+ soundfile); my_media.play(); } else From 2de525365bcc2391ad8d0a399ef4662e83ac0474 Mon Sep 17 00:00:00 2001 From: Russell Beattie Date: Tue, 13 May 2014 16:48:07 -0700 Subject: [PATCH 129/133] Update index.html Added in sound change --- Example/www/index.html | 12 ++++++++---- 1 file changed, 8 insertions(+), 4 deletions(-) diff --git a/Example/www/index.html b/Example/www/index.html index 7d28938f..e88220ab 100755 --- a/Example/www/index.html +++ b/Example/www/index.html @@ -101,9 +101,13 @@ if (e.foreground) { $("#app-status-ul").append('
  • --INLINE NOTIFICATION--' + '
    • '); - - // if the notification contains a soundname, play it. - var my_media = new Media("/android_asset/www/"+e.soundname); + + // on Android soundname is outside the payload. + // On Amazon FireOS all custom attributes are contained within payload + var soundfile = e.soundname || e.payload.sound; + // if the notification contains a soundname, play it. + var my_media = new Media("/android_asset/www/"+ soundfile); + my_media.play(); } else @@ -156,4 +160,4 @@
    - \ No newline at end of file + From 60389e4ebb3427653593d55e079373993e1b3d1e Mon Sep 17 00:00:00 2001 From: Bas Bosman Date: Wed, 14 May 2014 18:22:30 +0200 Subject: [PATCH 130/133] Fix link --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 459837ed..4bbb1646 100644 --- a/README.md +++ b/README.md @@ -4,7 +4,7 @@ ## DESCRIPTION -This plugin is for use with [Cordova](http://incubator.apache.org/cordova/), and allows your application to receive push notifications on Amazon Fire OS, Android, iOS and WP8 devices. The Amazon Fire OS implementation uses [Amazon's ADM (Amazon Device Messaging) service](https://developer.amazon.com/sdk/adm.html), the Android implementation uses [Google's GCM (Google Cloud Messaging) service](http://developer.android.com/guide/google/gcm/index.html), whereas the iOS version is based on [Apple APNS Notifications](http://developer.apple.com/library/mac/#documentation/NetworkingInternet/Conceptual/RemoteNotificationsPG/ApplePushService/ApplePushService.html). The WP8 implementation is based on [MPNS](http://msdn.microsoft.com/en-us/library/windowsphone/develop/ff402558(v=vs.105).aspx). +This plugin is for use with [Cordova](http://cordova.apache.org/), and allows your application to receive push notifications on Amazon Fire OS, Android, iOS and WP8 devices. The Amazon Fire OS implementation uses [Amazon's ADM (Amazon Device Messaging) service](https://developer.amazon.com/sdk/adm.html), the Android implementation uses [Google's GCM (Google Cloud Messaging) service](http://developer.android.com/guide/google/gcm/index.html), whereas the iOS version is based on [Apple APNS Notifications](http://developer.apple.com/library/mac/#documentation/NetworkingInternet/Conceptual/RemoteNotificationsPG/ApplePushService/ApplePushService.html). The WP8 implementation is based on [MPNS](http://msdn.microsoft.com/en-us/library/windowsphone/develop/ff402558(v=vs.105).aspx). **Important** - Push notifications are intended for real devices. They are not tested for WP8 Emulator. The registration process will fail on the iOS simulator. Notifications can be made to work on the Android Emulator, however doing so requires installation of some helper libraries, as outlined [here,](http://www.androidhive.info/2012/10/android-push-notifications-using-google-cloud-messaging-gcm-php-and-mysql/) under the section titled "Installing helper libraries and setting up the Emulator". From e0076130186d7d2e7fbc4c35b5ef7f0955497c48 Mon Sep 17 00:00:00 2001 From: Byron Matto Date: Wed, 14 May 2014 17:00:18 -0400 Subject: [PATCH 131/133] remove condition to test if web view is in loading state --- src/ios/AppDelegate+notification.m | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/ios/AppDelegate+notification.m b/src/ios/AppDelegate+notification.m index 5859f191..aa563a34 100644 --- a/src/ios/AppDelegate+notification.m +++ b/src/ios/AppDelegate+notification.m @@ -89,7 +89,7 @@ - (void)applicationDidBecomeActive:(UIApplication *)application { //zero badge application.applicationIconBadgeNumber = 0; - if (![self.viewController.webView isLoading] && self.launchNotification) { + if (self.launchNotification) { PushPlugin *pushHandler = [self getCommandInstance:@"PushPlugin"]; pushHandler.notificationMessage = self.launchNotification; From f7cadb63dcfc2d793f65deb9d06301896445ece8 Mon Sep 17 00:00:00 2001 From: Stefano Sala Date: Tue, 27 May 2014 18:11:18 +0200 Subject: [PATCH 132/133] Fix xml validation for plugin.xml --- plugin.xml | 1 + 1 file changed, 1 insertion(+) diff --git a/plugin.xml b/plugin.xml index 07a44eab..28401d91 100755 --- a/plugin.xml +++ b/plugin.xml @@ -1,6 +1,7 @@ From e4f97f992150b5d865fa2ea9c9869c88e3d2014c Mon Sep 17 00:00:00 2001 From: jasonhr13 Date: Mon, 23 Jun 2014 13:31:37 -0700 Subject: [PATCH 133/133] backwards compatability for ios7 and ios8 --- src/ios/PushPlugin.m | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/src/ios/PushPlugin.m b/src/ios/PushPlugin.m index 9c29d569..8d5b3af0 100644 --- a/src/ios/PushPlugin.m +++ b/src/ios/PushPlugin.m @@ -85,7 +85,12 @@ - (void)register:(CDVInvokedUrlCommand*)command; isInline = NO; - [[UIApplication sharedApplication] registerForRemoteNotificationTypes:notificationTypes]; + #if __IPHONE_OS_VERSION_MAX_ALLOWED >= 80000 + [[UIApplication sharedApplication] registerUserNotificationSettings:[UIUserNotificationSettings settingsForTypes:(UIRemoteNotificationTypeSound | UIRemoteNotificationTypeAlert | UIRemoteNotificationTypeBadge) categories:nil]]; + [[UIApplication sharedApplication] registerForRemoteNotifications]; // you can also set here for local notification. + #else + [[UIApplication sharedApplication] registerForRemoteNotificationTypes:notificationTypes]; + #endif if (notificationMessage) // if there is a pending startup notification [self notificationReceived]; // go ahead and process it

    uK0A>%)i=!cs38f&`TpoeF88EapS{ z_4UkIGno^^w54CjYoAHMT`f)Myf!5bHx8iaW@4q_ccd7*wg$x5e@n{{_vXHx@3vuR}43O>2w$fAw73DlP!+5tL&iL zX${wIf3%1VEVKh28)*$GI|xT-JAS!dLJ{AqtpjC@StMz6?&iza$&iy>1nvK1=Bcbal#w!n6~ROXV{o>?xhT*1h2-t$xsS5{81oAPnqVQ@dQBA z38j*-oyv=Z8dO6vl#xT+jBOkT192gZ0<}0Ry>~(VrzMFu69*7MaHQyCdroQRQdy7( z4gNS>7_%Zs@?|ziA0)e14Jg+uhR%B9Okm_36@O;6(?|%A8oo3Ys#f?w@k^1}MJz2D zL~nvQHYPm{PH{;NQj#{^$Ik7NA{BNyBTj^ZKhGh*n&-sXR}fo;#qsMwjKs~V)w%41 z1E2iM$iS^05K;EoCoHC@ty6N^7~+>v!ux{cLk9)i3BCJ*C`A@T0+fyADisL7;SUT$ z3f&jW{R1fH%pxO};?dWr?&N!W6U|c=Vdifw^qUGXvj$EO0I~dAzB+QIM^k1jHmMTa*L6L++CAsRp@<7^Y=NIyOw>E?3KAEpP?_= z*$yFFfu-1$G`--YxN=`eP>#3{^IzWm^Nh&Cu=@+;ye|lfC#1Zzb}E45Y(7Xrs);z1 zdyyDl$d3pLRes>81u7tpOyycft8&NNjTc0>zaJm0c^^(V0YV&+XScW_{RlnpmcC@D z#lym83tdgTP?!~oSw^NzJch~A0!i>eQ<_O9f9UDVuwkgda?Alu9Bswkst=!8x>a-j zexcPb&DSD32TFwV#91&pat>iOi6Sq7+lQT;5=DzVlpV^ZcUaw#VT98R!I2&7)_y?( zEb})K#6iT*Q@&E(v8N|}=40~TLn;U_%f4>-5=qZWQe`yV#BGo$V1`KPCd&b6d$ik0CkJE4;sCe4x3;9R7#=}ne7JOhqV z>r*cM7`wDxL0L`lSSp^WuVI&ZrkW*=@qB_lK|u^Q$M!}SR;8MYY7>=l*tZ63(u^F# zE17cn9-?LPx>yjn<>@2mTg6oh0%4XfeATn%X)2zrMu2JA7l&$CybuxsLEKZZ%Kn%y$ADVgzKb9T-13z=RMQ^8^T zLvp5M9qcPZu+AZ^2Ss9katAnZtS(NiprK*F1#(l@mR8?*7}K|X)anwS1BEUm^2p2h zkBsq>cKX>>YDT!~khQVq*Ryr==s=d9h1n_gv3)O3Q-12T? zgbmBrz0-YG0mvd5N`r7r;OH4}vjJo*iA_y!E5^-@xwQQ7reDCSqi zZ;Aa{=w{#3k~lKS3LhmFjxYILP3eIE{R(~7k6eN?42f$RwLkFUsXcn6QEb~6+Jd>L zbU3d-?NX?5F6K;-dNJuH2~Y~xE=4mHbA~*Mr?PeKSlVlQ=NU1-MzXxAf=M=A?^yXx z)&^rscwD@qEAqW_12)WAC1z%Omue~6Q!SjlB8bov@sTO&y-DNTvBqP|z?hO+YaU{l z3ElWS^)hQ&I(awKZCQ$rRtCfotSSTT2&!W}$Q|C?F|k~lw-Q~=1#ei~ob0u&Q%F?z zp$E0yZcwp-!euwCzQLd+^^MQ_&gzXWThk&~IUSjvCoJXGo~n&BeBTRRbQ>j#CzQnK<5<8Yb1l5xG(VQtWMV-Ox*PB1(JUoPBw{fmXwW#0I?jF*KRH z*73@t2lQb~KwUt^WT=oy0`d5ey#tF(_A&5y6&yohI{a6@w@tyg&hOqN?iHRj{qtzH z->mUBHoc;odK6ADY~M?LaKh_*_vbOLmnv5NwD%5p;yDJKu=wZ0lYw7??M+$;v6;%{ zb>p55)dZ66m#F(R3vb7?iQKCmc4V`JD!z=%X7*VAXxg%PjuhgFq#R_EIrg_ZlFyKz z7U{tA170XZWzQ7yZ$YbTfukJ2uRvtYlimos8??Uv;{e_i&Y2t5&ZQF75++jNKwQD9 zvYJjpST%+yc?c|e$O#$EQ<;IlovcEY9piUKHCrb^q)pY0aW@brwR(qq-|^kGy_MKz z5CJo=LE8g_q7(^5Gcjk221x1K+~fS%=bpUS9z7M3tQ(iwA%zMv@vBnnsgkjAHt>gX zFXDm0@sM);&tN$XQGP{N(oIBu)ICh4P*ZLs<#r@x zS#i0=Dxt+x$g+uG**(Q5KWr}NlHWSZO)jU_BPD{_CS(L%$zFQM)%FYIwPl_*7MdwY z>1!U?hWw$^h#Se_vc0=p&p4Blq6dS)HZLvdjlpb3C)@7vY9iJPw}fUX17RNw?!c7M zdW%F@uii=%jv(UofQQvJ)O#({S?1kF;WyoBX*T$`>`mzvyDjk)kXPN*J1vvQ zuFt9LwRQCGo$3Fh%OL3N;ArdcuO!Y&RcKEXRZJh!)$?o&C`yC(vII#GQ5;U{D==4HhyVDdAV_p^%fM7EqPLb z(sol=%8E15NVAo^Yp{BXijW!mtpv3_$Oy?r`TmIHMiX?k56k^LU%!PJFQ+kIryjQh zgteVvRryo*w<+6M)yFtW#>Y499~QA3-S*~Ye8ZS(6VXdAbsE5FcB($WfD);OQ(jb= z;r5ntjogqMwYN6CTlxTN7$AAzDDo#xoKM>Q;&LdQ4cH9x7#wiVH=#KFz~RZ0J!#Fe zi98nJ8g3YBC1s{JKrwB061q^++NA#-(f)ymRWnW=GQJS%Ti~AsctdSKAN6i`PS4`y zxLhGF&(RZZbM*tM#c$_pZiG!ws;y_DH(~RbhawGkMZcjit5{P< z59BAiHrQ8jx34KRe&003u2`$}vY+)!WD-1n&2I5Z(e9UFjJr8ntnwZ4a)bC2b23q? zVmz~Zx>Gr1+el`5n0RwqXt=fIz&x(3fE1fSA((w^$i-+Fld+~?TOui3yj&wS$9fLu z-ag=1w_qx*qe7>!1)IjT@VN3t!>!|?j#~OrM28iN&UCxZX@CW20Yc4@v3-OBSjO@A zTq7;&yJa;PG}rRw6!J4g`Nw^2`Mg>#6Md$tZPd;?)t0 z?E<~~c%A}3*$^r2evG>o|2+PXu{)udO~>|dZf)!}QQ7O##GjQadi&=i4)h>}*=?t{ zqt-vw4tr5SWn(#>ePdU%oB67hy9$<~=SXKQDFgo6nlUfJ)qrGskwJCX?g2`yt!Q|& zr=L6pyZtK#`t=b_dhubZ%o8~kyEs#pBfH*Mmpz$tS~J&JG!{>&50)4`DzM#2C)z1< z*KH9l2FYQpC{{1q+sr_%L@E7PK7=XVsK&NqzjZKiV@!aP!nVzyxZxv2Dg~3m5VSMMg>Za>0 zV9b+>y(*Y63*JUo?^u8LCZ47``i?8g+l!TSeclr+HOme^Xtf*WfxJd?T1tK|OXZ#8 zil=gy-;#~@OtDtzz}HKi!K_cHxr9A}CmFR}fBN)(WYmek1=-&bBQ=05x3UgCB{zF+b6@INbHE64I1%ha7K5^=3ZvNE1xq^-t>r|?ZI?P{{%)s87<5{*$Kxqm*w}5@r#ftk-u7%pXKOPpVUR*F@FBd9ezqWKM?vAJ*Oi zsLpKL7EW*t!Ciy9ySuwvaCZpqvT=8J3GVKY;O_1a+%4GK>F)FH>HO#Ry|3yoHnrJQ zt)l9ilWAkFF>3gXe5%eVYGXEaL@h;sGA1$juN9ktn5yMCG`0`34~|0)9thNL>1#)e z4c;ka7oz0^Q5#;t0n%81dV}K1i%yt%aq^0e4p@HNCiEvlPztF|?>IR%82@5qT1TOk zEF*xE-A&|)oatIi8l{7}@g-;pDZYtQm=DLDsPBi4SQHgVG<7oVY$3Q|=?MAgRq6Qg zAi8UsYca-{DMpuR&4-EHtSW9pJ2S07GpuWu}72IH1F&`KX{I9B@J&qrR4PJ zOI(v~6t+8!-O}=mG11MZ;8&&K-y@5n9AktNAeE6_DH6wW!zc(F+zRXNr!v8Zh&opK5XXL+!V6tMb_+12Wg)1g zyBVAkk1n|tUXLJFjJONYl-q@wXrJ>PH2Z<*-4CHIiS05nmpyLu#Cp>|uD=Jc!d$TZ z;Tl~Z*JE4`Bf=J#x9C<*YbZmmgDt65n)fA_oY! zj;ETCIKLb*!bdBFH6UCa(v5{HVy6BiugJtF!Q%zqVZ7kSC^RDVfUd7Nw<6~MSYQ-n zjC8-ljv}}=_t9d>2VCUZpDq{qp?<>$kWCmz^DGtzerrPg_=h9}_?ni!D{%OU|2OWC z-`UXqhlP^AFm_Q}AX)OSpZ`F|Y@Fl_9E}~E|L;PH(w}mvbrN-l&J8Q2=Fc|Pn(hd{Pp^n;Qo%LH2p7XhThb zD6jvV5)Z0FJ7BBW|5K0pVEkcwMMtsL zX=GQ78YrTqgNul3b3T$A`4e|6CDBrl`;KpJdEPi;^mtn{LN6k`99ijYM$ zO=L++`Q>*l-fi09ltP*)w$; zN$vt~a|aY;jziRP>C=hLDb`x$Mql6YCSgce`U$3)IJI{bV2(GfC>?o=L~WDp*O=vx z@bkxpC{YT}DS{JI9$D0O_)Lp|!H_5clBpEE+-O6(?1?RA%Uej4ZsDvN*JG64>|4}@ zsli?L8m7(V$dx3@j+Mzqk*f~Z$cyNs(#o9XoicsAvKmyFw5BZU#@e|@&^{aoO?E6^ zRk7}ULS5u9>v(A1e=MD4q@l_E1Ojv*f8#^^-Op(M8KCiXxHy+Ucq=9febsFo^P zy`?2pNxfoOuVNeP6l8#TUI~Sy84-MF#WMAXaIuE-&>8;;PZEl4Ni)@wow*We#)CwCQ~-k$9dlUeBwIF_Ja*>! zoc01)blMWvHeDY0AOR%!T!=G{`%thqLe_}lMF?Je6C5P*s;uaCUX^J9wzo|iU=ghj zw}cEHLXrpdXe6g>xX394AK#3gBIjYVvXx)kUWt+=1-O3GoAl0pdXI>qo+x1H%CoUg zCp^1rIHt*0{ZkbSJx1CP4VLn(NS~lA52bQJc@@?^GuLkUj_F5k(V_Yoq+{EcZtJhT zMuRwIO6;d|`_~JRN6wk0nWNJx3wz$*YWxY>SsE@+=DZs^`>O3VpORPYKWMEwOjK=* zy;W~qX?vS_WX@w|X|;OB4Lm6JfHr$_rKEeNCkO0}KN zp~ELQOkM$>OCFGs#p!R707y}Qxa32la)R1~FFcLw$D6xJf?FpHxL3aCP0|;+`!4Qk zkd40*TqmMU!V>g=X_Q~59ez`lFJ6LZ3GE`!fAz;2ovo3OBO?$h{`xm>{JoK5|7UOf zkE}WW61~Y(68NR|`&vY!vrG$8h$aH|jcA2t+TfyKs$UdT;#g$nshZ1tftqP-9PI+# z?ZU{v=dV?O?=Uju!S0KxY#ZLT>mC~(*E!Ct4@5ea4BTgSn52|2>F&%prNq`*c+8+AN`x~eV&L4~spNPN+QmAwZl8(ehMqKt z^KUr%a@pFR5`(Av<%Rr@cmUd3LH_zR$P$+(P7c&@F3;?w1y)sum&A+*3@J>HOujul zaf-yJDV8))94Q>R%e*QH9Aq@AMFroh=?R$8baGjyFjYGwmN6PhjO3iMa~V(Bgf1(v zNc>!JQ*RcEOlt45vK`_!6X6UBKP{byIpqjKBIuyh>=@vI8@hcsqV;6fKG}{9PcKpY zWLlM8pDBJjnUqRjZ_*K}|DqYsH`=%~p+qG;_artm;v*%}!GnE~;D;M)#tj8k*`PU_ zMfS#Eb&EIVlSP^>YHU6PC9VqSB$7079ds8spgtw(x&$BH=n&qoBcYj0BSRvv5123g zLamQz+^tDf^6|Sg==bDrPOQ{b_I@X1Qhfku-dD<3@I|#H<1PSK{lSmKjc>IyQR_d>H~-woo+Fn{egMWglz;TD z|AwjkU&{!;fr`XxwhorY4vJrFY<{T`{I#B-r1Q(kc(Y> z$kYA(>a+X-2;4GF$T*ARtaWw5-e_{f+`x>A{fe-YDa$}X^8Jdw#bu%cC_sLG^8D=e z2+EI(O(>AK3$k3Fz)bqEGVq)rMxiD)1(ebgmma0>qKigh3qsq) zch+Xys)PSpV9uDp`WcV@p`u(2Gu--Xe{tRhYHME`1>u}?(#4IhrFoZFj%}yJQS$}M z44L3Lsw7AIvj9b|7R7|4z-9B8ikxXJ`rbFa7<1&z&d@k%%v|YuDfouvp$X;bt;eD7 z?C2EQxaXd%%}1Rc9?Re7KsY^!=oFFJcHT{3cFS*M02=XDD%>_cGg-;04aBfygt)}t z?%A_0d&jK< zCgp+%)~>2Ttbj3BK*!#+z8iB+*}NV#)8g+%NeN^u&xKY z33e{(25%9c)d{*zkg7u{mkJq-FiU)YoJIfOjk^_fIx%TgNv6-MTL-U)UKdf~F&k7hinLC?1xd9btZ2#PE`qSAG<=bR|La`Y#IB=wNAV`ABPW(NWNBrW0 zAB~2H!DCok7a_HcHZ<-ykg`RBgnNF;Th!&|=PfPaj*VN~T_3-Ib|bQKGuP}JY#L-v z-VWsJ+c9}T6*cXYS%QEEMpdckH!~t5qq=FlKp+i*ic>-(ugT9B+uwP%udyhu6xe6{q@?psz7Z`{@( zK?7PX7Wn<&KY77_w%Wfh9})lihhO}Azw~_nv_he>)?azWngX^kQR;nSDY>;qD^U)A zEEsmE%yODtWOSdi5_)6X*qPvVI-kU6fM4 zL=x)G%T%~evCo|dd0WJgYBVa_;5cfbA15*Hb}rxoLgNlCinQvnWX_VXWOh(p%+x4T zi%ihr&)BgvP7_)*>S#KO*wM#|jN69y((*L3%BI7s>7gpS>DM<8G=q-!E02znTc7;& znP%Qwe}ZNkA^tjytx34jbRK}bTC!|8ME?d!UYdAzh^feyU$iWMX9g&0OMPt;Kd6l(yrrVm;tEnCW<= zu#@cm{X;pd*4&-b)S9p@{*}K(FUB^UQotvp6l?3<7s0(2bkojStx}i;7U*Mfh5{cZ zB`v@Gkv6fp?ev8wq^zBwK=T4(D?KKE8o=or2aj^1P2qZ0mVy@s>nm#PF-QW*aSw>98SAu>1RDnJ=Mmt3T(AI$4urd~;Ej@xIg4zZ zAXB~@xeNSVYT!F0W&qC~NF1|d=le6gFcZ?Ba}KJA1qdmRVcl&;7g)Jr?M^|t$Q+oR zg1f@6v+t$d+rw|@jR#qz2sjY9PeJRugO~#}{G$~D9h;@r;qL9aL%C-t0R>@iJJQ*TiCk)?-O;$(|e~tiAR`;WIro6)kO@Q5(tSX9-l5U$!y9gG!8+0}mkri$UJrCQg}gdP~%z-P?i7ov@*LFZ4yh5|c=(5taCc5g_= zGdz1g=iX8I6KiD7ea>4~Bkx;HWYDtvHa-g_;@S?SJ6;1DX72o97*uK9NU ztO&dEQYKr~Y0mwYrcbi7vG2ZR&#}gON#RH6sY5PRtrLx1b61a$oP$#cbB~J-=2Jl6 ze)?@7`WOS8PEM}oV$RWzOtEV+Yg?_4QsS8gZkY5YxLr!x94cCf6>Ceh{S&ci3Apuw z13GsFCnqia&_nv$wcPeXq(uz*JJ3RhU0!m zlpjgW4i%0=uxV(7Y!2cnFw3x?7s&vFG+n+1VlP^+KAtZUuVFdePxU$Cfq_|L(y?e0 zOXHdte!*VooB5}q{n}gQiW0kxD^ppEId6s-h0?zo*bzPO>7MGA-n_ihRmWrV0MTIYF6ij{6yo z6PaEfK5pRhVoL%L#~)bb>lJEihV*d5)k{c)T3c822kVX43Su0F&MC$T{owTPu+^`Y{`=jXXE_LjZi_M>MA_$uo&uzDPzJEL&(Je zgFj+WkFCLotmtrt>^}Mvgmn-R2;>N~03lBMQudlcPs^WFl zIAKa?sxeH6)VnnnSm+TZr+*Y#>hCXIm4T_+4`{sqO4q-SB6$BfUH>)mlC$}9-UZCj z#!kl4=8iyFfqxCWBISByd-*?l1uQQ64~DjdLbg{kTSnut{IrAIjSFCKXMhOwn`(*OTWx1+xC*_$s-z zT*NRRe%e7EaVP14=$<%s6}c*@Ak~33(iBPQ>HH)qt~#eFwV|1mnnA$irD0STA%uY^ zhaMeVTh~V?*veQzGpnRhr(j#f0`0|6`QV%1$u{zt?I3X{uQqVXC+M}#Bx7NkV-KpY zOA4_vx>XcR5OPZ)*$zN^?P!84JbI@Q5spjRY$T0nqIi?P`^Tm1+xR=uBj7Xpmmb4^ zEFWKh-irwjSY>>fpbLQyRC!KUv-d@wIxub%9}N`L(0K=8beEqMO2H$_OyY; zI-zq(HIQGqdRnn7VazyEZCj^V`$`0?hp#|SN&W)zA-{jAtzAA(fR-htv_-G96<@C;D%;m_ndLER$;d9b^h=p7bv?6C{i)it14Lmn5Ukh z_3ey)JAKU)xbr2fH(dY|DmT#F)_Ag3VW)Fz5Qr82#_GD`%T;va(G&CZ-HJi_MrzW6 zi-kzDk$UTd#kGv&ho|Xe`#5 zZBfOdjPVs27ata|S4)q*mG@OvO!7%P)7Lsal?I*|fnd&eWbIE?r(}`LMmj~TGnF3U9y~S6#M2u}A)`>E*UOP;G z%yUg9VF6h|6acTe`@(Z{Wns6O0o|qGG$)}EI>V{5k6+nLG(Zt z(#QD8r@+kPH#_SaS;og1f%{k^0Hr}mig1nl{8NH6Ry`cYhlUpJe3Qt$036bwJc<*tdsA>~s5+93ovHn_h9^ z%B&+V!TpKlAe2dQEZ_M6;j~WjNkv`kJ4>ytQ8L_%aFsMAo-rwgEL-5w&~7DFz(+DT zm&i&T)F9TVu`o&F-?wwpF`Se?m!n{3(=`a3Y=R$taKjO5R1uJOd(lBj?Q}> z9w);E>`4X?)?u=O3w54JU9#Go!#0fEg9?V-PVNWSxNdY2Qr5h;%K#S6hzN7S+@mWK7kVPbtHF^p;-3X4l848+r#_E0)?X$4!)ACzn7H?vzGP^|7;?QbgTex`?N`Td2n z@8qrhfP?7#4k1X)nqiJDKVcv3-l-%Cvosk&XpU|{dc?@B_!DsOSGy8d4?m`0`G4}PHPl791KMZ&e zOdHdI_I{QJ$NlTW<0(q_2b<)Yz&#}DS;;_EIGqN&u^1NE1)6fE6V3oO{q5+Vo+oyg zW~dOd8Bqh0Wa9;U50a#Uq_UsE1xE%hxeoC!9uk?vUE{vPrRLKL*)K#3Vv-_Y)<*6V z3fV+wF^%2|QncUP%Krf6jUZP%rN|Zw)(!?t_+wrs=~uY)lC4HIb35~}h`%V1p(sqw zYaT+v?fFSI&~fHUsIxDO>BLL!El)=);|%X~ii=WKSL<&T!9zA#CCE3{1hqy&q`{T> zRGAoJe*thYv8|?JpB3zlui8ztO&PokSW8s=(GfCGLtshiBYA=#7nn_N_0~q(Hx7>V zz!TMrnQ}qSqO)qt9PN&-N;FV`PRCPq%wybq@AD`LnY%mXL^c}d)T--pQT|d;D~qjB z0B@X_h8Zr^lgc-3 z-S_GP4w!~1bh*ChCK`4Z(>+vxJms(Q6n*6rDkX-P?gCa6RpuiQLK5NpgO!ueeF;9j zZL1@Sm~JbY*N&e_ohNdwsIp8n*_1?R+J@wtc8$;5~Sky8L>j5#g)&5 zemVNW2eC&KQK$MWiZwC$^Y{wtR+0fsv&+&cUr}U2T?$TQmMPtU#qsDh?fI4Ef+irtuv&b{i zXZHk?GOE*01xLeaGgX`E4e{&bur1s7O-cCKkElj=yI{}J+cZ2Al&)ug7e1VyM69Xoqq-=h|y7zg!nS?K}cevAKENZwk|)5r_}Bc z6$~5@UF$k&!Neia1FchibESEm-eiQ~pCL(&QXin(&=u0yT^0bk2M{N>w~DYCm!d8M=O3R4H+<&*}cIN zLpO6KnPb}rybB)&id2d7S)XKHzhV)QWfY$815V4f#aeLIf~x8EqlRkKL2#u-<&fEc zEye?TxIl!FJr?M)=C}cPwvjz<83_94O7tPTeYOj8wCo3VkeG2NtXq8 z3BX;RatR&7jw|6jjU;Xm4DZNIU8l^T03J_CpdOG+A8}>T?sniaAd!wi)(g(JV;2ki z)crb{*Lw%O31fGp^N;q(#5MLl6H<14dVx|a_tVw_sm2g-ak5 zEYUK!{*6KDeN|1B(vWM`o1#1Qb@6~kyZ2jy!x+0*Uk~nlvbDS2uvxmS_XkE;{r;kJ=u*AW zEokcU_Q^pB&i8t0^9ZuGOIp&nny{gMuAqCns3Zv|+F0a2WsQyLCMKPL*`NjT&q>su zaNqA#1StQh3}9gT1LXVj1nqC)l^Flc34J@eKTiEQoB93Jf1J$#|IV*dq7M3|) zY4~v66?FZ=(DvJbqW-jPqB^uE${y;QoHJY9QUpK9`y}FzB;R7H`$J5->wWWTw#+~! zz%4V4$n>4)Oiehfcqq-v<}50j=G~RFtUJ{Cxl0-^OVp07d4A~AoqA>8y?HUUEy$V{z6DNMlmf z4!!TwtUw@!+giNI$@(!vqg388mQ%N0@CplKaB4*w-jUhR;#(hPX^s0^h(_;~5A_$KABl}E>S1B8Jh9_g7S>^!3(VQh`DC?xP9j@xJlka6=9Opzj|Gh=RKTUT#@mg~KDQ{nD~*P*g38gNz8Pml zNgHI2)+4R;=)t8qtgU4fEq#zxk9V&~U{tjIo%DP0Qn{X_f&~)4RIy#GBIuQ%=wfTF zGx*n9ofv|uIHc7XbK^%!WJPp=?WzLt+c=}uj3F|k@CoDa@5x3Qe(p0G>#d_Go=hX8 zN1i?9xsV9v4;X03F4>xe`p`)h?6PnJJ3Cmd7YgtQhS7lYZA63313lDe3!qeQl|IWn zdCKj3fgF9XXmeK_xe`~!K7@+|K=HQ=xGa^+3;@1CbQnH#*a1tsFFH$mU@}WPQN1f_ zmH7jMu9`d(tp#(t9~*RA1eI2w)}qwOfI%a%B`H)VAbYde;2{-|y<-jE)lJ9p4AV7# zf!&_JrQ~m{< z6w;i;85F}l-DnTE zi`#1JFCR0HHt^J&gsCEvB?^!txZF~!lAb`kloM{B6`HK_0v;Vaj4+R1_L5W|BuB)H z*gVY$3x{Q}rOD!p>eyq&ZH=5ImUzsk@=Y<)BYLR&*2TZMDfXL;i0dAAhTjYURMk)d zztPBinXcUrC2biW_{{5Z<4$@Uf#w>`H_zBfnQTc?J2GQpaW=v3vYMn;;p!n|ZV<)u zfy>+_oMVnLOTOJh;l(&8Ik7ShaMZANX=Tj4c+eSx!orlwu;*b>2&CUB`!g*hA zPhjqKo}}uKZmcDXn~*W`PLkd9L#KqDbkz>iv7~F*I+(@4Iiu|S@g0mI@;OY=Za&J2 zpqcQlN5z^g=kdU7e!GU{HxFg!?mJKAg990uQVK=BJ&f9B08^_m_8LWTgxUO=MK9OU zO8(tglkvth+1@<~7LWN+nH5Um7#XkUEcDsL#Ae?kPl*9URCnw%?a6K_2yC-%h)B?_ zLJ2AzhQqiT(&O$Eeg(4JGMNLi|HvCGSixLa+7?TI+1ic)rH1viw#S%NKfvW?yvtqP2>idM+;Si$wTpkA+u9aQmZ9>i0w3W+2@X$$8X_|-Kq$n-}S&c@BUW-wE6?beWK=2zJQ zSdiV)@5S~=nSv-V>N-dIBqrHCL$kZ`iidGRxwHXUuy|zI-Bom=^_&5`{B9px?t-uG zq?*AJ-8(TeVkgrhN3a4Qk_$# zC!p5jU+E7nhC+=&TL6&75||_J#_4go9MpI3O0Svbnj&&79)`8m_g31e5dyWL zlg$6_&lnlRtT{p8RHY?>b!q!G%?*q?7}L5*0NzH3-fkdev|TC8${`e%$P#0yc=#I2 zTm}39TC_1eU#T5~OY875@6dg8Dbigv4e&f3kW#HJeXuvVxS`4wKcV55kJWzC20aiV zadg)>AfK6BgDvBE_Su8~L!HD-MxU4wdGJb}0O?Lf1?q6)y@Pc==8{N^uSat$I##|h zOk-Wl-lRWn#Gnp!+kIWinTeZ+?;WprH(n8oM@n>?9Vs4-(H6C|fodT+*$}mKohRgw zOH6Vq?&w&=!D$^&Ipv@amZNsJEmNCLpe|uUNOgzxC)YY_gd??nsBXWS<e!P1$!*``JfLbhe%5;EW(x>MQatAxxhYsc~OuuKe3Hou4j&2 zYSaKGGIistsEVJ)(;P-vsq|uibKXvM^*dTL6-V~wI^ZUke*ibxY><@YCf5`tT`1*o z?-XV1}*046nZYyoBfOty)}oO#F$) zrx+B>cr(Pk|Mfy3L_4oCD}vt5qae7HoPnaFh>>vI@Y|Yrw(2E7=0@K4C%3@4O;J>t zdZw%?I2w>E|KqL4;n2iT$;QaAC#jbQ+5wh}_Rl(r&wdk9RoMZ?x>Q;G6;T3nf3{d& z)DcMKz%EGu{old<-wWdZxas{{L9DEAAa3jEM69ImY;5#Lb^Nd439J&b8p^8;NZW`B z^hbr`GJ{B#=p(F?83G!D1a(TukJ;88614i(i^k5j^2IZ6%EhP|oHO{7_;Z)5V{!d4 zoO&h>_y<|nndj|sK5tJ?`0v22QZNR-Ad4|npmBPIp992M^DFC)IE!}x(4f~4XtS>! zp&|*=tNjQNNpR04flW@-=@@d54zN9Lje+{Q=zVU=8+imU5w!9$t_`Yw6xl6TI-E(WZMdd}gG6%MIa{U$ALLjC%|!B@^H%9tQ{xGE_5xcFRp?V5`k)hJJ-f_@ z28w|%yUcw<(mn{^PO$pAGt@pIeUgfzvSDGP5-iLkRAy|av@N&aP`DRoCt$+~ySql% z64sAzyvVPPenX%D7y)g^*ZC-z+EFJJ<2 zM~S!Vd5K5GFuw25t{P#ph2mTV4$Qt2ZFU)w)ri`?Dt5`;bM(=-gLJ36KqmTjs15B$ zrb%kOiKzX-Z*J&2YORsQ#WJnImewnL1Y{eAWGa{Vu5O=uq&{b1+!0o*Oo6D`QqK>3 z>w8VJR=m~*O?sN9{IKunvEkSSxEmwP9!rKD(;}^0BcDYJSUiKOhI+f%n$ZZe5F8|)H7!RJ5tLU_t|j=9kK!SOu>J3dXt4>1 zTw$>Y5$Or}6Jo^Mot=Zny3a;AnXsYO5#*c^%oF#JRUh-IyUtRr zocpLP3a8g*yvAKR9S`HjKl{A>=eO*AR;Y>BR#Qsg~UlaiD0Y5oEO@#+#F91BJ^2X>MFuw@ zSgI)ZEkvK0t>1F0Mb@2IoT6d44medSo?QD)hYyL?fXZ zR3&MWR}3pvP|jAXZP8eqL@gA#UsH^=UVQ;y4!Ne6xN`;Y9UMsAA~hS`O0+Xr*X$W| z=#7;#%E_gn7UDLxiq0m~vjEmA>Q&m59F-evZC+xTp$z7Fak$sxfrdDeoIY7&CSTpbQPdiBcPJ5WI3=IcBbP$fRc)zc<>j zk#vM{S?GLDQK78J()bMV-QHv+JvDj}W+Wc%u0{6JE+jrmubQg&4ka@dgt{3D9I%31 zw~zQaRiY4`@rSFIVeeQPxCU_ollIT^=Igwb8F*q#ayZn$gGf#y^d#dt^dFTLX2iPk z(~87c0M9=E_|$0)hfi0-Ve$K(4Y-P-$I=MVR#6u3?GM{#t!vqdquGtqHcW>+V!}$V zt&#fp>2#Uw@TVbIKN)W7T1jqx0kz$f0TrXq>ehl-|E>Wl#-P86n<2H??g#6-(EZ_r z`2ufUZZpph!EUHKxVa$r(@`l#Gqp;kctKgS$>t|*Q+l)~2K7c5N@;6C@h+F)t2(Bl z728ciPoiKsjlrX1fZxPL3xMYBz}<4uHT_{c$L8o8XI_J$dFlm=3y?8zr9QRkq_xvc zjKd_%0#yj$*yYp}yLRDk0SQ59i)X9qc!b48X_%du)CX)DN z*`WNaL&_lk#{`l#LvB+DKlQ{fVIm_NO62UtgDPLb6$W-TlIQl#nY8Z47-q&V3jmeH zjI5~745{)RN0n)UC8w(PSGk=QcZl}pb_ylUtUR6vJ0Z?BcB|W5J!r7JxKnC3x1K{z z*DsS1bIsU1o?_)YYRL1~9-wDmy={fttne(xobybaQN|&R-D`q&RK0mdUP#ArQ?ql8 z>$4|`gVl@f$$s#WS6Jh4nIm8TqP*1oU(CKiscygfIh#5?@Zy;!P=S}DBeP&6q)3+u zc`0vpDiAc-0sezM+V>KRyaJ|hOP{+p);Rk0onSl`bk<`k{?rYbCR4^OOd82`18P5{ z2bFmF8#v9&*cI`dc2C@^E2TFqRe>m_u7JZ8>Ab{N;fpj^rwlA$H#t5@Q!kb04SayJ9SPdBH_m*)3$@wquq8r<*WbBC{Y!PLkemAa|y5|Tl0 ze4op7f957TG{8nr38LTP6>CSNOnfX0-r5+hJ~sg|Zoku`hbs{?&vcX%W^S&#MWC+I z`?f3Cypq@~w{2W`pe|&J@>Tks63HC!g&Y@GM#wFph;^q5JsDCO`QE(rv)rM;X5+{q zn(DBGD1C;O(oY%)l?7w@y~Q+%L+U1QZ%ks2P64)!UCU>hr2ds%*Cf<0Q7Rr;C$uq3 z9&i&P-#kq9I)*)R{&*4W;vNjy?0x;dJGxK+Wy{|Lw@BkO^wqy{Xp^zTu2GJ*6DAq6 zn~K;qanCza?aE!|#aV60N$uE$FAHW2wR_P9I_--6ii>2Mue|6&GQJ%5 zB6gnNfG}uDvK_fgeHLC=>lyPZ8#Bm_z!SoRQz=pZA=!eMtN9lDC}kb(^!Y}Z{45H2 znsSxWemg`DzFmbrmZ#8fxDqeTu?CIxPA{cov08y7X-uq(ltE*dyi@jljlxN4qI8iLyoMiU)i7LbZ@Pfw%Ht1@*Zq~8at)$g0D;iT~ ziz@Nw+6oLBhGHBl6gCZZK~kF@ezXDmE$vZ`M~Gi$A{~#c6a!A}KmBbZ`FAtX{R67= z8x$j?^rwv?|IJ2MxhR3*V%_}!*M2)fLIwdIJ$Ad5-Y}^g>t&iyzL9WJyg#5A8$t^r zNVcWSOt$Ow_R)cZ6)xWoSZEIHHS&Ijc@}x1^p$~hM$s|Wjo$;c`BLl!^~pWG)62Q> z)|hO+#$3^-)b6E-2p(wBli`a@Xlu8cD0`AJ)>o<;{pzbJ4FjNG90vNOPG!pJ^s{!*A!j0KKm{V#dTwsGd&{TI5NO3ub>tg#8~cK z8CDQ`NA-h)=Dch{ya(p$sDTZ>+AhaHcQ07WLGFtsNB)|tz<#iGp_z)k#aI8j!(K#~ zui&5}3DZ4$369U;zf8nU;v*#rG!gpWO!Rxb$n(E2(ZBjg;V;(KZom(s`i4%n4sL%n zlS(T#GyETU(gWF{i(2Xv&|tvGXC;JWzJUsgw1Wwjk?!S^hYUp4IW&fy4z3s6RPlpQ z`t|?1Yo~EQ+8`h}cy%&MS{KEY9ZI}7c;!BuZF*G~+B z8W5p|;7P(u3AiP_Z__7eYs{DFtR<`D0o=eIO5Mik_x-d~E*y&~h1BVZv6cLc1K$w^ zwQ(t%O%b==GlMBd$04P9yIN8 zPg!U1i9+_27202d^6ZF~Hi)SjvG1z4VAY-;4tFZ1btw^6+l4s+8d(LIL)(~K*MD-| zlC)8Q=@NqllnZX+)e&X(E#qlrJk&1XeR@yYcII#;RRWJpcC*2* z%S!hTs%x)d{Rix%at@)o?=G+?!iKluVG1gu@)i1FKAu-1Q{vLN*+|oKB@{C)coRJ4 z{sa$oEYNJ&Wz(J_(s^PolP9v;jCo*&t`WfyvroKY_fa*D?7U5B0^X!SbzBcourcKL zE+Jo>UT+d|h(>vM@&{}E`yxANRG{x|{v)s__`mSK|AKIT3mX50-vSBj|A_43HQSH` zB@b@&qVzR{cnTllK1xi&0zjKYRCSb=i)e^nspYT`eytwbHzFm1AtR-qjNgrU*gBIw zyLvx!?Bbx#LtXYM2FH}Nc}b|-P>AWmL-HJc4$m4BZ`@ml zYWw6__%@(N)UNiPaHG5lyR#WvoUFVJR4#DL&lGuDW+2vk4NZU`Rn-!@_`I#u7F=k; z@nsTAMV5NYZN9+Or&K2~2HMD#B2!-sytLQ~l@}>2c%!l_vs7mdehmp`<{Hefz}g9W zmL$d6<;TV#V4B~i_W3dZBb0eRhPgWPJ5mz-$w%3@nGai5qK_?5yUbo&Rl?@1hMj0z zdaSf}9}kN2yD;doz+8PjYuV#OhbMB1$uqZkF#RA?4tQQfd_zT|3I^EFKGSnmE{SQ; zg}juEm57J3><#LlhqE|O7NZ&wEfCiZGH?Or#4`^p^rW9`^!(P4aGGL%g8d3H8^|jy zj=&HD`i~}N`Cpj$Um*tg{_7U+pP{8tdBtWK7+S*LgMPshgpxUDTlRHi*qsg+RH86f zh?Reep+xW!2)8f!WbkQ4_*AOvYhoDXZ7%*~bSY;We_D8~_%$OJaJh6e^|I3E?eP(o zA9Eru#83o7C?$@54@J4WR9&s6CkL#3Eaofz#U~r5<{4IJ&Dm9Rs$azF|yFd%eaau3Z(6$l~0;!rrC9xaF4CetIgfcfl_y&Q9AK1cg?2Z zFBkM!p7j!Sk}GL-=Zt1712xVN0VzU4vh3^h z;IKmF3>ea9^}Z8pu_41?r(uZEhwR^EX0Bd5Tk3}=$+gw(9}dW)o+M-CNc4xvU}q#w zw}S?fFc7O?win)na2#613M~C^=Jv$Jsto#DXxYn>Q@e+n;+DU7WSOg2+jG>KR#OQE z0m@S5V|r2Hp@~@v81e}N$SAWIG0+owVqO=P+xGp8r>Rt6wryyn#e6?W%pjgM&SS4mfBDv+9c}(wQsUbDxAG2Ne(7$KyY(p1oYNT=aIu87V1lLS*pFHS@8L#5*aXd+8 zymt!6@py_v%bt~dr+oD0&b@YGK07Y{azPHh_E1qw6y&gM>`8U(W2pQeI5_LM^emg} z@WjSZT6(6XPGe*YEOizM71~hqqoW6#%LvUn;VPrPWvq(d5V4}ieqp7OQArE6*N)IP z{zaKr7w)AqQpUKsK6CE!_j7_@K1u)alzAf7734$6}+k8 zw!lXzv}&~W?LE^kFAJ{;sIN=g#7Tsy?}3{_>^_U5587{QHWwJRwG zCx(eSHl00rYBzPm-bfBqpTF@VN8HC+Y?Fo*R#TBv)GhXzQ}5mIU5OQdu&OJ$Z|r zvS-BX4cJL*t>08k`?!(%DzkIOw9~aWg+srcP)P zxa_{BX>o?yx!<<(B?Z?uoqZ&I=Ia5s9p0N8l5MJ${NBG!&q!UhNb2sh)h@FIeaoM`|cnHVSQgT69^i zX{n4#_=HU>PL5c2N2X?h%pU(MYBAUIVg^?{Q;TWd<0>|ybK;iRndcvk)Yy6^dyA&d z+y7=37rgo&GxNn;zO29?Xzz#VtA_*Z5u3GJL@yxsRje6!IredDb%l60DVQnRM$H1mw*nGY=DM9Sd- z=QBQ!HOiMSOUbM{zw{JsZT`Shf+qDfcP^Mv2l6^hi9NOLTGIYO-+X6{a~Cb}JFi~D z`=T(hsI#m?a(Ytc?2lg>+Mj%Q65KGSef7k4N2jQ-=`Sh8rkZj4!WE+z@-|&qKSAum zp%~v??VFyK>zt0BC;05<$sGQ)khZ-yR@Y3Qs4DmP1w~s_UqSoOmF&SEU+Uayo)P+@ zfam)giI&%Oj;HqvrnwAv8}QqZUiPb0N510aw#8?XoUO)Zk9f*|`+K=W#rM4?9V@ba zrKorAHtSrJvHFIBphl!@^o$`RtJg1EY4EdP*%vjxvqv3%&xu~mx7TTL_}JfzGZ=$D zUXi%d>~QKAL+97r-+J@TKVW)BU2p(h;L@Y$%lr$rQh4%IQiGJ|ri7`#@sK@sSG!f__jp@)RA0T+-tuO~ zIFtKj*9CsO&DTGEpx#2z^Tx&tC*Hogv_NC4&)oZGPh6Qep8hbaFm^+hO%l(ygU8E8 zAH96Vp*HO5N1clnL7qk$sZ$f59u&^D-gsg1v_lVLvlLgzYvo4Tj1aB6xnCevrg{Ap zzxTqmuQ$Y7mA~7j_1t4nyy^27CS~=H+{RxGi}@HjeAs?#rRCwPO+x2V4{Z?B+P~Gx zB5|~ryY=W9yGnUV<}66dT5LAx-7Ep|cQa2bq#bXbCbl?r*NeuK1yVr{8(ln>+U@)~ z=&X3FPUw2YUB|sbzVFyNxk1uv!l@g9bMJe333t4+=m?r79I~k;U2Z`&&!@es)GZ2( z>3g2)l{rcW`l`Nc(-j}9x&kc^r$t#BXjoDq=S6oV&*S| zD=l26WJv6NXmwcCedZR6Pa)>(l}v8Td?4MP+<0(2Wl3%9;z-w%uRe&+lS;FosZ4jC z$bUS`X8RVGP1k>D2Ba?;VZp28@Z50kd?~)bZx7e5brihxOV{MJc;K@bt(%{NjMdWy zcq>17e&NRb6YusNzOdijBRt8vl{R|eDjD}fMP{+88#Ne5Wi(f6-4{p-S2k6-<8okd z+S|)QX%nWu(wkL#UvC0q>%+*_yN4$~PE)Eq*;;3}zn}~r`k8w~VbPVnKmEtaKAt6L zC)jE;vqa3KeVWzUR%=5qX*uI-XPWn=n@xV2vrwbtrtG!%SNF%p-%4!V_GE6>Vc)A3 z)#B|Pd|smyr_=|%%wW;KV*iTDx7u+|8@R{Qx$M(*8; zORAsEtjE;&L3kZoU(p^y+^Hi(Y*>KtL^fOb~aYc zmA99pO272kZ$}HSOQC(9a6#c_2=$pdY>JabtYZ)*Ab;tfaY9hiTpPY4=ti>$yX^Qu;rmot0%G zVTzf@KP)ez&VAeRK*?bJq5XCSUXLmYWOngA@@k5bRQSa^?|}W@w$8(6i&m*_5xdnk zq1D*>eBrT-Yn8N3v6~N#uk=-Es&c)TGG-(F=CWEj`tjtNfv2~4O_*&x%)r#PeyQml zV^Nh~f_LPG{fOkBlfdh-R!a1Rt*N?ktW*ZgbiV&_kGx0zwc)(l(9!G?IVy-t5?0&JhVJAD#FgWt(K1j4w{V!q-l19Clg7VS<=j&H<5$|=zKfB%dsge!mYX)hI~Q-JXI;w> zH7$~m8{;j|;Vx@3meud~x5_^FICtoeqJR;{c1(!(ktcT>4EsY?9-+=|ArX4!bBfwDBvrrf-V$0p)r=SyF zxJ=c1Peb9r^J|-bdDZ&V$QznBMBZwX|7qUv?0TDgu~~y#(tl!~UDF%Bsh)culQ#W) zjCXv3-d>T90tuBXhHI-V`a1J?aDv~!mA)<`=DFou6jhqUcs}-;&Ao>7Sv;O?Uv3#C zY#ZVvdr_v^Az3&>PRdrNPVeZpS&Ql_4NXoS>y(q#h>Q!F_*=_y+q9`eKaL1LE7h_> zefCqok0072zYJ~DcPJ^)j@@}jGv@lM*`5ZXM>IWMDw;)d#J$H~%pC4=>1F*s#R;Fy zcSoIX9&e;KF;QekUi}x1T;0W|4#?UV*nZJFYk7On7=iHD&RJ?nmJ|7>9b3T1c>OW< zmtg!CJ6+*(DdA@n4T={iUu&8dd*J%eX2%pv8 z-ke|6>US@?)SZ7~byoP0;muiXX&2*ulzV?_oFaWL(WPR=>@Vfv!xlc<_g!n{uyYK{ z$EMrVpN{;+6Sd{!q=TKAll?}wzumn}q?l)>JoWcVzArDGF2DJB@z!&N;>1_wac7pU z$ojz>BQkV^s=Vk$A8mV$^^HeX-dj*Q%to=(C?UZmnEqtgxLu53txGLYU!x6o`bHGL z5VO^He|ap$W!6I7Tl%+kQdi1%`UH$AnQatXmo~@Jy;UjkK&7hiX~{V`Cykr}H-B;v z54=4pFurw;oVEGEgNZGH@h^?9s_B3B-gWD_XWfuVv$QoUM{4mmSY4g=>S_a3wyAvZ zjNPNN)pr{3rP^y!}bCUH0~v#Vx|>hWiFj+qr5$yko(s zb+lz``Si#8D+m^9F6CFv`|NF9ZdU!?K%>fQ_SuB$@AB%+GwK9Ns&8Ai-5s8mzsx+t0o|GqK)zmOY4%u>Py76zEF4V!#e&3oYqv)!wrBae=|xKs1a zx6y@tGDQUlX~!~{@%KR z-TW@J9V-RfpS>}=(0G36+1mXb`BqBeo;M4Ypwatc*D~b0vo1%nk%5UdAwHb z{5GqKGvPCy7&#~!&8Sp19kol2dbI7sv{jQ^=b7h@81-(3PnmJNJHMJ24z7aIG-Vr4J`Iu99~#HMQn2#J2tEbV;VmQ8;(5QunhYqe9;B6(N_ijuS^dH6!-4rh zDG?uyMV5I)tzY@#=A`LIPc_yA!o3xzRLhqyzj#aT5e z6qPr{d3BZ9l_82RRwc+@aZh<*zvRgoe|6twWzk39%PeY~mo)JDJ^QxjpB~7T9+p2; zJbH)1^qC9&6}R583A!dNZIWth(5|pR?`B?R+-=NLec-gj^Lcybr|V8G{%6)nz2GZM?H zpFY0bsd~gN@4oi6Nq)3-sdJ1bwR~D9`gBWTPMSlZjrtw~jbqSydanLR&f)s>qLe{h(e zv}0RKnPbJzqWIFJVRt@$G~DrY_?d`ZYLQVq?Z@UVC|xNYZ+&aA%Cw1l^lbNKow*XF z_0v7%MY;W{r0+g<8^o%cpD*2PaC+gglU8|Wj%-_D)_C>HkxzGjb=|~Zpqx6z57r3J zNwBUHvd?1)Z>(gS$M$rW$y&>aN%MSobcCuKzrVcdXe0a%n!&2}RVG%$gfF;`blc*8 zTgUd>x9yL$Cc7vYXwTQS30PPtWHq~5vt{PFh%Z0e{~PEU?Y}8+lwU>u%a1h&9c2o( zo8)~oIJqLz_;}d*rTp~#9ka`7@2^X1I5c?A*fk>>-c!7z7E22iweJm?zDwrHy5D@` z#+IcvMND6=Y!IuY;q>)D$$EabS>tv|iLLqhC2*&MxO=C{Lu>bYi6w2jw3-f@2ru24 zxMN1?=}nup9LJmd2G_fDbmqG6ZembbO?4| zH(7s@N?w`#J=uJHPrmwj>#sj*jr?xWs2~Y{JwW$!J!+k6;s`}2mzJ;(UtHnlw) z{07dt83>1e;r zRGIcc)2k&j{lBk2A14jj&swF?}94lsgifYW2ee#a4RitVCn;+@YlQvo0e0lcLwmN~@6T;8$ZhN?* zath}T6@g+u$Js)Nt$~9i~iHrjC&>>HvZf1d3nx` zW>4jgN+nlJsN6^MALDeSby)iDS1t4M^b_rs(l=^tczs$?(eag){kd~r%S7ESDJ1A@ zaXx9hP}$^M^w3o{D|b3cG)$=vQC-dZEj3d}Sarg_-D~4jrE7Q`D@MOsZZ0)q%n~7K zEuqe&Yvnw1E9=r^W5hk-DtePd3uYa(dt11& z!d^SefSI*(I%_*$h)FX(%qXCoDBPhp!Fr;n=HBR| zakICte4is3a%Ej^%f%})!xFzbJe+$rZc1l)M9EynW+gGx6^fz9kGL&fw5DkDy7aFL z-!8fJBtIke{mC=$Lu2j+jhi*}@#l4y&u%;*TUu>>KwrUDdw%lK;sq{?8sXM%(Fbnk3li z7o|i09d3A4Gil|MTG@<--P49!y?UXR5f}feS*=k!T8uY*nt)r5yY}m+QRC7?nyt$3 z%{-M8-L(H|v+FkTb%l-8>E|kHMC^u%Yz$7B%j@!V8@)|Mw({r76YX7@YF3f!{aDD@ zdR+@|19(PJ@B^~o5?wDo3Y@*iUgiciIts=XhBJQGp(Ka@>9qK)N+bB^=m(wQ?R%kZ z0=<7~u47?rXkcxlXl{ro45M_P>1Dr25ca9EylUV*Gi|c|l>*yIU?G;jp-|qk{1r3V zvi>#u1tcQaUrzuPF)^8c9i|G$PWzZ7yF2TMS*Cf>jen^MbBxuIeIexK`as~_Za^lG7BSm> z_n$e{ADxaRrn|uPi+Ub#x(uiw`}e&RVeyNEE;CgyZ(x?RVEDrYk)Cv~&>(6Eo#Ain z9~?sUcc=ASb;>FXQd-5AA3u(PFt0!uTxk~IJtUwOj1amf-Mx!`kM4~9-5BB4ArZ`L z#@TUZUmCm95O4+qj$xl<@Xiw+jz)rGLk;$UQxon!x}kJm4_c5U`v>?v$LyFv9-~EG zfI|0!LeYM;zLx~ltt6OCh4z>VAxJ6{8|*>0_lG?Yc^%-g=#K2Z7Y$;lANnL`rP*aD zUcEkQ1f&oXu!d$I0K8i!N{Yea$dWAY$+d+N$1z9qfaiep8tj42w)DN4Cy^p?dIH;p zr0nv1sBWnfL^gpR)jkM#ryxa&VjUVl3j!!Ts;@82!yw$97Jyuv(<;cLZ9eesxDQ@7 zas-945JSk6CPm65+X58I zn+b4De;;Ldw;B>XiGo?VCf2XD##b{L;8_!R#`9aA4JlcsekGZ2kXIAa&%LT^hxRW1 zCD*QB`ecU8(RR{h0Kv78F!3-E zb?BEU>G+JSc(u(o#|FGCVJn5Agt7bF`A;d6D|^S!AsWMg?|~37Dj4Ic|TsK@9Cd z>wv_I$7Nm)DRI`JiMjijl`!IZ&Ky@Zo}6hB3K-{`Fe z_G>`lxC4G_CMB&4)n8W$*nLZ#wtV5nk(+eIzB%S*A$p(!FeG z;UQeA@x%V|dl`VV29QiJLEOLm4H73fd5wv@YhBf)aUN4Cl$%T0D*}^mq_|8gaoPlx zt&++QAKn44x&g+=3(5g7`6L-znU2~$dFiKQ^?7P>6daTi11P$fvgU}9BCv-Y;namw zBBUgS`MikxV4PMk4xaK7#7Xg(O5!+b&hBK+gX}KP0qSV>YKloyDM3p8kEH2Gjms&M zhK~Z^$6zSjyF;gv0yD*8MkwI{2zC)20(G@fO>_pbI@`e z#baR3^+Sw3^-oYEMc`DCWKWZU*fd{G7kq4mw0}baE@QTwX9boR@L}5a=B7K zUlqa+_b6F-ga%1$5YboRq>nuIcW&-#X-FdIkRm<`AGQ5c`duY6Cwb(sz8ht|+<^UJ zP!C$Y?0cy!B_&T_0vLrY>Fyz+K~SHQw#AnGa(EpI4VTH_ySTl1oJhe~@<`8<0=T;F zq*d>i>;<2?3_{_x`9p6~419#-)D$wr#)<#6Z3n`KfiNBucb1V7W*V9aAj$l|hU!HO zL%VWq=moHXJU|)sSp(kP^z9d>$6qBE`uA3ndfrrjFPaDb;1%|yB20bv`#i|y$C0-9 z{7FHXGXrdHO*BnFeirYhp|A`xO3Y;TiR$z~QiMKbbzLmOsW4O$r5JZyN&sbD0{(HQ z`mmamGW!tU&uE_PyWQ3ef^Zqs+jueGxP}yiGfFrGKogzVjVU5ZAi!t%!5dP$U;;ss zL0F=KNae_3DF*S$+2A)P;YShkBxzX7A)(7uIeP38mEQZL9(IR0bosu>4N$lQOjK<# z+LPl*X>%%sr0r-7owgtv)z2E3TuyiQ=F}TrnTXq=Y%W=Fdisdvyc(hJuZs!we7T_$J_7MWOH&hU6`l33#+ z2;5#m474`;;muqCX$14&Mb^BZq(FoPV&8*$S^XCI*38$2lZC({*Wm{j#(V$|nJ~=p zfEjzezGmPb!n`s90Wmj?Aj7bzi2`d>EUy|KLZIbz4=-9s*FFyB)(AwW#r@ccMqoCK zqsQ}`D;>SipkM~`(s0S{0)3%dFf1_=*%?L0CEMcJXhJXyY>iI>jRte$*xEga0gK2% z-JL&p;tjEN{Z2n!atefSg0zkI;BN48BX0m|G4S-Hx%b?9PfT6bW=G~HVBQf@wF!%| zVeuX0A#lESKXP3%8JeM#4PXufOrlRh+$eKM#Qp(s;|k4k7Oq;E4_$W( z+J$A0K}HMz4PX6=*Hb&ih0;n`l0$!?CjNyt-hi(*&E$q62(1u|h5=8g+g6R$fAECjK_FuWq8aW=s zUcixO$B*L*%;v(qQWBMwNWw!IxrN3coj-u#!(he)Zb0mjDB1S`u}>ke1KysR_duNn z0H}=_a}g|5a|uiWb)qoUrTY_(R7iuoiP@`FK`1_O9K5bg73YdYra@x=l(DQC27@a_ z0t{u0iKHa)H!vLjX&n;kMy|<}!KJU!LnYpVg!&k4>J+Z9SbmmdOV{AEq$#_gGAtI2 z2FZ|AaYu=gMTbK~8M582_*P zPD7qHgwY4DS2g6gQpc1>OuId)ZuC(w2%2N!jTn8)E$=mr&TVAh=3ff!(d&W}SjVD}whcf3Acqs0xtiWbZW4T2UCYZ*lh(JH@c zjxs+imcT>{pXSci;RewUX;hL)tXAIk4eSsE#>drDZN`mspPl*bgO?2@%Pz{dnwkB^k5hSXhPP%$|_hP}t$e!Kl;Y z;Uf+LqgBAD3`XS)7b^NRw@@!GI|l8a#tc6TRENO$2h)F+SD7O@Z)OayB|&t;>IbF& zdzyEKYyz*Sg~=aI^s);%Q5(8nw=OwD6V3MS`iy>A3h8AXbQ18)oaaSO)H;9~6im|z z3Zh1^n}~I0=4$k0YB;nhXrtNV{#+nAaWjU$7YhI<-$)r%$7yORKw1gXqBM(sVJ#dM zehG@EF6)~Gh3Zk=y-BKSiD~nw-yqC=1lfIId@MOloe+i}-5usBEL53(iZsm19PVMX zBtoiGci1=|On0OE(nBK9bQE^HVt$LL&NUh948=BO0r2a~3PH*H3#vM-P(7P#(K>O@ zfJpW=ltXwDVHzEAwl400Ks$_%XgjnY#+k#GKbMybx*yKS>qEqvw}j?&Enw{-C@uhF z?cLV@@2uIG{d;Nl={Eojx(6hAS&Z<)#C-|0?NBqhc*} zcYuK!;0Lb(cft5ekg&VVj8xaPhfz|W=FT8#zxv2u7uE*eXK{?-TMm(v?z257!zd{H z$I2Jffe|8LxYcKMQi@bAIaMrg>C=2^Uhs6nZhLnvrRc&b4zjMp-aT^4)qvy*=Evt1 z)T88xeJWb$-}3~-?p`LdImam;vWI$TnM4qXcNfZj+~8Xa$ia+g!Dw@dJ}m^gjf|d# zCNV(O+Ll``C>p^svY7rnkCOxRNked~0h#4>^5-S6v`4W4V|!s_#Y)J@{*hS-|50}v zuGe;)vZA(1J-zZ|H89l)3dPG^W7tPd=G^9R*oWcI61N8KzEnDilOJ`+G&&6A&w#z~ zLM^cDFCaMiN6z5Sp6)agbxgH zc9`*w!M+zVJrUZa2bl1?p8A9=&a5Zz^|k|P2SBdFQ&D9VITuJiqaa3T09p1%j&Pq& zy@M(YJs^)OGVCIE(%AXQZV1C5Mnun@xa_U(_Wxeo5?Tt)eCVp+a{?l@i9l-LX0 zTV$3wKv*$`Qz&q_gyj`Ib>RQbI=!)k{DjO#C%4Z|eGN(!fcjRRg%b#R8FF4wPB#vr z`H`6j`QY;-Rs&)|%6yph;QLkbrjt|d%S(N$`ovlcIA+#*7+e7P`FxD?6eV){IOme6 z74=6I$u{TLk8cA?03hP+g2T$>XoTaoB-^K4YX;=(E?E*+(Hg)BuoJ#HrbFc~v3m;^ zPMsp8`E50$JplH`vVN!3ltz;+W%!hV?-FETjZ{aV&Wj zIRHlj@3vcCTIZ@lgqxmqaX=CX77NZ|i#bc8203nbs^ussyU;nl>z4ON9H**TKIvCPYUuN)&j7C()Qm5C zxXmNS>{g{;05wE%fnMJ)5(WB zHiEO_JKG2 zMb1W-xHj|jGZ2SJEMKpGE@HYd#E{5Mp<${kw5#4hl*}d|$&>#KwCo|y*%9T^U1J-o#RD9Y!+2c>}%p(Xr zlh_%zI~y3G%}PQLf(Dpy8@$QE*s8SLuB_T+N`k{Us0WaIambHTK-LhfhA)H%`jeCGjDMleD10+If%XKAeoV~vs!``)^jLFA-aA{fmJ`hF!J z*j)0S$(Dh_M}wB|lgSC;+=04d2>pN8L3U3@kRQ=@I3!Krm03Swn=-`=%z)Sbxe?q! zdXlP%8&n~GB95LgqXD_^e$X9W^_*D29jRNKzBwD&eA7wG>Ki)wF$v<5%~PZP1c4-F zD>W~wNe8kgKt=jk09=mdPL^A3O}6}kj6yeiBfk<5g*XuJ#*ibj#YWfo9@ID9BS#~R zm(+8s&0$9~M--aom$WgG;h}VZEo5(415e<|`~7W zcLB{7Awc~ks1Z*}UR%kjqk*)?`Tn@|qBidSgJFQ841SNV*BPX8LF(%c^Z<5ueg9@U z%YU+9!y||^E07bHu{Mny8ELRP9sYT3q?#X@42zGHvyc|?#5*GWPmsFrhOwl=JuxJk zo_8Ln<*$X|aQjp!Y_aUYn@NuFm(>ZfDRD>~A0$Ed2LZoB?$E{Hhvt*R6Z(9&IeRB0 zoOmcbKV4&)bq8=zzYZ_1TMEeWy2nVC33QL^aD3ixaow4DY5i$f(Rw|e{p5%y++;$Q z0=kEXp5mrYFtTM_X-tue&XN2C`lUSv@edpSto-n7FL?M4tH_XnA4fAVI0hJL}pMbm%rg40do~O3!ckXCC@op4bh@H}D{q)DuVC z&xOqS6NX$*jHSkR|HKj&4LCUSAlPqLXEf#<4OGEKk>wj2%b1D4y1yYe9rEaobQPy{V7hHkN!VcQ&^rE! z9i$2pk0y?(Z(oj#y$c*<0tZGI2R^_4i366Ed&2yU#HJ4vT3H65FkZ2pl_~xGPoS(; z094X8zB+H@aJ0;_5VD9HCT%O+4*d@qghg81`dwf28zvtz2F`-Bsg$dbQGzgj!g>CQ zA5Qz@Y_Wddo8ZaA#b!k(jSjq7!7))+jK8))|HL1wp>WQ+zabs)Q1E7Lzq}UBk@&z@ z{V;Cc@c$DxtlA(;EX-&k59BV^8rGaW0jzE0VC{$CKe5Io2X~!R#(TKj3YX){Xq}IN zwN_xw1=E@d^jrVuKF?iGM>}d)K~s+s3Y7yDW2RX6pO`@=>~Hua_HUGkOb2-lQ3L-z zI~q0(W9*cS`6qT*{hKiTA!o6ccCUoB35t~ePSY>2G2k}O@xq0w^iRCtnS@yHKb!|lxeNM6cWnh=dY7K}PoV62 z$D@TH)06cOQC|6c=v^M-?iFxH$GFRw|4-cgP0SD{S;W?=Wv3MA;H(26=bK_|@#+4L z*dn&p(eu;iqkV^Q5TUrW-WdFkfP3QA|94)PR;#k)<4(3Pw&h)AhA}CJ) zaVyk(c<<_z2RY(ji%mLYq5yBWF!Bp*x1r31-SW6e#pvWbbhp#d{xPD<{1DxDhj%pP zK>TjtNE{8mrsM0YM-2$>U2P}!rFm^jj}}4F(1h|`2J@wl z407N;frzP!JHBu$fKY4)RpB1`eK{AZ_=cXI>16NP$wzWw z0#>uSkr(I@3zxCt(V*QxR{`kiU@BX*lAJEfN?@-lJsqmm;58aMm*%DX9EhXc(ZL;`WQ`)gj|nh zy_S7{F!!Xj)2~Cg2!v~cAN;Tj&suUwc3qO}$uRqPsKyZF83A#u1OR=nk?Y8bBYC<2 zB$58mJe=4rM^&dCJv(ENA8oP+sFj0!%H%jrpn_!$3P+qxW zkcZ)*16kYSAC^#=+rJh7O}NgAQvoPNt})c6ZUAniU^K-Sr-vnwbHgS5L%QTdLUK== z9V6icMzn;XZ5AeX$7XV*zMRrUXCX|X2s5jhN=f_igo9|YN|@>onoI>m$#{sb4qy%oq>hBoy1K$(kgdkG^a z0_U;(;fy0a434+r(+w1eq~DS|lFaAa*{CFmfs#ZW6Q%P6sVJm4ed=Oexvi$II2#WZ z$pRdF!Tjv0zsHd5o$`^gK`ySXzJGo>DBTr`786X|TX5ScK~h4NgCfWip7Dp80l__G z1=2R>$HchEDGPtdh~5Adc!COaG29{NNpVT#>vd0aE0Qgp3awV{C;-s5etf7ht{}zZ z6o}ZKTJ7=kLqUmmA(-*z*VXF3AT9|hloOIzhbZUm3O+a*odya8xfWwOJay@BV99MK zY0ZEG;~{YUI!SK7GuCc+0YLwRAN;Dts=B{nfuIIJsaHZ~e1kSf2v_*9?fJe@PfDKD zOM2sk*oqz*$^&kK9H9V+FMY1M^7mkpq->BI^y0+fk|-}60E6NSBR8)80|zX}>Hd-# z6rri2DK_Yo)DmDu2lKAi*Z!Uv7G8+8UoZFi$$tPB2{D9k)04VM3db2OU2|a0kCD!a zS}VxOF7C37kp%~X2^!l;)6Cm{flONenBMg|IRhj^H%J>|ij=zd7xX2Gr6SfQUrESX zxOSa_j-tC_n3wL8Vv;(EBx`;p{a3hOla&Whqp`f29};rI2APq;{l^lZ3Wky5f&BuuT`pA`N_x;s9j>`HAiYv0_N!*dB zAIZ?b8v)M~#H-cspShx$G2E%XxFq^EM`lnCX=>=%!cEI}eP2;*0fyoCpa z5tN8bePcp!*#o1uByM>92W9}{ChEouE0kIzj4O1uoBdBnZw{6!~cqYFA`kY80t%K&m;=7DNnY|vIDf8 zAQ5ix=_9$Ku^OW{F>x9kNfdN^{rfPWzZHgJ+=X8XbH!lS7{Uzlr}~mMA`n`sUBFy) zu1^~lx*2fP{YLUf991!1)gC;v!I#hV^3x&|v0hbOTI$t<|Omy4R% zj6zI(@M8yRI50g4QX$Sb4W2m3g?jhhpJefevTWwgF$+6D@jNi(;NCPF9$~W_g#kY=W_WjLSuO71*4U_!+@rUdDCthQ51m|1{KRmjx8O07-x|iCiRLGqmIqMi5-~Wfki0k1C)(k;ulf@KSbFxNV>fUKE?*~Xtx){GJ z=X1qi4X~aEqjg6#8ePeIwu!cUk~F~k2FAd%Mvfj=Ja%KCUP&myBpT&(y8)lVZ9r+L z$%uml8FB@|e3na6M}hHm>o@7wpfOaR;b-Kg!#(X>+^Q!G7y5U{AgBv&72|%XfOm(% zQgrWqK4{GVv(g&ley|9t5=mGdrqRQ|mC@aDBsas@Jf2lS0nyOoFmUk}m~n;V>KMdM zC^*<)>=F>qAH>5eiehuFSnN(g(DgupH0OOGtr_HiYY*7y`&j-JeS&AJBl?0)F{jo7 z{W(BiA2ZKUE3Wjp>I&w+q`RE;vtR1h0ip_M44(q;v*C(JoH={zR&E|ao6&GB1SBkj zjvsENCR?tU>{e3g^8#k-L z;r&DPdGVjR@Y+K~F;O5IIyt3=;Z;WVkH-`Z{!6^Xj6_-xXm1-15Rg;ZdM*1`^$*c4 z60uzjlvAhpp`E4@?A3Z$bpMolm?tJJos$>$5cFXIw!o`T?alp@?y6dD) Date: Thu, 7 Feb 2013 10:57:54 -0800 Subject: [PATCH 009/133] Grab app icon without assuming package name --- src/android/com/google/android/gcm/GCMIntentService.java | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/src/android/com/google/android/gcm/GCMIntentService.java b/src/android/com/google/android/gcm/GCMIntentService.java index 0252472e..95f40248 100644 --- a/src/android/com/google/android/gcm/GCMIntentService.java +++ b/src/android/com/google/android/gcm/GCMIntentService.java @@ -6,7 +6,6 @@ import com.plugin.GCM.PushHandlerActivity; import com.google.android.gcm.*; -import org.apache.cordova.example.R; import org.json.JSONException; import org.json.JSONObject; @@ -128,7 +127,7 @@ public void onReceive(Context context, Bundle extras) PendingIntent contentIntent = PendingIntent.getActivity(this, 0, notificationIntent, 0); NotificationCompat.Builder mBuilder = new NotificationCompat.Builder(context) - .setSmallIcon(R.drawable.icon) + .setSmallIcon(context.getApplicationInfo().icon) .setWhen(System.currentTimeMillis()) .setContentTitle(appName) .setTicker(appName) From d5f78d02e9b02ecbe817aa17df91ef3774133ac1 Mon Sep 17 00:00:00 2001 From: bobeast Date: Fri, 8 Feb 2013 15:38:37 -0800 Subject: [PATCH 010/133] cleanup construction --- plugin.xml | 1 + www/PushNotification.js | 83 +++++++++++++++++++++++++++++------------ 2 files changed, 61 insertions(+), 23 deletions(-) diff --git a/plugin.xml b/plugin.xml index ba7a64dd..99afa640 100755 --- a/plugin.xml +++ b/plugin.xml @@ -3,6 +3,7 @@ xmlns:android="http://schemas.android.com/apk/res/android" id="com.adobe.plugins.PushPlugin" version="1.1.0"> + PushPlugin diff --git a/www/PushNotification.js b/www/PushNotification.js index 77121cdc..b7cf5af2 100644 --- a/www/PushNotification.js +++ b/www/PushNotification.js @@ -1,28 +1,65 @@ -(function(cordova) { - var cordovaRef = window.PhoneGap || window.Cordova || window.cordova; - function PushNotification() {} +var PushNotification = function() { +}; - // Call this to register for push notifications. Content of [options] depends on whether we are working with APNS (iOS) or GCM (Android) - PushNotification.prototype.register = function(successCallback, errorCallback, options) { - cordovaRef.exec(successCallback, errorCallback, "PushPlugin", "register", [options]); - }; - // Call this to unregister for push notifications - PushNotification.prototype.unregister = function(successCallback, errorCallback) { - cordovaRef.exec(successCallback, errorCallback, "PushPlugin", "unregister", []); - }; +// Call this to register for push notifications. Content of [options] depends on whether we are working with APNS (iOS) or GCM (Android) +PushNotification.prototype.register = function(successCallback, errorCallback, options) { + if (errorCallback == null) { errorCallback = function() {}} + + if (typeof errorCallback != "function") { + console.log("PushNotification.register failure: failure parameter not a function"); + return + } + + if (typeof successCallback != "function") { + console.log("PushNotification.register failure: success callback parameter must be a function"); + return + } + + cordovaRef.exec(successCallback, errorCallback, "PushPlugin", "register", [options]); +}; + +// Call this to unregister for push notifications +PushNotification.prototype.unregister = function(successCallback, errorCallback) { + if (errorCallback == null) { errorCallback = function() {}} + + if (typeof errorCallback != "function") { + console.log("PushNotification.unregister failure: failure parameter not a function"); + return + } + + if (typeof successCallback != "function") { + console.log("PushNotification.unregister failure: success callback parameter must be a function"); + return + } + + cordovaRef.exec(successCallback, errorCallback, "PushPlugin", "unregister", []); +}; - // Call this to set the application icon badge - PushNotification.prototype.setApplicationIconBadgeNumber = function(successCallback, badge) { - cordovaRef.exec(successCallback, successCallback, "PushPlugin", "setApplicationIconBadgeNumber", [{badge: badge}]); - }; - - cordova.addConstructor(function() { - if(!window.plugins) - window.plugins = {}; - window.plugins.pushNotification = new PushNotification(); - }); - - })(window.cordova || window.Cordova || window.PhoneGap); +// Call this to set the application icon badge +PushNotification.prototype.setApplicationIconBadgeNumber = function(successCallback, badge) { + if (errorCallback == null) { errorCallback = function() {}} + + if (typeof errorCallback != "function") { + console.log("PushNotification.setApplicationIconBadgeNumber failure: failure parameter not a function"); + return + } + + if (typeof successCallback != "function") { + console.log("PushNotification.setApplicationIconBadgeNumber failure: success callback parameter must be a function"); + return + } + + cordovaRef.exec(successCallback, successCallback, "PushPlugin", "setApplicationIconBadgeNumber", [{badge: badge}]); +}; + +//------------------------------------------------------------------- + +if(!window.plugins) { + window.plugins = {}; +} +if (!window.plugins.pushNotification) { + window.plugins.pushNotification = new PushNotification(); +} From 947468be74cf8536af9ab23e8fd62772757a2761 Mon Sep 17 00:00:00 2001 From: bobeast Date: Fri, 8 Feb 2013 17:22:33 -0800 Subject: [PATCH 011/133] Remove old cordova alias --- www/PushNotification.js | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/www/PushNotification.js b/www/PushNotification.js index b7cf5af2..9bb6d5b0 100644 --- a/www/PushNotification.js +++ b/www/PushNotification.js @@ -17,7 +17,7 @@ PushNotification.prototype.register = function(successCallback, errorCallback, o return } - cordovaRef.exec(successCallback, errorCallback, "PushPlugin", "register", [options]); + cordova.exec(successCallback, errorCallback, "PushPlugin", "register", [options]); }; // Call this to unregister for push notifications @@ -34,7 +34,7 @@ PushNotification.prototype.unregister = function(successCallback, errorCallback) return } - cordovaRef.exec(successCallback, errorCallback, "PushPlugin", "unregister", []); + cordova.exec(successCallback, errorCallback, "PushPlugin", "unregister", []); }; @@ -52,7 +52,7 @@ PushNotification.prototype.setApplicationIconBadgeNumber = function(successCallb return } - cordovaRef.exec(successCallback, successCallback, "PushPlugin", "setApplicationIconBadgeNumber", [{badge: badge}]); + cordova.exec(successCallback, successCallback, "PushPlugin", "setApplicationIconBadgeNumber", [{badge: badge}]); }; //------------------------------------------------------------------- From b7a256917133385244a846b28c6f35688e2b2af6 Mon Sep 17 00:00:00 2001 From: Bob Easterday Date: Mon, 11 Feb 2013 16:48:23 -0800 Subject: [PATCH 012/133] Add flag for foreground vs. background for iOS --- Example/www/index.html | 60 +++++++++++++++++++++--------- src/ios/AppDelegate+notification.m | 1 + src/ios/PushPlugin.h | 2 + src/ios/PushPlugin.m | 9 +++++ 4 files changed, 55 insertions(+), 17 deletions(-) diff --git a/Example/www/index.html b/Example/www/index.html index decbd60f..0fad81ae 100755 --- a/Example/www/index.html +++ b/Example/www/index.html @@ -4,6 +4,8 @@ com.PhoneGap.c2dm + + @@ -14,28 +16,51 @@ function onDeviceReady() { $("#app-status-ul").append('