Android 快速实现新手引导层

        这是一款可以通过简洁链式调用,一行代码实现引导层的显示,自动判断首次显示,当然也可以通过参数配置来满足不同的显示逻辑和需求。

        通过自定义layout.xml实现文本及image的添加,非常方便位置的调整,避免代码调整各种不好控制的情况:实验5,6次才最终确定文字等的位置。


效果

依赖

           compileOnly 'com.android.support:appcompat-v7:25.3.1'

导入

            项目的build.gradle添加

                    allprojects {

                        repositories {

                        ...

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

                       }

                    }

           module的build.gradle添加

                    dependencies {

                              compile 'com.github.huburt-Hu:NewbieGuide:v2.4.0'

                    }

确保你的项目中已经依赖了appcompat-v7

简单使用

NewbieGuide.with(activity)

        .setLabel("guide1")

        .addGuidePage(GuidePage.newInstance()

            .addHighLight(btnSimple)

            .setLayoutRes(R.layout.view_guide_simple))

        .show();

其中:

        with方法可以传入Activity或者Fragment,获取引导页的依附者。Fragment中使用建议传入fragment,内部会添加监听,当依附的Fragment销毁时,引导层自动消失。

        setLabel方法用于设置引导页的标签,区别不同的引导页,该方法必须调用设置,否则会抛出异常。内部使用该label控制引导页的显示次数。

        addGuidePage方法添加一页引导页,这里的引导层可以有多个引导页,但至少需要一页。

        GuidePage即为引导页对象,表示一页引导页,可以通过.newInstance()创建对象。并通过addHighLight添加一个或多个需要高亮的view,该方法有多个重载,可以设置高亮的形状,以及padding等(默认是矩形)。setLayoutRes方法用于引导页说明布局,就是上图的说明文字的布局。

        show方法直接显示引导层,如果不想马上显示可以使用build方法返回一个Controller对象,完成构建。需要显示得时候再次调用Controller对象的show方法进行显示。

©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

推荐阅读更多精彩内容

  • 今天来推荐一个好用遮罩引导库,这是我持续维护了大半年的开源项目。刚完成第一版的时候,我也记录了文章,并且有幸推荐到...
    胡奚冰阅读 9,460评论 14 144
  • 此刻,我沉默到一句话也表达不出来。看着熟睡中的女儿,各种心酸,挫败涌上心头。从出生到现在,没有离开过她一天,...
    深夜小蜗牛阅读 185评论 0 0
  • 目标:儿女健康成长,快乐学习 1.参加10万“南无阿弥陀佛”佛号共修. 2.护生群,天星寺建寺群,放生群随喜,愿更...
    幸运的莲华阅读 124评论 0 0
  • 死伤同胞百万,转眼已有十年。 亡灵天灾留怨念。 谁敢仗义执言? 腐败无法无天,黎民百姓受难。 豆腐工程一大片。 神...
    高原_4697阅读 176评论 0 3
  • ‘股票投资大讲堂序一: 一个老兵的投资感悟 在犯了那么多的错,亏了那么多的钱,读了那么...
    战场老兵_097d阅读 433评论 0 1