A fast 2D and 3D game engine — TypeScript SDK, C++/WebAssembly core, visual editor. Ship one project to web, desktop, WeChat MiniGames, playable ads, and native Android / iOS.
TypeScript 2d-game-engine3d3d-game-engineandroidcppecsgame-editorgame-enginegamedeviostypescriptwebassemblywebglwebgpuwechat-minigame
docs: add v0.9.1 changelog (EN + ZH)
esengine028caa446809
diff --git a/docs/astro/astro.config.mjs b/docs/astro/astro.config.mjsindex 07f10fba9..dac0900e5 100644--- a/docs/astro/astro.config.mjs+++ b/docs/astro/astro.config.mjs@@ -151,6 +151,7 @@ export default defineConfig({label: 'Changelog',translations: { 'zh-CN': '更新日志' },items: [+ { label: 'v0.9.1', slug: 'changelog-v091' },{ label: 'v0.9.0', slug: 'changelog-v090' },{ label: 'v0.8.3', slug: 'changelog-v083' },{ label: 'v0.8.2', slug: 'changelog-v082' },diff --git a/docs/astro/src/content/docs/changelog-v091.mdx b/docs/astro/src/content/docs/changelog-v091.mdxnew file mode 100644index 000000000..967ef336e--- /dev/null+++ b/docs/astro/src/content/docs/changelog-v091.mdx@@ -0,0 +1,59 @@+---+title: v0.9.1+description: ESEngine v0.9.1 release notes+---++import { Aside } from '@astrojs/starlight/components';++<Aside type="tip">+v0.9.1 introduces one-click toolchain installation, dynamic engine compilation with configurable feature flags, and a series of security hardening and stability fixes.+</Aside>++## One-Click Toolchain Install++The Build Settings dialog now has an **Auto Install** button that downloads and configures the complete build toolchain (Emscripten 5.0.0, CMake, Python) in one click. No git, no manual setup, no network workarounds required.++- Pre-packaged per-platform archives (macOS `.tar.gz`, Windows `.zip`, Linux `.tar.gz`) hosted on GitHub Releases+- Real-time download progress with MB counter in a toast notification+- Automatic toolchain detection on launch — if emsdk is already on your PATH or was previously installed, it's picked up automatically+- **Select emsdk** button remains for advanced users who want to point to a custom installation++## Dynamic Engine Compilation++Engine WASM is now compiled on demand from bundled C++ source, replacing the pre-built binary approach. This enables:++- **Feature flags** — toggle Tilemap, Particles, Timeline, PostProcess, BitmapText, Spine per build config+- **Platform targets** — Web, WeChat MiniGame, and Playable (single-file) each get optimized output+- **Build cache** — identical configurations reuse cached artifacts; clean build available when needed+- **Spine version selection** — compile only the Spine runtime versions (3.8, 4.1, 4.2) your project uses+- **Physics module** — Box2D compiled as a separate WASM module, included only when enabled++## Bundled CMake++CMake is now automatically bundled in the editor's toolchain resources. Combined with the Python bundled inside emsdk, **zero external dependencies** are needed to build engine WASM — just click Auto Install and Build.++## Example Project Download Progress++Creating a project from a template now shows a download progress bar with percentage, so you can see exactly how far along the download is instead of staring at an unresponsive dialog.++## Security Hardening++- **Safe module loading** — `new Function()` dynamic code execution in SpineModuleLoader replaced with Blob URL dynamic imports, eliminating code injection risk+- **Project name validation** — project names are now validated against filesystem-unsafe characters (`<>:"/\|?*`), preventing path issues on Windows+- **Async error handling** — unhandled promise rejections in WASM instantiation, scene loading, and plugin lifecycle now have proper `.catch()` handlers with diagnostic messages++## Bug Fixes++### Runtime+- Fixed Spine animations not rendering in single-file playable ad exports+- Fixed Spine and Physics WASM modules failing to load in certain plugin configurations+- Fixed tilemap layers not being properly removed when entities are destroyed++### SDK+- Replaced silent `catch {}` blocks across the SDK with `console.warn` diagnostics — errors that were previously swallowed now produce visible warnings with context+- SDK sourcemaps are now automatically synced to the desktop app for accurate stack traces++### Build System+- Fixed Windows compatibility issues in the toolchain build pipeline+- Fixed cross-platform `tsc` PATH resolution in CI+- Data-driven toolchain packaging via manifest reduced bundled size from 665 MB to 7 MBdiff --git a/docs/astro/src/content/docs/zh/changelog-v091.mdx b/docs/astro/src/content/docs/zh/changelog-v091.mdxnew file mode 100644index 000000000..577dcac09--- /dev/null+++ b/docs/astro/src/content/docs/zh/changelog-v091.mdx@@ -0,0 +1,59 @@+---+title: v0.9.1+description: ESEngine v0.9.1 更新日志+---++import { Aside } from '@astrojs/starlight/components';++<Aside type="tip">+v0.9.1 带来了一键工具链安装、可配置特性标志的动态引擎编译,以及一系列安全加固和稳定性修复。+</Aside>++## 一键工具链安装++构建设置对话框新增 **Auto Install** 按钮,一键下载并配置完整的构建工具链(Emscripten 5.0.0、CMake、Python)。无需 git,无需手动配置,无需翻墙。++- 预打包的平台专属压缩包(macOS `.tar.gz`、Windows `.zip`、Linux `.tar.gz`),托管于 GitHub Releases+- 实时下载进度,Toast 通知中显示已下载/总大小的 MB 计数+- 启动时自动检测工具链 — 如果 emsdk 已在 PATH 中或之前已安装,会自动识别+- 保留 **Select emsdk** 按钮,供高级用户手动指定自定义安装路径++## 动态引擎编译++引擎 WASM 现在从内置 C++ 源码按需编译,取代之前预构建二进制的方式。这带来了:++- **特性标志** — 每个构建配置可独立开关 Tilemap、Particles、Timeline、PostProcess、BitmapText、Spine+- **平台目标** — Web、微信小游戏、Playable(单文件)各自生成优化输出+- **构建缓存** — 相同配置复用缓存产物;需要时可执行清理构建+- **Spine 版本选择** — 仅编译项目实际使用的 Spine 运行时版本(3.8、4.1、4.2)+- **物理模块** — Box2D 编译为独立 WASM 模块,仅在启用时包含++## 内置 CMake++CMake 现已自动内置于编辑器工具链资源中。配合 emsdk 内置的 Python,构建引擎 WASM **无需任何外部依赖** — 只需点击 Auto Install 再点击 Build。++## 示例项目下载进度++从模板创建项目时现在会显示下载进度条和百分比,让你清楚看到下载进展,而不是面对无响应的对话框等待。++## 安全加固++- **安全模块加载** — SpineModuleLoader 中的 `new Function()` 动态代码执行替换为 Blob URL 动态导入,消除代码注入风险+- **项目名称校验** — 项目名称现在会校验文件系统不安全字符(`<>:"/\|?*`),防止在 Windows 上出现路径问题+- **异步错误处理** — WASM 实例化、场景加载和插件生命周期中未处理的 Promise 拒绝现在有了正确的 `.catch()` 处理和诊断信息++## Bug 修复++### 运行时+- 修复 Spine 动画在单文件 Playable 广告导出中不渲染的问题+- 修复 Spine 和 Physics WASM 模块在特定插件配置下加载失败+- 修复实体销毁时 tilemap 图层未被正确移除++### SDK+- 将 SDK 中静默的空 `catch {}` 块替换为 `console.warn` 诊断信息 — 之前被吞掉的错误现在会产生带上下文的可见警告+- SDK sourcemap 现在自动同步到桌面应用,确保堆栈跟踪准确++### 构建系统+- 修复工具链构建管线中的 Windows 兼容性问题+- 修复 CI 中跨平台 `tsc` PATH 解析问题+- 通过 manifest 驱动的工具链打包,将内置体积从 665 MB 减至 7 MB