/UpdateChecker

Android User, never miss an Update.

Primary LanguageJavaApache License 2.0Apache-2.0

Update Checker

Android User, never miss an Update.

image

Overview

Update Checker is a class that can be used by Android Developers to increase the number of users update their apps by showing a "New Update Available" Notification or Dialog.

It's based on Fragments, It checks for new updates downloadable by parsing the Play Store desktop page of your app.

XDA Thread

Featured on XDA Portal!

Changelog

Current version: 1.1.1

####1.1.1

  • Text strings improved

####1.1.0

  • Change to customize the number of checks after the dialog/notification will be shown with new methods
  • Added Dutch translation
  • Fixed other translation errors
  • New demo app

####1.0.0

  • First Release

Dependencies

Example

  • Check it out the Demos folder

Usage

  • Import Styled Dialogs into the library.

  • Import android-support-v4.jar into the library.

  • Import the library into you app.

  • First, add INTERNET and ACCESS_NETWORK_STATE permissions to your app's Manifest:

      <uses-permission android:name="android.permission.INTERNET"/>
      <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
    
  • So, in the class you want to use the library extend a FragmentActivity (or, obviously, a SherlockFragmentActivity).

  • To show a Play-Store-App-like notification if a new update was found:

      UpdateChecker.checkForNotification(this);
    

    Image

  • To show a dialog if a new update was found:

      UpdateChecker.checkForDialog(this);
    

    Image

##Important!

  • If there is a new update available, when app launched, not every time the Notification / Dialog will be shown. The Notification/Dialog will be shown every 5 times the app ascertain that a new update is available. It's a precaution to make the library not too invasive. To modify this, see Customization.

  • See Issue #1

##Customization

  • You can modify modify the number of checks after the dialog will be shown. Default is 5.

      UpdateChecker.checkForNotification(this, 10);
      
      UpdateChecker.checkForDialog(this, 10);
    
  • You can modify the notification Drawable by calling a variant of checkForNotification(...) method:

      UpdateChecker.checkForNotification(this, R.drawable.ic_launcher);
    

Image

##Contribution

Questions

If you have any questions regarding UpdateChecker, create an issue.

Feaure request

To create a new Feature request, open an issue with request label here

I'll try to answer as soon as I find the time.

Pull requests welcome

Feel free to contribute to UpdateChecker.

Either you found a bug or have created a new and awesome feature, just create a pull request.

Please note, if you're working on a pull request, make sure to use the develop branch as your base.

Discuss

Join in the conversation, check it out the XDA Thread

Coming soon

  • Support for apps not published on Google Play
  • Remember me later button on dialog
  • Stackoverflow tag for more specific code problems
  • Library Icon
  • Preference to disable UpdateChecker

License

Attributions

Lead Developer: Pietro "Rampo" - PiKo Technologies

This Readme.md file has been written with Mou.