Let's build a Firefox extension with Kotlin

Send Notification without Google GCM in Android

Currently i worked on an android chat application and i need to notify all activity to user using notification. But Google GCM not working properly with my application then  searched for other alternative.

A Google GCM/Amazon SNS alternative using pull instead of push.

Main features

  • Independent user notifications (no Google GCM or Amazon SNS), just put a JSON file in the cloud
  • Framework will update available notifications automatically in defined time intervals (now, daily, bi-weekly, weekly, monthly)
  • Flexible parameters:
  1. start date for notification (distribute early, show later)
  2. amount of times the notification should be shown
  3. interval between showing notifications (always, every day, every week, every month)
  4. specify on which app version (versionCode) the notification should be shown
  • Show notifications as AlertDialog or Toast message (defined by the remote JSON file)
  1. AlertDialog: Specify button captions and actions: Open Store-Action, Open URL-Action, Exit App-Action, all defined by a JSON file on your server
  • perfect to inform your users about discounts on one of your other apps or premium version
  • pro tip: as some users don't always update to the latest app versions you should integrate this framework in an early phase if you plan to use it at a later time.

Download

Maven
<dependency>
  <groupId>com.github.kaiwinter</groupId>
  <artifactId>android-remote-notifications</artifactId>
  <version>1.1.0</version>
  <type>aar</type>
</dependency>
Gradle:
compile 'com.github.kaiwinter:android-remote-notifications:1.1.0'
Direct:

Live Demo:

How to integrate

You can find the source code of the example app here: MainActivity

The easy way

  • Call RemoteNotifications.start(context, url, UpdatePolicy.NOW); in your onCreate() or onResume() method
this will
  • start an update of the notifications (use UpdatePolicy.WEEKLY in production environment to update once a week)
  • show due notifications to the user

For more control

RemoteNotifications rn = new RemoteNotifications(context, url);
rn.updateNotifications(UpdatePolicy.NOW);
rn.showNotifications(); // if update still runs, event will be queued and carried out later

// -or, register a listener on update completion-
rn.updateNotifications(UpdatePolicy.NOW, finishListener);

How to build a JSON notification file

First: You don´t have to write the JSON file by hand. Just use the API to initialize a Notification object and then create JSON from it: NotificationCreatorUtil

Example of a Toast Notification

[
  {
    "type": "ToastNotification",
    "notificationConfiguration": {
      "startShowingDate": null,
      "executionPolicy": "ALWAYS",
      "numberOfTotalViews": null,
      "versionCodePolicy": null
    },
    "message": "This is a Toast Notification",
    "duration": 1
  }
]

Example of an AlertDialog Notification

[
  {
    "type": "AlertDialogNotification",
    "notificationConfiguration": {
      "startShowingDate": null,
      "executionPolicy": "ALWAYS",
      "numberOfTotalViews": null,
      "versionCodePolicy": null
    },
    "title": "Title",
    "message": "This is an AlertDialog notification",
    "negativeButtonText": "Exit App",
    "neutralButtonText": "Open web page",
    "positiveButtonText": "Open Play Store",
    "positiveButtonAction": {
      "type": "OpenStoreButtonAction",
      "packageName": "de.vorlesungsfrei.taekwondo.ads"
    },
    "negativeButtonAction": {
      "type": "ExitAppButtonAction"
    },
    "neutralButtonAction": {
      "type": "OpenUrlButtonAction",
      "link": "https://github.com/kaiwinter/android-remote-notifications"
    },
    "modal": false
  }
]

ProGuard

To keep the jackson annotations add this to your ProGuard configuration.
# android-remote-notifications
-keepattributes *Annotation*,EnclosingMethod,Signature
-keepnames class com.fasterxml.jackson.** { *; }
-dontwarn com.fasterxml.jackson.databind.**
-keep public class com.github.kaiwinter.** {*;}

Comments