Skip to content

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.

fix(openpaas): align directory manifest with official web2sp

yhh2a318a6863ed
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 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.mdx
index 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-party
directory 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 contract
host renders real exported 2D and 3D packages, but does not reproduce SUD's
diff --git a/docs/astro/src/content/docs/zh-cn/publishing/minigame-platforms.mdx b/docs/astro/src/content/docs/zh-cn/publishing/minigame-platforms.mdx
index 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.ts
index 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.ts
index 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');