开源实用小巧的Android引导蒙版(浮层)库
来源:互联网 发布:无约束优化问题 编辑:程序博客网 时间:2024/05/23 23:44
转载自:http://www.jianshu.com/p/5e80c7aee1fc
前言
每当一个项目开发一个新功能,总会想办法及时让用户得知有这样一个新功能,这时通常会采用引导页或者蒙版(浮层)的方式提心用户,这里有需要关注的新内容。
遇到这种需求,最简单的想法就是将引导的布局直接写在对应的页面中,在首次打开时显示,之后隐藏。但是用这种做法来显示只会出现一次的布局,显然有些浪费资源。而且很low,完全体现不出OOP的编程思想。我们的项目中原来使用的是:http://www.jianshu.com/p/5aa96683d0dc
可以看到这是一个非常好的思路,通过DecorView来添加引导层,引导层的相关代码就可以从activity中抽离出来。高亮则是通过画笔的setXfermode来实现。作者也进行了一定的封装,使用的效果也挺好,但是我始终对调用的方法感觉不舒服:
每次使用时要判断是否显示过
if(NewbieGuideManager.isNeverShowed(this, NewbieGuideManager.TYPE_COLLECT)) { new NewbieGuideManager(this, NewbieGuideManager.TYPE_COLLECT).addView (mCollect, HoleBean.TYPE_CIRCLE).addView(mTitleTv, HoleBean .TYPE_RECTANGLE).show(); }
通过下列方法显示出引导层
new NewbieGuideManager(MainActivity.this, NewbieGuideManager.TYPE_LIST).addView(view .getChildAt(0).findViewById(R.id.logo), HoleBean .TYPE_RECTANGLE).show();
这里还涉及到一个常量:NewbieGuideManager.TYPE_LIST
,需要在manager类中定义,并且设置对应的布局:
mNewbieGuide.setEveryWhereTouchable(false).addIndicateImg(R.drawable.left_arrow, ScreenUtils.dpToPx(mActivity, 60), ScreenUtils.dpToPx(mActivity, 110)).addMsgAndKnowTv("这个listview滚动到item6后出现新手引导浮层,\n只有点击我知道啦才会想消失", -ScreenUtils.dpToPx(mActivity, 250)).show();
并且每增加一种引导浮层就要重复上述3步的过程。
优化的NewbieGuide
由于非常介意上述的调用方式,于是我抽空在上述的思路上自己实现一个小巧的库,主要对调用方式进行了封装,通过链式调用,一行代码就可以实现引导层的实现。
Github:https://github.com/huburt-Hu/NewbieGuide
导入
先来看下如何导入项目中:
项目的build.gradle添加
allprojects { repositories { ... maven { url 'https://jitpack.io' } } }
module的build.gradle添加
dependencies { compile 'com.github.huburt-Hu:NewbieGuide:v1.0.2' }
使用
使用的话非常方便,在需要引导层的地方添加如下代码:
NewbieGuide.with(this)//传入activity .setLabel("guide1")//设置引导层标示,用于区分不同引导层,必传!否则报错 .addHighLight(view, HighLight.Type.RECTANGLE)//添加需要高亮的view .setLayoutRes(R.layout.view_guide)//自定义的提示layout,不要添加背景色,引导层背景色通过setBackgroundColor()设置 .show();//显示引导层
setLabel(String label)
方法需要传入一个当前引导层的标示,用于sp缓存当前引导层是否已经显示过,因此是一个必须的参数,忘了设置的话会抛出异常!addHighLight()
方法有三个重载,第一个参数是需要高亮的view(通常是通过findViewById找到的view),第二个参数是高亮的类型,目前有四种:矩形,圆形,椭圆,圆角矩形(如果选择圆角矩形的话,调用重载3个参数的方法,第三个参数是圆角的dp值),默认的话是矩形即只有一个参数的重载。setLayoutRes(int resId,int... id)
该方法第一个参数传入xml的布局,可以任意编辑,如提示的文字,颜色,位置,图片等,皆有你来自定义。第二个参数是可变参数,传入该布局内需要点击消失引导层的view的id。之所以用这种方式是因为通过代码来调整视图非常麻烦,无法直接看到效果,我在使用中经常要部署好多次才会确定最终位置,远没有layout.xml来实现布局方便。
效果
当然,这只是最简单的实现效果,具体要如何的界面都可以由你来自定义layout,并通过setLayoutRes()方法传入即可。
更多配置
Controller controller = NewbieGuide.with(this) .setOnGuideChangedListener(new OnGuideChangedListener() {//设置监听 @Override public void onShowed(Controller controller) { //引导层显示 } @Override public void onRemoved(Controller controller) { //引导层消失 } }) .setBackgroundColor(Color.BLACK)//设置引导层背景色,建议有透明度,默认背景色为:0xb2000000 .setEveryWhereCancelable(false)//设置点击任何区域消失,默认为true .setLayoutRes(R.layout.view_guide, R.id.textView)//自定义的提示layout,第二个可变参数为点击隐藏引导层view的id .alwaysShow(true)//是否每次都显示引导层,默认false .build();//构建引导层的控制器 controller.resetLabel("guide1"); controller.remove();//移除引导层 controller.show();//显示引导层
实现原理
这个库非常的小,总共只有5个类,一个接口,一个工具类。
高亮的实现是通过画笔的setXfermode。即当两个画布上都绘制了图片是,可以控制最终显示的样式,有取重叠部分,有去除重叠部分的等等,总共有16中规则,具体下图:
我所使用的是clear属性,即先通过
canvas.drawColor(mBackgroundColor);
绘制背景色,然后通过设置了clear属性的画笔PorterDuffXfermode xfermode = new PorterDuffXfermode(PorterDuff.Mode.CLEAR); mPaint.setXfermode(xfermode);
镂空出需要高亮的view。
view在屏幕的位置可以通过下述方法获取:
public RectF getRectF() { RectF rectF = new RectF(); if (mHole != null) { int[] location = new int[2]; mHole.getLocationOnScreen(location); rectF.left = location[0]; rectF.top = location[1]; rectF.right = location[0] + mHole.getWidth(); rectF.bottom = location[1] + mHole.getHeight(); } return rectF; }
mHole
就是之前传入的需要高亮的view。
余下就是调用的封装了,使用了建造者模式来保证链式调用,有兴趣的可以clone代码看下,也用不了多少时间。
注:针对eclipse的用户直接把library\src\main\java\com\app\hubert\library中的java代码直接拷贝到工程中,然后在需要加入的activity里引用自定义的模板布局。
eclipse版demo开源:https://github.com/TomesVWhite/DemoRepository/tree/master/NewbieGuide
- 开源实用小巧的Android引导蒙版(浮层)库
- 推荐一个好用小巧的Android引导蒙版(浮层)库
- 一个小巧好用的Android引导蒙版(浮层)库
- 小巧实用的android自动更新模块代码
- Nutz:小巧而实用的国产开源Java项目
- 小巧实用的日历
- 史上最小巧的blink+cc(硬件合成层)出炉
- Android页面中的引导蒙层的使用
- Android引导指示层的制作 (ViewStub + SharePreference)
- Android 新手引导蒙层效果实现
- Android-绘图-半透明/蒙层引导用户
- Android悬浮引导层
- C++,几个小巧开源xml库
- 小巧精悍的引导程序--Blob
- 首次进入APP的蒙层引导
- Android 引导图层、引导页
- 新手引导蒙层
- 小巧实用的文件查看利器——FileSee(转载)
- iOS----点赞动画
- C# PDF转为图片的方法
- leetcode 98. Validate Binary Search Tree
- 新建Maven工程webapp项目index.jsp报错解决方法
- 获取图片文件
- 开源实用小巧的Android引导蒙版(浮层)库
- sass学习三--控制指令和表达式
- 读书笔记∣元数据:用数据的数据管理你的世界 Ch.1-2
- mysql 数据字典
- Java虚拟机的内存结构
- Jesus Is Here HDU
- 看IMEI和IMSI
- Hadoop 2.6.0 FileSplit和InputSplit和FileInputFormat
- HaProxy代理cookie