FloatingX Android 免权限悬浮窗，支持全局、局部悬浮，支持边缘吸附、回弹、自 @codeKK AndroidOpen Source Website

FloatingX

Introduction: Android 免权限悬浮窗，支持全局、局部悬浮，支持边缘吸附、回弹、自定义动画、位置保存、窗口化及分屏后位置修复等。Android without permission suspension window, support global, local suspension, support edge adsorption, rebound, custom animation, position saving, windowing and split-screen position repair.

More: Author ReportBugs

Tags:

FloatingX 一个灵活且强大的悬浮窗解决方案。

English Introduction

具体使用文档见这里

AI 快速查文档见这里

👏 特性

支持 JetPack Compose
支持 浮窗半隐藏模式
支持 自定义隐藏显示动画;
支持 多指触摸，精准决策触摸手势;
支持自定义是否保存历史位置及还原;
支持 系统浮窗、应用内浮窗、局部浮窗；
支持 越界回弹，边缘悬停，边界设置;
支持以 layout, View 的方式设置浮窗内容；
支持自定义浮窗显示位置，支持辅助定位;
支持 黑名单与白名单 功能，指定页面禁止显示浮窗等;
支持 kotlin 构建扩展, 及对 Java 的友好兼容;
支持显示位置[强行修复],应对特殊机型(需要单独开启)
支持 局部浮窗，可在ViewGroup , Fragment , Activity 中进行显示；
完善的日志系统，打开即可看到不同级别的 Fx 运行过程,更利于发现问题

👨‍💻‍ 依赖方式

Gradle

dependencies {
    implementation 'io.github.petterpx:floatingx:2.3.7'

    // system 浮窗&&compose 时需要导入
    // 记得 AppHelper 里调用 enableComposeSupport()
    implementation 'io.github.petterpx:floatingx-compose:2.3.7'
}

🏄‍♀️ 效果图

全屏,activity,fragment,单 view	小屏展示	非正常比例缩放屏幕

屏幕旋转	功能演示

完善的日志-查看器

开启日志查看器，将看到 Fx 整个运行轨迹，更便于发现问题以及追踪解决。同时支持自定义日志 tag

App	Activity	ViewGroup

👨‍🔧‍ 使用方式

全局悬浮窗管理

AndroidManifest (非必须)

// 如果不使用系统浮窗可以忽略此步骤(即 FxScopeType.App 时可跳过)
<uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW" />
<uses-permission android:name="android.permission.SYSTEM_OVERLAY_WINDOW" />

FloatingX.install {
    setContext(context)
        setLayout(R.layout.item_floating)
      setScopeType(FxScopeType.SYSTEM_AUTO)
}.show()

Java

AppHelper helper = AppHelper.builder()
    .setContext(context)
        .setLayout(R.layout.item_floating)
      .setScopeType(FxScopeType.SYSTEM_AUTO)
        .build();
FloatingX.install(helper).show();

局部悬浮窗管理

通用创建方式

ScopeHelper.builder {
  setLayout(R.layout.item_floating)
}.toControl(activity)

kt && java

ScopeHelper.builder()
            .setLayout(R.layout.item_floating)
            .build()
            .toControl(activity)
            .toControl(fragment)
            .toControl(viewgroup)

对 kt 的扩展支持

activity 创建悬浮窗

private val scopeFx by createFx {
    setLayout(R.layout.item_floating)
    build().toControl(this/Activity)
}

fragment 创建悬浮窗

private val activityFx by createFx {
    setLayout(R.layout.item_floating)
    build().toControl(this/Fragment)
}

viewGroup 创建悬浮窗

private val activityFx by createFx {
    setLayout(R.layout.item_floating)
    build().toControl(this/Viewgroup)
}

🤔 技术实现

System 级别悬浮窗基于 WindowsManager 的实现方案，全局持有一个单独的悬浮窗 View ,通过 AppLifecycle 监听 Activity 生命周期，并在相应时机插入到 WindowManager 上 ;

App 级别悬浮窗基于 DecorView 的的实现方案，全局持有一个单独的悬浮窗 View ,通过 AppLifecycle 监听 Activity 生命周期，并在相应时机插入到 DecorView 上 ;

View 级别悬浮窗，基于给定的 ViewGroup ;

Fragment 级别，基于其对应的 rootView ;

Acrtivity 级别,基于 DecorView 内部的 R.id.content ;

具体如下：

Activity-setContentView

具体见我的博客：源码分析 | Activity-setContentView

Ps: 为什么 App 级别悬浮窗要插入到 DecorView ,而不是 R.id.content -> FrameLayout ?

插入到 DecorView 可以最大程度控制悬浮窗的自由度，即悬浮窗可以真正意义上[全屏]拖动。

插入到 content 中,其拖动范围其实为 应用视图范围 ,即摆放位置受到 状态栏 和 底部导航栏 以及默认的 AppBar 影响, 比如当用户隐藏了状态栏或者导航栏，相对应的视图大小会发生改变，将影响悬浮窗的位置摆放。