PopLayer

Introduction: 通用 Android 端弹窗管理框架,支持带网络请求的业务流程管理,内部维护弹窗优先级队列 具备弹窗管理扩展功能 整合 Dialog,PoupoWindow,悬浮 Widget,透明 Webview,Toast,SnackBar,无需再为繁琐的业务弹窗逻辑所困扰
More: Author   ReportBugs   
Tags:

Logo

一个通用的 Android 端弹窗管理框架,支持带网络请求的业务流程管理,内部维护弹窗优先级队列 具备弹窗管理扩展功能 整合 Dialog,PoupoWindow,悬浮 Widget,透明 Webview,Toast,SnackBar,无需再为繁琐的业务弹窗逻辑所困扰

弹窗管理

如何添加依赖

只需要两行代码轻松接入

//add this to your repositories
 maven { url 'https://www.jitpack.io' }

//add this to your dependencies
implementation 'com.github.MrCodeSniper:PopLayer:3.0.2'

具体如何使用

1.根据策略创建对应的弹窗 view

//Dialog 布局形式
PopLayerView  mLayerView = new PopLayerView(this,R.layout.common_dialog_upgrade_app);

//自定义 Dialog 形式
NoticePopDialog hrzNoticePopDialog = new NoticePopDialog(this);
PopLayerView mLayerView = new PopLayerView(this,hrzNoticePopDialog);

//透明 Webview 形式
PopLayerView mLayerView = new PopLayerView(this,LayerConfig.redPocketScheme);

//取得对应的弹窗实体
PopLayerView<Dialog> mLayerView = new PopLayerView(this,R.layout.common_popview_frame2);
Dialog mView=mLayerView.getView().getPoupo();

PopLayerView<WebView> mLayerView = new PopLayerView(this,LayerConfig.redPocketScheme);
WebView mView=mLayerView.getView().getPoupo();

//想要拿到弹窗布局里的具体控件?就跟系统 API 一样简单!
TextView xxxTV = (TextView) mLayerView.findViewById(R.id.tv);

2.配置参数并直接使用

  Popi.getBuilder()
                .setmPopId(4)//弹窗的唯一标识 当 id 发生改变 视为新的弹窗
                .setmPriority(2)//优先级这里不具体划分对应的范围 值越小优先级越高
                .setmCancelType(TRIGGER_CANCEL)//弹窗消失的类型分为 TRIGGER_CANCEL(触摸消失) COUNTDOWN_CANCEL (延时消失)
                .setMaxShowTimeLength(5)//最长显示时间(S)
                .setMaxShowCount(5)//最大显示次数
                .setmBeginDate(1548858028)//秒级时间撮开始时间 2019-01-30 22:20:28
                .setmEndDate(1548944428)//秒级时间撮结束时间 2019-01-31 22:20:28
                .setLayerView(mLayerView)//弹窗 View
                .build()
                .pushToQueue() //纳入弹窗管理
                .show();//开始显示弹窗

Addition:当需要统一异步回调请加入以下代码

//添加任务
Task taskUpdate=new Task();
taskUpdate.setmPriority(1);
taskUpdate.setmTaskId(1);

//任务管理器添加任务及对应的弹窗
TaskManager.getInstance(this)
           .pushToQueue(taskUpdate,mUpgradePopi)
           .pushToQueue(taskDownload,downloadPop)
           .pushToQueue(taskNotice,noticePopi);

//显示逻辑
TaskManager.getInstance(this).onTaskGoOn(taskUpdate);//回调成功
TaskManager.getInstance(this).onTaskInterupt(taskUpdate);//回调失败

//或
//如果您使用的是 Rxjava 实现回调您可以继承框架中自带回调逻辑的 PopRxSubscriber
public class MySubscriber extends PopRxSubscriber {
    public MySubscriber(Context mContext, Task task) {
        super(mContext, task);
    }
}

效果预览

Dialog 策略效果.gif

下一步的计划

逐步统一 其他类型的弹窗 提供给一个较为全面的应对业务需求的弹窗管理框架

版本记录

V1 方案

版本号 LOG 进度更新
V1.0.0 项目开源,完成弹窗管理与 Dialog 形式扩展 Dialog 策略扩展完成
V1.0.1 修复 Dialog 策略无法获取 dialog 实体 bug Dialog 策略优化
V1.0.2 修复 activity 摧毁造成的弹窗异常 bug Dialog 策略优化
V1.0.3 优化了弹窗的使用更加方便快捷 框架使用优化

V2 方案

版本号 LOG 进度更新
V2.0.0 正式加入透明 Webview 弹窗策略扩展 透明 Webview 策略扩展完成

V3 方案

版本号 LOG 进度更新
V3.0.0 引入流程任务管理模块 解决涉及网络的业务逻辑弹窗
V3.0.0~V3.0.2 优化回调优化职责分离 全网最新最全 DEMO

关于项目

目前该项目已经稳定运行在本人的线上项目中,当需要扩展或者修改的地方会及时发版更新,有问题也可以直接提 ISSUE 给我 看到马上回复

如果您对本项目感兴趣您可以去掘金观看我的文章 给予一点小小的支持

Android 通用业务弹窗管理方案 V1-Dialog 方案

Android 通用业务弹窗管理方案 V2-WebView 方案

Android 通用业务弹窗管理方案 V3- 业务流程控制

作者介绍

Hello 我叫CodeSniper,如果您喜欢这个项目 请给个Star这对我真的非常重要!!!

License

Copyright (c) 2019 ChenHong

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
Apps
About Me
Google+: Trinea trinea
GitHub: Trinea