huburt-hu / newbieguide Goto Github PK

View Code? Open in Web Editor NEW

3.5K 54.0 516.0 795 KB

Android 快速实现新手引导层的库，通过简洁链式调用，一行代码实现引导层的显示

License: Apache License 2.0

Java 100.00%

guide hightlight newbieguide tourguide

newbieguide's People

Contributors

Stargazers

Watchers

Forkers

wuxinlingluan dgf2015 shitou9999 ybingbing 616852636 androidtheworld zachary46 shenxiaolin rainbeanfan lldfx1314 maxiongyue585 openprojectsfork zhanghao813207 ssyandroid aidedemo fangyuanzhang axdx1314 lerist androidfavorites zhuangzeqin chenwentong0 lumia1999 jiubadao zerortllyy mingfeng002 andy521 hqdmyjsw chen3441251 tomesvwhite lwmukx1208 sanjie-lang zssandroid yswheye gejiushishuai baiyinshi yanhang0109 justomiguel aesion lixiaohui1090 sxiaoming2007 jack-yan songuoer niemj6012 liulingfeng qijunf hao61928 neil-orzzh yezhengdong zhanghuanwang zktzktzkt eshaohu loveandroid01 zhaimi zgkxy cbdgit yangchangfu lvjiancong yangzbin a85454597 heart2009 msdgwzhy6 lvqingfeng newsolf mw0516 leeyw19837 binlly dengyh2016 fa-haxiki wjy46925183 woodsho finleylc tanwenping allenhan123 dgjjxxx java2liwei chenzjfds yitouwushui feiyang1235 lhb123 qimingnan yclxiao cncash zkjmyy shiyanjie w1015378816 kong-jing fansvaer weinihecai guandiku allen-blue kbjay myhololens cplasf1925 starexception muxi166 chenshige ky48302430 wulee510505 a-how zzpxidian

newbieguide's Issues

全屏沉浸式，高亮位置下移

window.setStatusBarColor(Color.TRANSPARENT); 加了之后，即使在.fullScreen(true) 仍然没用

你好，这个库运行在不同机型上，高亮和[setLayoutRes(R.layout.view_guide)] 位置显示错乱

如题，这个库运行在不同机型上，高亮和[setLayoutRes(R.layout.view_guide)] #，有些机型显示正常，有些机型位置显示错乱

NullPointerException at V4ListenerFragment.onStart

版本：1.1.1
调用：在主界面的底部按钮点击事件中

    @OnClick({R.id.ll_tab_task, R.id.ll_tab_master, R.id.ll_tab_me})
    public void onTabClick(final View view) {
        if (view.getId() == R.id.ll_tab_task) {
            new Thread(new Runnable() {
                @Override
                public void run() {
                    SystemClock.sleep(768);
                    if (isFinishing()) return;
                    llTabTask.post(new Runnable() {
                        @Override
                        public void run() {
                            Controller controller = NewbieGuide.with(MainTabActivity.this)//传入activity
                                    .setOnGuideChangedListener(new OnGuideChangedListener() {
                                        @Override
                                        public void onShowed(final Controller controller) {
                                            // 获取布局，然后查找其中的文本按钮，并设置点击事件
                                            GuideLayout layout = ViewUtils.getGuideLayout(controller);
                                            if (layout == null || layout.findViewById(R.id.tv_known) == null) return;
                                            TextView tvKnown = layout.findViewById(R.id.tv_known);
                                            tvKnown.setOnClickListener(new View.OnClickListener() {
                                                @Override
                                                public void onClick(View view) {
                                                    controller.remove();
                                                }
                                            });
                                        }

                                        @Override
                                        public void onRemoved(Controller controller) {
                                            onTabClick(tabs.get(1));
                                        }
                                    })
                                    .setLabel(Consts.Config.GUIDE_LABEL_SHARE2EARN)//设置引导层标示，用于区分不同引导层，必传！否则报错
                                    .addHighLight(llTabTask, HighLight.Type.CIRCLE)//添加需要高亮的view
                                    .setLayoutRes(R.layout.guide_newbie_task)//自定义的提示layout，不要添加背景色，引导层背景色通过setBackgroundColor()设置
                                    .setEveryWhereCancelable(Consts.Config.GUIDE_NEWBIE_CLICK_ANYWHERE)
                                    .alwaysShow(Consts.Config.GUIDE_NEWBIE_SHOW_ALWAYS)
                                    .build();
                            controller.show();//显示引导层
                        }
                    });

                }
            }).start();
        }
    }

