50 lines
1.7 KiB
Markdown
50 lines
1.7 KiB
Markdown
# 项目结构图与运行入口说明（1 分钟版）
|
||
|
||
## 一、项目结构图
|
||
|
||
```text
|
||
test/
|
||
├─ index.html # 页面入口（直接在浏览器打开）
|
||
├─ styles.css # 页面样式
|
||
├─ app.js # 生命游戏核心引擎 + UI 交互控制
|
||
├─ tests/
|
||
│ └─ life-demo.test.js # Node 测试（核心规则与状态逻辑）
|
||
└─ docs/
|
||
└─ 项目结构图与运行入口说明.md # 本说明文档
|
||
```
|
||
|
||
## 二、运行入口
|
||
|
||
### 1) 浏览器入口（交互演示）
|
||
|
||
- 入口文件：`index.html`
|
||
- 加载脚本：`index.html` 底部通过 `<script src="./app.js"></script>` 引入引擎与交互逻辑。
|
||
- 打开方式：双击 `index.html`（或在浏览器中打开本地文件）。
|
||
|
||
### 2) 脚本初始化入口
|
||
|
||
- `app.js` 在 `DOMContentLoaded` 后执行 `initDemo()`，完成：
|
||
- 初始状态创建（默认预设、网格尺寸、暂停状态）
|
||
- 画布渲染与动画循环
|
||
- 控件事件绑定（开始/暂停、单步、清空、随机、重置预设、速度滑条）
|
||
- 画布点击/拖拽绘制
|
||
|
||
## 三、关键代码定位
|
||
|
||
- 预设图案定义：`app.js:4`
|
||
- 交互初始化入口：`app.js:368`
|
||
- 开始/暂停等主控事件：`app.js:430`
|
||
- Node 导出（供测试复用）：`app.js:540`
|
||
- 测试起始位置：`tests/life-demo.test.js:14`
|
||
|
||
## 四、测试入口
|
||
|
||
- 测试文件：`tests/life-demo.test.js`
|
||
- 推荐命令（当前环境可用）：
|
||
|
||
```bash
|
||
node tests/life-demo.test.js
|
||
```
|
||
|
||
> 说明：在当前受限环境下，`node --test tests/life-demo.test.js` 可能因子进程权限报 `EPERM`，但直接执行测试文件可正常完成 9 项测试。
|