插件介绍
这是一个免费的Chrome扩展,开箱即用,无须任何额外的安装,可以帮助你调试CocosCreator制作的游戏,显示游戏运行的节点树,以及节点树的组件属性,在排查游戏问题时,非常有帮助。
- cocos论坛: forum.cocos.org/t/topic/164…
- youtube: www.youtube.com/watch?v=ajM…
- bilibili: www.bilibili.com/video/BV1jz…
- store: store.cocos.com/app/detail/…
- github: github.com/tidys/cc-in…
- edge: microsoftedge.microsoft.com/addons/deta…
- 国内Chrome插件同步镜像:www.crxsoso.com/webstore/de…
功能详细介绍
支持调试Creator2.x和Creator3.x制作的Cocos游戏。
支持webview/iframe嵌套调试
制作的游戏如果嵌套在webview/iframe中,无论嵌套多深,在同样也支持调试,并且支持自由切换调试目标。
如下图所示,即使iframe里面包含多个游戏,同样也是支持的。
节点树
节点图标
每个节点都会显示icon图标,如果一个节点上有多个组件,目前的规则是根据字母顺序优先,比如Widge+Spirte,那么显示的图标就是Sprite,目前来说体验符合预期。
如果想隐藏icon图标,只需要右键点击tree icon即可
节点颜色
如果颜色为绿色,表示节点和prefab有关系
用户脚本标识
节点如果带有用户脚本,会显示TS图标,当鼠标长时间放上去后,会显示脚本的名字。
自动刷新节点树及其状态
快速折叠、展开、选中节点树(上下左右方向键)
在层级管理器中,支持使用上下左右方向键快速折叠、展开、选中节点树。
控制节点显示隐藏(空格快捷键)
在层级管理器中,支持使用空格快捷键,控制节点的显示隐藏。
销毁节点
在层级管理器中,右键选择destroy销毁某个节点。
节点滑过选中,游戏内同步框选节点
- 当鼠标滑过节点树时,游戏会实时高亮节点的区域
- 节点树选中某个节点时,游戏会框选节点。
这种方式非常方便我们在观察节点树时,同步观察游戏内的节点位置。
如果想关闭该功能,只需在鼠标右键,取消勾选对应的菜单选项即可
设置刷新
插件默认是自动刷新,部分用户反馈可能存在插件使用久了,页面有发生崩溃的情况,考虑到可能有时不希望自动刷新,所以在节点树和属性里面分别加入了手动控制刷新的菜单。
节点Touch事件回调函数的代码追踪
有时想要追踪节点的Touch事件,在没有通读代码的情况下,是一件比较麻烦的事情,现在只需要在节点树上右键,如果节点有Touch事件注册,就会如下图显示:
- button-events: 对应Button组件的clickEvents
- touch-start / touch-move / touch-end / touch-cancel:节点的Touch事件
如果对应的事件没有,则不会出现对应的选项,[1]表示该节点有1个该事件,如果有多个的话,选择后会展示具体的注册事件列表,为了方便快速区分,鼠标在滑过时,会显示其对应的代码实现。
选择想要的事件回调,就会自动打开source面板,并聚焦到对应的代码处。
总体的使用效果如下,追踪节点的点击事件代码非常方便。
节点搜索
节点树支持搜索过滤显示节点,当节点树发生变动时,同样也会自动更新搜索结果
默认会对每个节点的名字进行模糊匹配,比如下图所示:
因为abcd、abc这两个结果中,先匹配字符a,再匹配字符c,即使中间出现了字符b,也不影响,会自动跳过。
即按照字符的出现顺序,进行匹配。
如果匹配到子节点,同时会显示其父节点,方便看到在整个节点树中的位置
匹配大小写
当启用后,在进行字符匹配时,会严格区分大小写
路径匹配
基于字符匹配的规则,以/为分割符
fps显示隐藏
在层级管理器右键菜单的 fps show / fps hide 的选项。
属性检查起器
引用属性,支持在节点树中高亮显示。
属性检查器中如果属性引用了节点,支持在节点树中高亮显示引用
属性支持属性精简显示和全部显示
方便在不同情况下观察属性。
支持鼠标拖拉调整数值
在调整坐标时,非常方便。
小细节:如果widget组件会影响坐标,对应的坐标轴会禁止修改,并且会提示对应的原因。
支持在控制台打印组件,方便观察全貌。
游戏小助手
当安装插件后,会自动在游戏页面停靠小助手图标,里面集成了一些对游戏调试非常有帮助的功能。
调整位置
当小助手的位置干扰到观察游戏时,可以拖拽调整到合适的位置。
自动隐藏
通过点击小助手的图标,可以展开折叠,为了进一步降低对用户的干扰,小助手会2s内自动收缩
如果你不希望小助手自动收缩,右键小助手图标,选择auto hide菜单,当看到菜单前边的勾选图标时,即表示当前该功能是生效的
快捷键支持
打开设置界面
可以预设一些操作的快捷键
暂停游戏
如上图设置,当按下Space按键时,就能控制游戏的暂停和运行,方便定位游戏的某一帧。
不激活编辑器,刷新游戏
比如我们修改了脚本的某个变量、TiledMap等资源等,正常情况下,我们需要再返回Creator编辑器,触发编辑器去刷新游戏。
Cocos文档中也有提及如何配置VSCode编译任务,虽然VSCode可以配置快捷键,不过还是需要你手动在VSCode中手动触发下,没有直接在游戏中通知刷新更加方便。
配置Game Fresh的快捷键后,就可以在游戏页面直接刷新,实现不激活编辑器,强制刷新游戏的效果。
手动拾取游戏节点
点击cocos小助手图标,选择inspect按钮(鼠标右键取消inspect操作),当鼠标滑过节点时,会自动高亮该节点,当选中节点后,节点树会同步展开并选择该节点。
右键inspect会弹出更多的设置功能
清理Inspect选框(Clear)
清理游戏的Inspect框选结果,部分情况下可能会导致Inspect选框无法清除。
拾取鼠标位置的顶部节点(Pick Top)
-
选中
Pick Top,表示只拾取鼠标位置,最顶部的节点。 -
取消
Pick Top,会列出来鼠标位置下所有命中的节点,需要用户自己选择目标节点。
拾取指定类型的节点
有时我只想拾取指定类型的节点,需要先启用Filter Enabled,然后在多选类型
如上图所示,在Inspect时,只会选择Sprite类型的节点,这在已知类型的情况下,Inspect更加省力。
游戏开发工具收录
在弹窗界面,追加了自己制作的游戏开发工具。
推荐插件
购物车图标,会打开作者自己的推荐插件,都是本人自己开发的,游戏开发过程中会经常使用的到一些插件。