日志信息：

java.lang.RuntimeException: Unable to start activity ComponentInfo{com.toudeng.ddzh/com.toudeng.ddzh.activity.MainTabActivity}: java.lang.NullPointerException
	at android.app.ActivityThread.performLaunchActivity(ActivityThread.java:2464)
	at android.app.ActivityThread.handleLaunchActivity(ActivityThread.java:2526)
	at android.app.ActivityThread.access$800(ActivityThread.java:174)
	at android.app.ActivityThread$H.handleMessage(ActivityThread.java:1398)
	at android.os.Handler.dispatchMessage(Handler.java:110)
	at android.os.Looper.loop(Looper.java:229)
	at android.app.ActivityThread.main(ActivityThread.java:5493)
	at java.lang.reflect.Method.invokeNative(Native Method)
	at java.lang.reflect.Method.invoke(Method.java:515)
	at com.android.internal.os.ZygoteInit$MethodAndArgsCaller.run(ZygoteInit.java:860)
	at com.android.internal.os.ZygoteInit.main(ZygoteInit.java:676)
	at dalvik.system.NativeStart.main(Native Method)
java.lang.NullPointerException
	at com.app.hubert.library.V4ListenerFragment.onStart(V4ListenerFragment.java)
	at android.support.v4.app.Fragment.performStart(Fragment.java)
	at android.support.v4.app.FragmentManagerImpl.moveToState(FragmentManager.java)
	at android.support.v4.app.FragmentManagerImpl.moveFragmentToExpectedState(FragmentManager.java)
	at android.support.v4.app.FragmentManagerImpl.moveToState(FragmentManager.java)
	at android.support.v4.app.FragmentManagerImpl.dispatchStateChange(FragmentManager.java)
	at android.support.v4.app.FragmentManagerImpl.dispatchStart(FragmentManager.java)
	at android.support.v4.app.Fragment.performStart(Fragment.java)
	at android.support.v4.app.FragmentManagerImpl.moveToState(FragmentManager.java)
	at android.support.v4.app.FragmentManagerImpl.moveFragmentToExpectedState(FragmentManager.java)
	at android.support.v4.app.FragmentManagerImpl.moveToState(FragmentManager.java)
	at android.support.v4.app.FragmentManagerImpl.dispatchStateChange(FragmentManager.java)
	at android.support.v4.app.FragmentManagerImpl.dispatchStart(FragmentManager.java)
	at android.support.v4.app.FragmentController.dispatchStart(FragmentController.java)
	at android.support.v4.app.FragmentActivity.onStart(FragmentActivity.java)
	at android.support.v7.app.AppCompatActivity.onStart(AppCompatActivity.java)
	at android.app.Instrumentation.callActivityOnStart(Instrumentation.java:1174)
	at android.app.Activity.performStart(Activity.java:5473)
	at android.app.ActivityThread.performLaunchActivity(ActivityThread.java:2427)
	at android.app.ActivityThread.handleLaunchActivity(ActivityThread.java:2526)
	at android.app.ActivityThread.access$800(ActivityThread.java:174)
	at android.app.ActivityThread$H.handleMessage(ActivityThread.java:1398)
	at android.os.Handler.dispatchMessage(Handler.java:110)
	at android.os.Looper.loop(Looper.java:229)
	at android.app.ActivityThread.main(ActivityThread.java:5493)
	at java.lang.reflect.Method.invokeNative(Native Method)
	at java.lang.reflect.Method.invoke(Method.java:515)
	at com.android.internal.os.ZygoteInit$MethodAndArgsCaller.run(ZygoteInit.java:860)
	at com.android.internal.os.ZygoteInit.main(ZygoteInit.java:676)
	at dalvik.system.NativeStart.main(Native Method)

