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(release): prepare v0.77.0 candidate and portable validation

yhha0fec6140cbb
diff --git a/.github/workflows/release-first-screen.yml b/.github/workflows/release-first-screen.yml
new file mode 100644
index 000000000..82ebef873
--- /dev/null
+++ b/.github/workflows/release-first-screen.yml
@@ -0,0 +1,45 @@
+name: Release first screen
+on:
+ workflow_dispatch:
+ inputs:
+ artifact-run:
+ description: Run containing the web WASM artifact to measure
+ type: string
+ required: true
+permissions:
+ contents: read
+ actions: read
+jobs:
+ first-screen:
+ runs-on: ubuntu-latest
+ timeout-minutes: 15
+ steps:
+ - uses: actions/checkout@v7
+ - uses: ./.github/actions/setup
+ - uses: ./.github/actions/editor-host
+ - name: Download the measured engine
+ env:
+ GH_TOKEN: ${{ github.token }}
+ ARTIFACT_RUN: ${{ inputs.artifact-run }}
+ run: gh run download "$ARTIFACT_RUN" --repo esengine/estella --name wasm-web --dir build/wasm/web
+ - name: Build SDK and export the first-screen subject
+ run: |
+ pnpm --filter ./sdk build
+ node pipeline/bin/estella.mjs export examples/input-actions --platform web --out out/first-screen
+ - name: Measure the presented start screen
+ run: |
+ node --input-type=module <<'JS'
+ import { runElectron } from './tools/lib/electronRun.mjs';
+ import { GOLDEN, firstScreenFor } from './tools/goldenProjects.mjs';
+ const g = GOLDEN.find(g => g.id === 'input-actions');
+ const claim = firstScreenFor(g);
+ const r = runElectron(['tools/launchers/launch-export.mjs', '--dir', 'out/first-screen',
+ '--boot', '--throttle', claim.link, '--timeout', '120000', '--settle', '10'],
+ { encoding: 'utf8', timeout: 150000 });
+ process.stdout.write(r.stdout || '');
+ process.stderr.write(r.stderr || '');
+ const match = /boot: (\{.*\})/.exec(r.stdout || '');
+ const boot = match ? JSON.parse(match[1]) : null;
+ if (r.status !== 0 || boot?.firstScreenMs == null || boot.firstScreenMs > claim.maxMs
+ || !boot.monotonic || boot.stillMs > claim.maxStillMs) process.exit(1);
+ JS
diff --git a/tools/launchers/launch-export.mjs b/tools/launchers/launch-export.mjs
index 5bc0e3beb..669ba6f8f 100644
--- a/tools/launchers/launch-export.mjs
+++ b/tools/launchers/launch-export.mjs
@@ -128,6 +128,11 @@ const BOOT_RECORDER = `(() => {
.find((p) => p.name === 'first-contentful-paint');
return {
firstScreenMs: paint ? Math.round(paint.startTime) : null,
+ navigation: (() => {
+ const n = performance.getEntriesByType('navigation')[0];
+ return n ? { responseStart: n.responseStart, responseEnd: n.responseEnd,
+ domInteractive: n.domInteractive, domContentLoaded: n.domContentLoadedEventEnd } : null;
+ })(),
firstFrameMs: firstFrame,
marks,
};
@@ -271,6 +276,12 @@ const SCENE = flag('scene', '');
// A window that has never navigated answers no CDP command — `Page.enable`
// simply never resolves. One blank document is enough to make it a page.
await win.loadURL('about:blank');
+ if (BOOT) {
+ // Players navigate in an already-presented browser. Settle the virtual
+ // desktop compositor before navigation timing starts, not during it.
+ win.showInactive();
+ await win.webContents.capturePage();
+ }
win.webContents.debugger.attach('1.3');
await win.webContents.debugger.sendCommand('Page.enable');
if (THROTTLE) {
@@ -294,7 +305,6 @@ const SCENE = flag('scene', '');
// Paint Timing excludes a page hidden before its first contentful paint.
// A boot measurement must present the page before navigation; background
// throttling alone only keeps its JavaScript running. Do not steal focus.
- if (BOOT) win.showInactive();
await win.loadURL(base);
// A boot measurement waits for the boot, not for a canvas with a size: the