Utility for detecting and notifying when your Android app goes background / becomes foreground
Java
Permalink
Failed to load latest commit information.
.idea bintray deployment configuration all smartened up and working, added … Jan 23, 2016
Foredroid updating readme to be clear that api-level 14 or above is requireD Jan 23, 2016
app bintray deployment configuration all smartened up and working, added … Jan 23, 2016
gradle/wrapper updated project to build with latest SDK and Android Studio, also pre… Jan 23, 2016
.gitignore first attempt at an improved foreground/background detector taking ac… Mar 27, 2015
Foredroid.iml updated project to build with latest SDK and Android Studio, also pre… Jan 23, 2016
Foreground.iml first attempt at an improved foreground/background detector taking ac… Mar 27, 2015
README.md jcenter dependency details Jan 24, 2016
build.gradle bintray deployment configuration all smartened up and working, added … Jan 23, 2016
gradle.properties first attempt at an improved foreground/background detector taking ac… Mar 27, 2015
gradlew first attempt at an improved foreground/background detector taking ac… Mar 27, 2015
gradlew.bat first attempt at an improved foreground/background detector taking ac… Mar 27, 2015
logo.sketch bintray deployment configuration all smartened up and working, added … Jan 23, 2016
logo_128x128.png bintray deployment configuration all smartened up and working, added … Jan 23, 2016
logo_256x256.png bintray deployment configuration all smartened up and working, added … Jan 23, 2016
logo_64x64.png bintray deployment configuration all smartened up and working, added … Jan 23, 2016
settings.gradle bintray deployment configuration all smartened up and working, added … Jan 23, 2016

README.md

Foredroid

Download

Utility for detecting and notifying when your Android app goes background / becomes foreground.

API-level 14+.

logo

Usage:

Initialise Foreground as early as possible in the startup of your app:

public void onCreate(Bundle savedInstanceState){
  Foreground.init(getApplication());
}

Any time you want to check if you are foreground or background, just ask:

Foreground.get().isForeground();
Foreground.get().isBackground();

Or, if you want to trigger something as soon as possible when you go background or come back to foreground, implement Foreground.Listener and do whatever you want in response to the callback methods:

Foreground.Listener myListener = new Foreground.Listener(){
  public void onBecameForeground(){
    // ... whatever you want to do
  }
  public void onBecameBackground(){
    // ... whatever you want to do
  }
}

... then register your listener:

listenerBinding = Foreground.get().addListener(listener);

Note that in registering the listener we recorded the Binding that was returned, so that we can unbind it again later:

listenerBinding.unbind();

Maven / Gradle

The .aar file is available from the jcenter repository. Check that you have the jcenter repository in your top-level build.gradle like this:

allprojects {
    repositories {
        jcenter()
    }
}

Add the following dependency to your build.gradle:

compile 'com.sjl:Foredroid:1.0.0'