/OverlayHelper

Handle Android "draw over other apps" permissions and queries in a version-agnostic way

Primary LanguageJavaApache License 2.0Apache-2.0

OverlayHelper

Release

This utility library aims to help Android developers handle "draw overlays" (also called "draw over other apps") permissions and queries in a version-agnostic way.

Installation

Add the following dependencies to your main build.gradle:

allprojects {
    repositories {
        maven { url "https://jitpack.io" }
    }
}

Add the following dependencies to your app's build.gradle:

  • For Gradle < 4.0

    dependencies {
        compile "com.github.adriangl:overlayhelper:1.1.0"
    }
  • For Gradle 4.0+

    dependencies {
        implementation "com.github.adriangl:overlayhelper:1.1.0"
    }

Example usage

  • Create a new OverlayHelper with a OverlayPermissionChangedListener.
  • Start watching settings changes with OverlayHelper.startWatching(), for example in onCreate().
  • Stop watching changes with OverlayHelper.stopWatching() in onDestroy().
  • If you want to check if the app has their "draw overlays" permission enabled, use OverlayHelper.canDrawOverlays().
  • Call OverlayHelper.requestDrawOverlaysPermission() wherever you want in your activity. You'll have to also add OverlayHelper.onRequestDrawOverlaysPermissionResult(int) in the activity's onActivityResult(), so the helper can retrieve the needed data.
  • You'll receive your permission results in the OverlayPermissionChangedListener that you registered when creating the helper.

Check the example app for more implementation details.

License

Copyright (C) 2018 Adrián García

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.