EasyFloat： Android悬浮窗框架使用指南

最新推荐文章于 2024-08-13 17:27:32 发布

云忱川

最新推荐文章于 2024-08-13 17:27:32 发布

阅读量1.3k

点赞数 16

本文链接：https://blog.csdn.net/gitblog_01142/article/details/141044861

版权

EasyFloat： Android悬浮窗框架使用指南

项目地址:https://gitcode.com/gh_mirrors/ea/EasyFloat

1. 项目介绍

EasyFloat 是一个Android平台的轻量级悬浮窗口库，旨在简化悬浮窗的开发流程。它提供了拖拽、自定义动画、页面过滤以及多种显示模式等功能。EasyFloat不仅支持单页面浮窗（无需特殊权限），还支持全局浮窗和应用前台浮窗（需要悬浮窗权限）。此外，库内集成了自动权限检测和处理，使得开发者可以更方便地管理和控制浮窗。

2. 项目快速启动

添加依赖

在项目根目录的 build.gradle 文件中添加 JitPack 仓库：

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

然后，在你的应用模块的 build.gradle 文件中引入 EasyFloat 库：

dependencies {
    implementation 'com.github.princekin-f:EasyFloat:2.0.4'
}

同步Gradle后，即可使用 EasyFloat。

显示浮窗

使用以下代码在你的Activity或Fragment中展示一个简单的浮窗：

// 创建一个EasyFloat实例
EasyFloat.with(this)
    // 设置浮窗布局资源ID
    .setLayout(R.layout.float_test)
    // 显示浮窗
    .show();

处理权限

如果您需要使用全局浮窗或应用前台浮窗，记得在 AndroidManifest.xml 中声明悬浮窗权限：

<uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW"/>

3. 应用案例和最佳实践

案例一：自定义拖动边界

EasyFloat.with(this)
    .setLayout(R.layout.float_test)
    .setDragEdge(EasyFloat.DragEdge.ALL) // 允许四周拖动
    .setEdgeDragWidth(100) // 边缘宽度限制
    .show();

最佳实践：状态回调与动画效果

EasyFloat.with(this)
    .setLayout(R.layout.float_test)
    .setOnStatusChangeListener(new OnStatusChangeListener() {
        @Override
        public void onStatusChange(int status) {
            // 根据status值处理不同状态
        }
    })
    .setInAnim(R.anim.slide_in_right) // 进入动画
    .setOutAnim(R.anim.slide_out_left) // 退出动画
    .show();