好用的Android新功能引导(蒙版浮层)库

转载自:www.jianshu.com/p/5e80c7aee1fc ,原作者:胡奚冰

前言:

每当一个项目开发一个新功能,总会想办法及时让用户得知有这样一个新功能,这时通常会采用引导页或者蒙版(浮层)的方式提心用户,这里有需要关注的新内容。遇到这种需求,最简单的想法就是将引导的布局直接写在对应的页面中,在首次打开时显示,之后隐藏。但是用这种做法来显示只会出现一次的布局,显然有些浪费资源。而且很low,完全体现不出OOP的编程思想。可以看到这是一个非常好的思路,通过DecorView来添加引导层,引导层的相关代码就可以从activity中抽离出来。高亮则是通过画笔的setXfermode来实现。

开始:

项目名叫 NewbieGuide

导入

先来看下如何导入项目中:

项目的build.gradle添加

allprojects {
        repositories {
            ...
            maven { url 'https://jitpack.io' }
        }
    }
module的build.gradle添加

dependencies {
     compile 'com.github.huburt-Hu:NewbieGuide:v1.0.3'
   }

原demo显示效果:

Paste_Image.png

原demo的基本使用设置:

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();//显示引导层

其中setLayoutRes(R.layout.view_guide, R.id.textView)这个方法非常重要,第一个参数是悬浮的指导布局,但是有点缺陷,比如第二个参数传进去的是一个view的id而不是view本身,这就导致这个view无法确定其在高亮view的具体相对位置,只能用来大概猜测然后在原布局中设置Margin,很不合理。为此笔者多添加了几个继承类。

Paste_Image.png
Paste_Image.png

值得注意的是这些类都继承自原来类库中的类,而且它们的包必须是app.hubert.library(创建时可根据代码提示自动生成)。在MyController中我们会看到show()这个方法,这是原来Controller中的方法,用来显示引导布局,我们如果要调整布局中的控件位置就是要在这里进行的。

      if(this.viewIds != null) {
                int[] var3 = this.viewIds;
                int var4 = var3.length;

                for(int var5 = 0; var5 < var4; ++var5) {
                    int viewId = var3[var5];
                    var7.findViewById(viewId).setOnClickListener(new OnClickListener() {
                        public void onClick(View v) {
                            Controller.this.remove();
                        }
                    });
                }
            }

这里viewids表示用来提示的控件,比如“点击这里可进行xxx”的Textview或者其他Imageview,数组形式。上面的代码表示点击了这个view(比如“我知道了”),引导布局就会消失掉。这里var7表示的就是我们的引导界面布局了,通过findbyviewid可以找出要点击或者提示的view。所以我们可以在这里面调整view的位置,使它在高亮view的上面或者下面,list表示的就是高亮view的物理位置(屏幕位置),txt1就是要挪动的view,通过setY()方法将其移动到相关位置,下面的代码中我将它移动到了高亮控件的上面。

         for(int var5 = 0; var5 < var4; ++var5) {
                     int viewId = var3[var5];
                    var7.findViewById(viewId).setOnClickListener(new View.OnClickListener() {
                        public void onClick(View v) {
                            MyController.this.remove();

                        }
                    });
                    if (viewId == R.id.txt1){
                        final TextView txt1 = (TextView) var7.findViewById(viewId);
                        txt1.post(new Runnable() {
                            @Override
                            public void run() {
                                final float offY_t =  list.get(1).getRectF().top;
                                final float offY_b =  list.get(1).getRectF().bottom;
                                Log.e("yang","offY:"+offY_t+" txt1.getTop():"+txt1.getY());
                                txt1.setY(offY_t-(offY_b-offY_t));
                            }
                        });
                        txt1.setText("点击这里可以进行相关操作!!!");
                    }
                }

原来 txt1在上面,这就是引导页布局


Paste_Image.png

后来调整到下面,而且变了文字信息

Paste_Image.png

大家可以将Textview换成美工做的图片,比如一个手指指示,视觉效果会更好

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 204,189评论 6 478
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,577评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,857评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,703评论 1 276
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,705评论 5 366
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,620评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,995评论 3 396
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,656评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,898评论 1 298
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,639评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,720评论 1 330
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,395评论 4 319
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,982评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,953评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,195评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 44,907评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,472评论 2 342

推荐阅读更多精彩内容