游戏引擎 / 系统课时
创建 2D 项目并运行场景
创建 2D 项目并运行场景
第一步要证明项目能够保存场景、加载脚本并进入预览,而不是只看到编辑器窗口。本节以 Cocos Creator 3.8.8 的 2D 项目为基准,用一个启动日志和可见标题验证完整入口。
学习目标
- 创建并保存可重复打开的 2D 项目
- 让指定场景进入预览并执行组件
- 区分编辑器场景与构建入口
建立最小场景
在 Cocos Dashboard 中先安装对应的 3.8 编辑器,再创建项目,选择 2D 模板并记录项目目录。不要用旧版本编辑器直接覆盖唯一副本;已有工程升级前应备份或提交版本记录。本课不依赖在线商城素材。
进入编辑器后,在资源管理器的 assets 下建立 scenes 和 scripts 文件夹。创建场景并保存为 Main.scene。在场景中保留 2D 显示所需的 Canvas 与相机,添加 Label,将文字改为 Hello 2D,放在 Canvas 中心。先保存场景,再检查层级中这些节点是否处于激活状态。
预览通常用于运行当前编辑场景;构建面板中的参与构建场景与初始场景需要单独确认。现在预览成功,并不能证明发布包也选中了 Main。为后续构建记下场景名,不通过临时切换编辑器标签来假定入口已配置。
用启动日志确认脚本执行
在 assets/scripts 新建 BootProbe.ts,保存以下完整组件,等待脚本编译完成。创建空节点 Runner,把组件挂在该节点上。脚本文件在资源目录中存在,不等于场景已经使用它。
import { _decorator, Component } from 'cc';
const { ccclass } = _decorator;
@ccclass('BootProbe')
export class BootProbe extends Component {
start(): void {
// 只在运行时首次启用后确认入口,避免逐帧刷屏
console.log('boot:Main');
}
}预期结果:点击预览后,画面显示 Hello 2D,运行控制台出现一次 boot:Main。重新启动一次预览会再出现一次,不要求编辑模式下也打印该日志。桌面浏览器预览可能把运行日志显示在浏览器开发者工具的 Console 中。
从入口检查失败点
若没有日志,先看脚本是否存在编译错误,再看 Runner 是否激活、组件是否启用以及当前运行场景是否确实为 Main。有日志却没文字时,转而检查 Label 的父节点、大小、颜色以及相机可见层;不要把渲染问题误诊为脚本没有执行。
关闭预览后重新打开工程和场景,再运行一次。这次检查能发现场景未保存、组件只在运行时临时添加等问题。编辑器恢复出的临时状态不能代替磁盘上的场景文件。运行时在层级里改位置的结果通常不会自动成为下次启动的初始值。
后续准备发布时,在构建面板明确加入 Main 并选定初始场景,再在构建产物中重复标题与日志检查。官方入门文档 可用于对照不同语言界面的入口名称。