Giter Site home page Giter Site logo

easyfloat's Introduction

前言

全局悬浮窗是项目中的一个常见需求,目前比较常见的实现是将要悬浮的View添加到WindowManager

这种方案的主要痛点在于需要用户申请TYPE_SYSTEM_ALERT权限,并且需要用户去设置中手动打开,使用起来很不方便,同时需要申请权限可能会劝退用户.

针对这种情况下面介绍一种不需要权限的悬浮窗方案

效果图

首先看下最终的效果图

特性

  • 1.不需要申请权限,可以直接打开悬浮窗,使用便捷
  • 2.支持自定义布局,自定义显示样式,自定义初始显示位置
  • 3.支持拖拽,可自动吸附到屏幕边缘
  • 4.可过滤不需要显示悬浮窗的黑名单界面
  • 5.支持自定义点击事件,可支持展开折叠等功能
  • 6.API链式调用,使用简洁优雅

集成

第 1 步:在工程的 build.gradle 中添加:

allprojects {
	repositories {
		...
		mavenCentral()
	}
}

第2步:在应用的 build.gradle 中添加:

dependencies {
        implementation 'io.github.shenzhen2017:easyfloat:1.0.1'
}

使用

API链式调用,使用起来非常方便

1.初始化

    EasyFloat
        .layout(R.layout.layout_float_view)
        .blackList(mutableListOf(ThirdActivity::class.java))
        .layoutParams(initLayoutParams())
        .listener {
            initListener(it)
        }
        .show(this)

如上所示:

1.通过layout指定自定义布局

2.通过blackList指定不展示悬浮窗界面

3.通过layoutParams指定初始展示位置

4.通过listener处理自定义点击事件

2.销毁悬浮窗

	EasyFloat.dismiss(this)

直接调用dismiss销毁即可

主要原理

我们都知道,当我们需要设置布局的时候,是通过setContentView设置的

setContentView实际上是将我们的布局添加到了DecoreView上,布局层级如下所示:

1.Activity 类似于一个框架,负责容器生命周期及活动,窗口通过 Window 来管理;

2.Window 负责窗口管理(实际是子类 PhoneWindow),窗口的绘制和渲染交给 DecorView完成;

3.DecorViewView 树的根,开发人员为 Activity 定义的 layout 将成为 DecorView 的子视图 ContentParent 的子视图;

4.layout.xml 是开发人员定义的布局文件,最终 inflateDecorView 的子组件;

由上我们可以想到一个方案: 我们在Activity onStart时,将要悬浮的View添加到ContentParent上就可以实现不需要权限的悬浮窗了

当然我们还需要注意以下几点

1.因为我们需要在多个页面展示悬浮窗,可以通过ActivityLifecycleCallbacks监听所有Activity的生命周期,onStart时添加,onStop时移除

2.因为要在多个页面共享状态,所以应该有一个单例类管理View,做到只创建一个View,页面切换时只做添加与移除

3.因为要添加到ContentParent中,持有了Activity的引用,所以要注意处理内存泄漏的问题,在项目中我们使用了弱引用来防止内存泄漏

部分代码如下:

object EasyFloat : Application.ActivityLifecycleCallbacks {
    override fun onActivityStarted(activity: Activity) {
         FloatingView.get().attach(it)
    }

    override fun onActivityStopped(activity: Activity) {
        FloatingView.get().detach(activity)
    }

    fun show(activity: Activity) {
        initShow(activity)
        activity.application.registerActivityLifecycleCallbacks(this)
    }

    fun dismiss(activity: Activity) {
        FloatingView.get().remove()
        FloatingView.get().detach(activity)
        activity.application.unregisterActivityLifecycleCallbacks(this)
    }
}

总结

特别鸣谢

在实现这个开源框架的过程中,主要借鉴了EnFloatingView的一些思路

并在其基础上进行了一定的封装,优化了API调用并解决了滑动冲突等一些问题

项目地址

EasyFloat

开源不易,如果项目对你有所帮助,欢迎点赞,Star,收藏~

easyfloat's People

Contributors

ricardojiang avatar

Watchers

James Cloos avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.