mirror of https://github.com/potato47/ccc-devtools.git synced 2024-12-26 03:39:16 +00:00

Cocos Creator 网页调试工具，运行时查看、修改节点树，实时更新节点属性，可视化显示缓存资源。 https://forum.cocos.org/t/topic/91496

Go to file

KinnonZ d50d90d130 fix: 修正计时器未正确关闭的问题；适配3.8.x版本api		2024-10-30 17:07:06 +08:00
release	fix: 修正计时器未正确关闭的问题；适配3.8.x版本api	2024-10-30 17:07:06 +08:00
screenshots	更新预览	2022-08-04 16:30:12 +08:00
scripts	添加开关	2022-08-02 21:12:45 +08:00
src	fix: 修正计时器未正确关闭的问题；适配3.8.x版本api	2024-10-30 17:07:06 +08:00
.gitignore	改版;适配creator3.5	2022-07-17 16:48:06 +08:00
auto-imports.d.ts	改版;适配creator3.5	2022-07-17 16:48:06 +08:00
components.d.ts	update	2022-08-04 16:24:52 +08:00
index.html	update	2022-08-03 18:00:31 +08:00
LICENSE	Initial commit	2018-12-26 10:26:51 +08:00
package.json	添加开关	2022-08-02 21:12:45 +08:00
README.md	Update README.md	2022-12-10 22:55:35 +08:00
tsconfig.json	改版;适配creator3.5	2022-07-17 16:48:06 +08:00
tsconfig.node.json	改版;适配creator3.5	2022-07-17 16:48:06 +08:00
vite.config.ts	test	2022-07-26 20:05:42 +08:00
yarn.lock	添加开关	2022-08-02 21:12:45 +08:00

README.md

主干分支适用 Cocos Creator 3.4+ 版本，其他版本查看其他分支

ccc-devtools

简介

ccc-devtools 是一款用于 Cocos Creator 网页端预览的调试工具，可以实时显示场景的节点树，并对节点属性进行同步更改。

使用

下载打包好的 preview-template.zip 文件(release目录下)，解压到 Cocos Creator 项目目录下，刷新预览时的浏览器即可。节点属性修改不赘述，重点介绍几个独特的小功能：

输出节点、组件引用到控制台，配合调试比较常用

标记UI节点在场景中的位置

调试信息独立显示，再也不怕浅背景看不清 FPS 了

开发

项目依据文档中自定义预览模板一节进行开发，未接触过相关概念可以先阅读一下官方文档

自定义预览模板预览支持自定义模板方便用户自定义需要的预览效果，自定义的预览模板可以放置在项目目录的 preview-template 文件夹中。或者点击编辑器主菜单中的项目 -> 生成预览模板就可以在项目目录下创建一个最新的预览模板。编辑器中的预览也是使用模板来注入最新的项目数据，预览时将会查找该目录下的 index 文件，如果存在就是要该文件作为预览的模板。 preview-template 文件夹的结构类似：
project-folder
|--assets
|--build
|--preview-template
    // 必须的入口文件
    |--index.ejs
    // 其他文件可根据想要实现的预览效果进行添加

本项目主要修改index.ejs，注入一段 Vue 绑定的自定义html，核心修改见下图

在浏览器环境中 cc 是一个全局变量，可以通过 cc.director.getScene().children 获取场景中的节点，知道这点就可以开发了，剩下的就是节点数据如何展示出来的问题了。技术栈为 Vue3 + ElementPlus + TypeScript + Vite，熟悉前端的朋友欢迎来仓库贡献。项目结构如下：