# @flare-engine/core 中文文档

规范地址：https://npmcn.com/package/%40flare-engine/core/

版本：0\.4\.12
npm 元数据更新时间：2026-11-12T19:45:45.868Z
中文译文更新时间：2026-11-14T21:31:22.773Z
软件包许可：Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40flare-engine/core
原文对照：https://npmcn.com/package/%40flare-engine/core/?lang=original
项目主页：https://github.com/grzott/flare-engine#readme
源码仓库：https://github.com/grzott/flare-engine

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：149 kB，12 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=20
- 运行依赖：2 个
- 首次发布：2026-06-09T16:19:37.190Z
- 最新版本发布：2026-11-12T19:45:45.492Z
- 近 30 天下载量：3160（2026-10-15 至 2026-11-13，npm 官方下载统计）
- 已发布版本数：17（近 12 个月 17 个）

## 中文简介

GameLoop、 时钟、 applife循环、 池、 花圈

## 安装

```sh
npm install @flare-engine/core
```

也可以使用：`pnpm add @flare-engine/core`、`yarn add @flare-engine/core`、`bun add @flare-engine/core`

## README

# @ flare- engine/ 核心

核心运行时间 - `GameLoop` (固定时间步,与上上上上上上上上上上上上上上上上上上上上上上上上上上上上上上上上上上上上上上上上上上上上上上上上上上上上下上上上上上上上上上上上上上上上上上上上上上下上上下上下上上下上下上下上上上上上上上上上下上上上下上上上上上上上上上上上上上上上上上上上上上上上上上上上上上上上上上上上上上上上上上上上上上上上上上上上上上上上上上上上上上上上下上上上上上上上上上上下上上下上上上上上上上上下上上上上上上上上上上上上上上上上上上下上上上上上上上上上上上上上上上上上上上上上上上上上上上下上上下上上上上上上上上上上上上, `Clock` (德尔塔+缩放时间), `AppLifecycle` (背景/前钩), `ScreenManager` (FIT / FILL / STRETCH + 安全区域), `CoroutineManager` (基于基因的测序), `Pool<T>` (零分配重用).

## 安装

```sh
bun add @flare-engine/core
```

## 使用量

```ts
import { GameLoop, Pool } from '@flare-engine/core';

function updateGame(dt: number): void {
  // advance game state by dt seconds
}

const loop = new GameLoop({ fixedDt: 1 / 60 });
loop.onUpdate.add((dt) => updateGame(dt));
loop.start();

const bullets = new Pool(() => ({ x: 0, y: 0, vx: 0, vy: 0 }));
const b = bullets.acquire();
bullets.release(b);
```

## 锦衣裙

`yield` 一个数字等待 这么多缩放秒, `undefined` 等待一个框架,或承诺 等着 一个胸围完全结束了 三种方式之一——完成, `cancelled`,或 `failed` - 和 `handle.done` 三者皆为真相. `cancel()` 财务报告和审定财务报表 `clear()` 两者都关闭生成器( 一个场景) 撕裂是coroutine认为的取消,所以 `finally` 块是 清理工作——在完成、取消、拆卸和失败时进行。 一个被拒绝的承诺是: 把它扔进发电机里 抓住它继续前进 或让它用 `failed` 设定 :

```ts
import { CoroutineManager } from '@flare-engine/core';

const coroutines = new CoroutineManager();
let bannerVisible = false;

const handle = coroutines.start(
  (function* () {
    try {
      bannerVisible = true;
      yield 2; // seconds, scaled time
      yield fetch('/api/score'); // a rejection is thrown into the generator
      yield undefined; // one frame
    } finally {
      bannerVisible = false; // runs on completion, cancel(), clear() and failure
    }
  })(),
);

// each frame
coroutines.update(1 / 60);

if (handle.failed) {
  console.warn('score fetch failed', handle.error);
} else if (handle.cancelled) {
  // ended early — cancel(), or the scene's clear() tore it down
}
handle.cancel(); // no-op once done; otherwise the finally block runs now
```

失败永远不会被重新评为无所顾忌的拒绝——手柄是唯一的通道,所以保留它 如果你需要知道的话。 测试 `handle.failed` 而不是说 `handle.error`: 一个赤裸的 `reject()` 拒绝 与 `undefined`。 。 。 .

见 [API 规格](https://github.com/grzott/flare-engine/blob/main/docs/design/api-specs.md#flare-enginecore--3kb-gzip)。 。 。 .

## 许可证

阿帕奇 - 2.0

## 常见问题

### @flare-engine/core 是什么？

GameLoop、 时钟、 applife循环、 池、 花圈

### 如何安装 @flare-engine/core？

在项目目录运行 npm install @flare-engine/core，或使用 pnpm add / yarn add / bun add。

### @flare-engine/core 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @flare-engine/core 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @flare-engine/core 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=20。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @flare-engine/core 可以商用吗？

@flare-engine/core 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @flare-engine/core 的下载量有多少？

根据 npm 官方下载统计，@flare-engine/core 在 2026/10/15 – 2026/11/13 这 30 天内被下载 3,160 次，日均约 105 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @flare-engine/core 还在维护吗？

最新版本 0\.4\.12 发布于 2026/11/13（3 天前）；至今共发布 17 个版本，其中过去 12 个月发布了 17 个；首次发布于 2026/06/10。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。