你好，有多个引导页，如果我想从第二页出发引导页某控件进入第一页引导页，有方法提供吗(Hello, there are more than one guide page, if I want to start from the second page to the first page, is there a method to provide?)

你好，有多个引导页，如果我想从第二页出发引导页某控件进入第一页引导页，有方法提供吗(Hello, there are more than one guide page, if I want to start from the second page to the first page, is there a method to provide?)

设置高亮view的点击事件

请问博主怎么设置高亮view的自定义点击事件呢？如果设置透明view的话有些机子透明view位置对不齐

fragment中的显示问题

fragment中设置alwaysShow(false)，一次都不显示，请问一下是什么原因？

指向GridView中的某个item高亮无效？

楼主，我需要在指向一个GridView中的一个item高亮。
通过adapter的getview方法找到convertView然后addHighlight的。貌似没效果？
用convertView.findViewById找到子View也不行。

` mWxStoreView = mCateNameGridViewAdapter.getView(0, null, null);
ImageView icon = (ImageView)
mWxStoreView.findViewById(R.id.id_home_cate_name_gridview_img);
NewbieGuide.with(getActivity())//传入fragment .setLabel("guide2")//设置引导层标示，必传！否则报错
.addHighLight(mWxStoreView , HighLight.Type.RECTANGLE)//添加需要高亮的view

.addHighLight(loopViewPager, HighLight.Type.RECTANGLE)//添加需要高亮的view
.setLayoutRes(R.layout.view_guide)//自定义的提示layout，不要添加背景色，引导层背景色通过setBackgroundColor()设置
.alwaysShow(true)
.show();//直接显示引导层`

alwaysShow貌似不起作用哦

alwaysShow(true),每次都显示了，这个是符合文档说明的
alwaysShow(false)，第一次也没显示啊，还需要别的参数设置么？

怎么让箭头指向高亮的区域

一个引导页有多快透明区域怎么办啊？

大神继昨天简书上问题

大神这是昨天按照你说的配置了下bulide
然后就报了这么多的错误这个要怎么解决阿

高亮的位置偏离实际位置

高亮的位置偏离实际位位置，表现为高亮的区域比需要高亮的view的位置上移一个状态栏的高度

addHighLight（view）,如果view在ScrollView中，view位置发生变化,浮层还在原先的位置

依赖添加之后，产生错误

楼主你好，我在引入这个依赖包之后，
产生了以下错误
Error:(3) Error retrieving parent for item: No resource found that matches the given name 'android:TextAppearance.Material.Widget.Button.Borderless.Colored'.
Error:(4) Error retrieving parent for item: No resource found that matches the given name 'android:TextAppearance.Material.Widget.Button.Colored'.
Error:(3) Error retrieving parent for item: No resource found that matches the given name 'android:TextAppearance.Material.Widget.Button.Borderless.Colored'.
Error:(4) Error retrieving parent for item: No resource found that matches the given name 'android:TextAppearance.Material.Widget.Button.Colored'.
Error:Execution failed for task ':app:processDebugResources'.

com.android.ide.common.process.ProcessException: Failed to execute aapt

recyclerview中高亮具体的Item有问题

通过
View view = layoutManager.findViewByPosition(3);
或者
View view = mRecyclerView.getChildAt(3);
得到的view放到addHighLight里，
不能使具体的itemview高亮，直接APP无响应了卡死了。

提问须知

提问前，先完成以下步骤：
1.仔细阅读README的使用示例；
2.查看Wiki中的Q&A；
3.搜索Issues历史；

如果还没有找到你问题的解决方案，再提Issues，谢谢！

recyclerView怎么使用

混淆给一下

MIX 2 Android 7.0 的无法展示引导的问题

