# zhaozepeng/FloatWindowPermission

this repository is aimed to adapt android float window permission in most kinds of mobiles and how to request it at runtime

Repository: https://github.com/zhaozepeng/FloatWindowPermission
Canonical: https://ross.abutalabs.com/products/floatwindowpermission
Language: Java
License Family: other
Last push: 2022-07-23T00:25:36+00:00

## Health v2 (maintenance only)
Score: 32/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 0, release rhythm 35, longevity 100
- inputs: {"age_days": 3607, "days_push": 1503, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases, no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1337, forks 269 (observed 2026-08-28T04:04:25.609029+00:00)

## What it is
A Java library for Android that adapts the floating window (overlay) permission across many Chinese phone manufacturers' ROMs and shows how to request it at runtime. It covers vendors like Xiaomi, Huawei, Meizu, and 360 across Android versions below and above 6.0.

## Use cases
- request overlay permission at runtime on android
- check if float window permission is granted
- open the float window settings page on xiaomi or huawei
- adapt overlay permission across chinese roms
- show a floating window on android without permission issues
- handle SYSTEM_ALERT_WINDOW permission on pre-marshmallow devices

## When to choose
- your android app needs floating windows and must support Chinese OEM ROMs like Xiaomi, Huawei, or Meizu
- you need to detect and request overlay permission on devices running Android versions below 6.0
- you want a ready-made compatibility layer instead of writing per-vendor permission logic yourself

## When to avoid
- your app only targets stock Android 6.0+ where the standard Settings.canDrawOverlays API suffices
- you need a maintained library with active support - the repo has no license and sees infrequent updates
- you are building for non-Android platforms

## Facets
- artifact type: library
- maturity: maintenance
- function: mobile-framework, developer-tools
- domain: android-tools, mobile-development, developer-tools
- platform: jvm
- tags: float-window, runtime-permissions, android-compatibility, rom-adaptation, overlay-permission, android

## Member repositories
- zhaozepeng/FloatWindowPermission (main) score 32

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:25.609029+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T04:44:05.687453+00:00, confidence not recorded.
  - readme: https://github.com/zhaozepeng/FloatWindowPermission (fetched 2026-08-28T04:04:25.609029+00:00, sha 8abaad6b348a)
- Data as of 2026-08-30T08:39:29.467469+00:00.