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
fix(openpaas): align directory manifest with official web2sp
yhh2a318a6863ed
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex d854858d3..4b30dcd3a 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -17,6 +17,7 @@ published separately; it ships inside the editor.### Added- **SUD OpenPaaS development export.** An opt-in project platform preset exports a `main.js` directory for PinK's third-party builder. Its SDK profile bridges `sud`, package-file WASM loading, XHR, WebSocket and localStorage through the shared 2D/3D mini-game runtime. Headless checks exercise real exported 2D and 3D frames, including a WASM result without `module`; PinK packaging and Android/iOS acceptance remain pending. Login, ads, payment, WebGPU and EmscriptenGLX are not enabled by this initial integration.+ The directory includes the initial `manifest.json` emitted by the official web2sp converter. That converter produces a SUD project directory, not a binary `.sp` file; final package generation remains separate from directory export.- **Plugin filesystem operations.** Editor plugins can read and write binary assets directly, list directories, inspect files, create folders, rename and delete in their own directory or the capability-gated project scope. Moves preserve asset UUID sidecars, deletion uses the OS trash, and project edits join the existing file journal. User-installed plugins outside the project are supported; generated plugin data no longer repeatedly reloads its producer. Addresses [#99](https://github.com/esengine/estella/issues/99).diff --git a/docs/astro/src/content/docs/publishing/minigame-platforms.mdx b/docs/astro/src/content/docs/publishing/minigame-platforms.mdxindex 2e457ec90..d93eaeff5 100644--- a/docs/astro/src/content/docs/publishing/minigame-platforms.mdx+++ b/docs/astro/src/content/docs/publishing/minigame-platforms.mdx@@ -50,6 +50,13 @@ Open the development version in OpenPaaS and scan its package QR code with**Hello PinK**. The supplied Unity and Laya guides use this same third-partydirectory workflow; their engine-specific converters are not required here.+The official [web2sp 1.0.0 archive](https://download.sudden.ltd/assets/openpaas/guide/attachment/web2sp-1.0.0.tgz)+has been inspected and exercised. It detects Laya HTML, copies the Web directory,+emits `main.js` and `laya_adapter.js`, and creates an empty `manifest.json` when+none exists. It does not contain a binary `.sp` packer. Estella emits its own+runtime entry and the same initial manifest directly. A final `.sp` still needs+the platform packer; uploading, review and publishing remain user-managed.+<Aside type="caution">**Development integration, device acceptance pending.** The headless contracthost renders real exported 2D and 3D packages, but does not reproduce SUD'sdiff --git a/docs/astro/src/content/docs/zh-cn/publishing/minigame-platforms.mdx b/docs/astro/src/content/docs/zh-cn/publishing/minigame-platforms.mdxindex 21a820299..53d1457e1 100644--- a/docs/astro/src/content/docs/zh-cn/publishing/minigame-platforms.mdx+++ b/docs/astro/src/content/docs/zh-cn/publishing/minigame-platforms.mdx@@ -42,6 +42,11 @@ iOS 仅返回 instance、没有编译后 module 的结果。在 OpenPaaS 的开发版本详情中,用 **Hello PinK** 扫描包链接二维码调试。提供的 Unity / Laya 指南采用的也是这个第三方目录流程;这里不需要安装它们各自的转换插件。+已下载、检查并实际运行官方 [web2sp 1.0.0](https://download.sudden.ltd/assets/openpaas/guide/attachment/web2sp-1.0.0.tgz):+它识别 Laya HTML,复制 Web 目录,生成 `main.js`、`laya_adapter.js`,并在缺失时创建+内容为 `{}` 的 `manifest.json`。工具没有二进制 `.sp` 封装实现。Estella 直接生成自己的+运行入口及相同的初始 manifest;最终 `.sp` 仍需平台封装工具,上传、审核和发布由用户处理。+<Aside type="caution">**当前为开发接入,真机验收待完成。** 无窗口契约宿主已能加载真实引擎和导出的2D / 3D 场景,但无法复现 SUD 原生渲染、音频和 iOS WASM 实现。diff --git a/pipeline/src/export/miniGameExportProfile.ts b/pipeline/src/export/miniGameExportProfile.tsindex 21a345e94..c6367d2a2 100644--- a/pipeline/src/export/miniGameExportProfile.ts+++ b/pipeline/src/export/miniGameExportProfile.ts@@ -315,7 +315,9 @@ export const openpaasExportProfile: MiniGameExportProfile = {if (ctx.subPackages.length || ctx.hasOpenData) {throw new Error('OpenPaaS third-party export does not yet support subpackages or an open-data context');}- return [{ file: 'OPENPAAS.txt', content:+ // Official web2sp 1.0.0 emits an empty manifest for a new SUD project.+ // Platform/game fields are supplied later by the package builder.+ return [{ file: 'manifest.json', content: '{}\n' }, { file: 'OPENPAAS.txt', content:`Estella / SUD OpenPaaS development package\n`+ `Project: ${ctx.title}\nOrientation: ${ctx.orientation}\n`+ 'In PinK select Project > Third-party generated and choose this directory.\n'diff --git a/pipeline/tests/export-openpaas.test.ts b/pipeline/tests/export-openpaas.test.tsindex 85ddc671c..91ac46207 100644--- a/pipeline/tests/export-openpaas.test.ts+++ b/pipeline/tests/export-openpaas.test.ts@@ -59,6 +59,7 @@ describe('OpenPaaS third-party directory export', () => {expect(entry).not.toContain('loadSubpackage');expect(existsSync(path.join(out, 'game.js'))).toBe(false);expect(existsSync(path.join(out, 'project.config.json'))).toBe(false);+ expect(JSON.parse(readFileSync(path.join(out, 'manifest.json'), 'utf8'))).toEqual({});expect(existsSync(path.join(out, 'wasm/esengine.wxgame.wasm'))).toBe(true);expect(existsSync(path.join(out, 'wasm/esengine.wxgame.wasm.br'))).toBe(false);expect(readFileSync(path.join(out, 'scenes/2d.json'), 'utf8')).toContain('Sprite');