cocos creator inspector:chrome插件功能介绍

5,105 阅读6分钟

插件介绍

这是一个免费的Chrome扩展,开箱即用,无须任何额外的安装,可以帮助你调试CocosCreator制作的游戏,显示游戏运行的节点树,以及节点树的组件属性,在排查游戏问题时,非常有帮助。

功能详细介绍

支持调试Creator2.x和Creator3.x制作的Cocos游戏。

image.png

image.png

支持webview/iframe嵌套调试

制作的游戏如果嵌套在webview/iframe中,无论嵌套多深,在同样也支持调试,并且支持自由切换调试目标。

如下图所示,即使iframe里面包含多个游戏,同样也是支持的。

1.gif

节点树

节点图标

每个节点都会显示icon图标,如果一个节点上有多个组件,目前的规则是根据字母顺序优先,比如Widge+Spirte,那么显示的图标就是Sprite,目前来说体验符合预期。

image.png

如果想隐藏icon图标,只需要右键点击tree icon即可

image.png

节点颜色

如果颜色为绿色,表示节点和prefab有关系

image.png

用户脚本标识

节点如果带有用户脚本,会显示TS图标,当鼠标长时间放上去后,会显示脚本的名字。

image.png

自动刷新节点树及其状态

1.gif

快速折叠、展开、选中节点树(上下左右方向键)

在层级管理器中,支持使用上下左右方向键快速折叠、展开、选中节点树。 1.gif

控制节点显示隐藏(空格快捷键)

在层级管理器中,支持使用空格快捷键,控制节点的显示隐藏。

1.gif

销毁节点

在层级管理器中,右键选择destroy销毁某个节点。

1.gif

节点滑过选中,游戏内同步框选节点

  • 当鼠标滑过节点树时,游戏会实时高亮节点的区域
  • 节点树选中某个节点时,游戏会框选节点。

这种方式非常方便我们在观察节点树时,同步观察游戏内的节点位置。

1.gif

如果想关闭该功能,只需在鼠标右键,取消勾选对应的菜单选项即可

image.png

设置刷新

插件默认是自动刷新,部分用户反馈可能存在插件使用久了,页面有发生崩溃的情况,考虑到可能有时不希望自动刷新,所以在节点树和属性里面分别加入了手动控制刷新的菜单。

image.png

节点Touch事件回调函数的代码追踪

有时想要追踪节点的Touch事件,在没有通读代码的情况下,是一件比较麻烦的事情,现在只需要在节点树上右键,如果节点有Touch事件注册,就会如下图显示:

image.png

  • button-events: 对应Button组件的clickEvents
  • touch-start / touch-move / touch-end / touch-cancel:节点的Touch事件

如果对应的事件没有,则不会出现对应的选项,[1]表示该节点有1个该事件,如果有多个的话,选择后会展示具体的注册事件列表,为了方便快速区分,鼠标在滑过时,会显示其对应的代码实现。

two.gif

选择想要的事件回调,就会自动打开source面板,并聚焦到对应的代码处。

总体的使用效果如下,追踪节点的点击事件代码非常方便。

GIF 2025-2-11-周二 下午 9-03-57.gif

节点搜索

节点树支持搜索过滤显示节点,当节点树发生变动时,同样也会自动更新搜索结果

image.png

默认会对每个节点的名字进行模糊匹配,比如下图所示:

image.png

因为abcdabc这两个结果中,先匹配字符a,再匹配字符c,即使中间出现了字符b,也不影响,会自动跳过。

即按照字符的出现顺序,进行匹配。

如果匹配到子节点,同时会显示其父节点,方便看到在整个节点树中的位置

image.png

匹配大小写

当启用后,在进行字符匹配时,会严格区分大小写

路径匹配

基于字符匹配的规则,以/为分割符

image.png

image.png

fps显示隐藏

在层级管理器右键菜单的 fps show / fps hide 的选项。

属性检查起器

引用属性,支持在节点树中高亮显示。

属性检查器中如果属性引用了节点,支持在节点树中高亮显示引用

1.gif

属性支持属性精简显示和全部显示

方便在不同情况下观察属性。

2.gif

支持鼠标拖拉调整数值

在调整坐标时,非常方便。

1.gif

小细节:如果widget组件会影响坐标,对应的坐标轴会禁止修改,并且会提示对应的原因。

image.png

支持在控制台打印组件,方便观察全貌。

1.gif

游戏小助手

当安装插件后,会自动在游戏页面停靠小助手图标,里面集成了一些对游戏调试非常有帮助的功能。

image.png

调整位置

当小助手的位置干扰到观察游戏时,可以拖拽调整到合适的位置。

1.gif

自动隐藏

通过点击小助手的图标,可以展开折叠,为了进一步降低对用户的干扰,小助手会2s内自动收缩

1.gif

如果你不希望小助手自动收缩,右键小助手图标,选择auto hide菜单,当看到菜单前边的勾选图标时,即表示当前该功能是生效的

1.gif

快捷键支持

打开设置界面

image.png

可以预设一些操作的快捷键

image.png

暂停游戏

如上图设置,当按下Space按键时,就能控制游戏的暂停和运行,方便定位游戏的某一帧。

2025-03-08 14-25-19.gif

不激活编辑器,刷新游戏

image.png

比如我们修改了脚本的某个变量、TiledMap等资源等,正常情况下,我们需要再返回Creator编辑器,触发编辑器去刷新游戏。

Cocos文档中也有提及如何配置VSCode编译任务,虽然VSCode可以配置快捷键,不过还是需要你手动在VSCode中手动触发下,没有直接在游戏中通知刷新更加方便。

配置Game Fresh的快捷键后,就可以在游戏页面直接刷新,实现不激活编辑器,强制刷新游戏的效果。

手动拾取游戏节点

点击cocos小助手图标,选择inspect按钮(鼠标右键取消inspect操作),当鼠标滑过节点时,会自动高亮该节点,当选中节点后,节点树会同步展开并选择该节点。

1.gif

右键inspect会弹出更多的设置功能

image.png

清理Inspect选框(Clear)

清理游戏的Inspect框选结果,部分情况下可能会导致Inspect选框无法清除。

拾取鼠标位置的顶部节点(Pick Top)
  • 选中Pick Top,表示只拾取鼠标位置,最顶部的节点。

  • 取消Pick Top,会列出来鼠标位置下所有命中的节点,需要用户自己选择目标节点。

1.gif

拾取指定类型的节点

有时我只想拾取指定类型的节点,需要先启用Filter Enabled,然后在多选类型

image.png

如上图所示,在Inspect时,只会选择Sprite类型的节点,这在已知类型的情况下,Inspect更加省力。

游戏开发工具收录

在弹窗界面,追加了自己制作的游戏开发工具。

image.png

推荐插件

购物车图标,会打开作者自己的推荐插件,都是本人自己开发的,游戏开发过程中会经常使用的到一些插件。

image.png