Home

FloatingX Wiki

FloatingX 是一个灵活且强大的 Android 悬浮窗解决方案：App 级全局浮窗、系统级浮窗、局部浮窗、Compose 内容，按需依赖。 3.0 是一次彻底重写，不兼容 2.x 的 API。

仓库首页：README · README (English) · AI 快速查文档

中文文档

页面	内容
Getting-Started	模块与依赖、版本要求、四种 host 的最小示例
App-Host	App 级全局浮窗：跟随 Activity、黑白名单 / filter、挂载点、theme、Java Builder
System-Host	系统级浮窗：权限三策略、降级 fallback、LayoutParams、键盘、返回键、Service
Scope-Host	局部浮窗：ViewGroupHost / FragmentHost / fxScope {}
Compose	compose {} DSL、FxComposeOwner、stateFlow() / positionFlow()
Configuration	能力一览与全部配置项：锚点 / 吸附 / 手势 / 动画 / modal / 持久化 / update {}
API-Reference	FxControl / FxListener / FloatingX 注册表速查
FAQ	常见问题
Migration-from-2.x	2.x → 3.0 迁移指南
Issue-Coverage	issue 覆盖矩阵
Architecture	Host / Engine / Feature 三角色与扩展方式
Demo	示例工程：能力页 / 回归页与运行方式

English

Page	Content
Getting-Started-EN	Modules & dependencies, requirements, minimal samples for the four hosts
App-Host-EN	App-level global window: follows the Activity, black/white list, attach target, theme, Java builder
System-Host-EN	System window: permission strategies, fallback, LayoutParams, keyboard, back key, Service
Scope-Host-EN	Local windows: ViewGroupHost / FragmentHost / fxScope {}
Compose-EN	The compose {} DSL, FxComposeOwner, stateFlow() / positionFlow()
Configuration-EN	Capabilities and every config option: anchor / adsorption / gestures / animation / modal / persistence / update {}
API-Reference-EN	FxControl / FxListener / the FloatingX registry
FAQ-EN	Frequently asked questions
Migration-from-2.x-EN	2.x → 3.0 migration guide
Issue-Coverage-EN	Issue coverage matrix
Architecture-EN	Host / Engine / Feature and how to extend them
Demo-EN	Sample app: capability pages, regression pages, how to run