产品简介
FloatingX 是一个专为Android设计的悬浮窗库，提供系统悬浮窗、应用内悬浮窗和局部悬浮窗支持。它解决了Android开发中悬浮窗的复杂实现、权限管理和位置控制问题，适合需要集成悬浮窗功能的开发者。
核心功能
- 支持系统浮窗、应用内浮窗和局部浮窗
- 边缘吸附与越界回弹功能
- 自定义动画和位置保存
- 支持JetPack Compose和多指触摸
- 黑名单与白名单管理
快速开始
- 在项目build.gradle文件中添加依赖：implementation 'io.github.petterpx:floatingx:2.3.7'
- 如需系统悬浮窗，在AndroidManifest.xml中添加权限声明
- 使用FloatingX.install或ScopeHelper.builder初始化并显示悬浮窗
界面预览
与其他方案对比
| 对比项 | FloatingX | 同类方案 |
|---|---|---|
| 悬浮窗模式 | 支持系统浮窗、应用内浮窗和局部浮窗三种模式 | 其他库通常仅支持一种或两种模式 |
| 自定义能力 | 提供边缘吸附、回弹动画、位置保存等丰富自定义 | 自定义选项有限，可能缺少高级功能 |
| 兼容性 | 优化导航栏测量，覆盖95%机型，支持位置修复 | 在特殊机型上可能兼容性问题 |
适合谁用
- 需要在Android应用中集成悬浮窗功能的开发者
- 开发客服聊天或工具类App的工程师
- 使用JetPack Compose进行Android开发并需要悬浮窗支持的开发者
下载与版本
当前最新版本为 2.3.7，发布于 2025-08-24。支持 Windows、macOS、Linux。
⚠️ 注意：本项目仅提供源代码下载，不包含可直接运行的安装包（exe/dmg/apk 等。下载后需要自行编译构建才能使用，适合有一定开发经验的用户。如果你不熟悉编译流程，建议寻找同类开箱即用的替代方案。
注意事项
- 本工具仅供学习和研究使用，请遵守相关法律法规。
- 请尊重内容创作者版权，勿将下载内容用于商业或非法传播。
- 项目源码地址：https://github.com/Petterpx/FloatingX