在Controller.java中添加
guideLayout.setLayerType(View.LAYER_TYPE_HARDWARE, null)
可以解决
应该是MIUI这个版本默认给View开启硬件加速的原因
另：如果还是无法显示尝试给guidelayout里面的View也关闭硬件加速，我是两个地方都加了的

高量控件黑屏

高量虚线正常，被圈控件以黑色填充显示

放在有百度地图上面，点击取消不了

放在有百度地图上面，点击取消不了
@kong-jing @huburt-Hu

怎么才能够让提示的布局正确的显示到被提示的View上呢？

怎么才能够让提示的布局正确的显示到被提示的View上呢？
如图：

然而不同手机屏幕尺寸也不同啊，如果通过引入布局修改布局的位置这样做就不现实了吧，有其他的办法吗？

addHighLight 中的padding 使HightLight 向下偏移，并没有在目标View四周设置padding

楼主，同一个页面有多个引导页如何使用这个库

每次第一页高亮的view没有高亮，要第二页的控件才高亮。

底层布局滑动事件没被拦截

出现引导层后，底层布局里的scrollview依然可以滑动

Demo中使用Shape类型为"CIRCLE",设置padding值是无效的。

             NewbieGuide.with(FirstActivity.this)
                    .setLabel("anchor")
                    .anchor(anchorView)
                    .alwaysShow(true)//总是显示，调试时可以打开
                    .addGuidePage(GuidePage.newInstance()
                            .addHighLight(btnAnchor, HighLight.Shape.CIRCLE, 1195)
                            .setLayoutRes(R.layout.view_guide_anchor))
                    .show();

你好，请看看

一点点想法。

我想既然不能智能的引导页的箭头指向高亮控件，是不是可以用PopupWindow来做这件事呢？一个全屏的半透明的PopupWindow，自定义一个布局，里面添加一个背景为白色的按钮，在引导的时候把按钮移动到需要高亮显示的控件上，可以在瞬间移动完成后在显示按钮。为了看的清内部逻辑，我让他三秒移动完，并且全程显示，写了个Demo，基本上能实现你写的效果，你觉得怎么样？
效果：

Fragment中高亮View问题

第一次显示fragment时，指定的view没有高亮；
调试发现，每次显示fragement高亮范围还不一样

activity show了没显示啥情况

如果要高亮Toolbar的三个点咋弄啊？

能知道大概位置，不过没法获取到那个view 咋整

默认显示一次不行

}).alwaysShow(false)//是否每次都显示，false为第一次显示

compile ('com.github.huburt-Hu:NewbieGuide:v2.0.0') {
    exclude group: 'com.android.support'
  }

v2.1.0版本升级bug。

v2.1.0修改了Controller.java中label的SharedPreferences存储类型为int，之前版本为boolean。如果从之前版本升级到v2.1.0，会报一下错误：
java.lang.ClassCastExcetion:java.lang.Boolean cannot be cast to java.lang.Integer;

修改label与旧版本不一致可解决。希望在readme中备注下。

高亮地方的颜色能不能自己设置？

产品需要实现强引导，高亮的view区域是否可以直接继承自己之前的点击事件，并且暴露一个可以自定义的点击事件出来？

感谢分享！1.x升级2.x思路更清晰了，期待更新

建议:可以队列式方式显示多个引导页

感谢楼主这个库,用了之后用引导页,的确省事好多.
但是使用过程中,当想实现一个一个显示不同引导页的时候,用现有库开放的Api,接口实现起来代码比较重复.(OnGuideChangedListener.onRemoved 的时候显示下一个Controller)
建议下一版本可以考虑添加管理多个Controller的控制类

浮层背景支持设置图片吗

三星galaxy s8的高亮区域是黑色的

mi 3效果是这样

高亮部分如能支持加线框更完美~~~~

例如：

如何指向recyclerview某一个item

解决了，自己的错误

NewbieGuide.with(getActivity())
            .setLabel("guide1")
            .addGuidePage(GuidePage.newInstance()
                    .addHighLight(llayout_novice_welfare)
                    .setLayoutRes(R.layout.view_guide_simple))
            .show();

demo中的代码直接复制过去都没用