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(guides): retake the screenshots the Package dialog rewrite invalidated
esenginecd4ad69ac22b
diff --git a/docs/astro/src/assets/guides/en/hot-update-build-cdn.png b/docs/astro/src/assets/guides/en/hot-update-build-cdn.pngindex f22d389b8..fa180abc4 100644Binary files a/docs/astro/src/assets/guides/en/hot-update-build-cdn.png and b/docs/astro/src/assets/guides/en/hot-update-build-cdn.png differdiff --git a/docs/astro/src/assets/guides/en/import-platform-overrides.png b/docs/astro/src/assets/guides/en/import-platform-overrides.pngnew file mode 100644index 000000000..746e39412Binary files /dev/null and b/docs/astro/src/assets/guides/en/import-platform-overrides.png differdiff --git a/docs/astro/src/assets/guides/zh/hot-update-build-cdn.png b/docs/astro/src/assets/guides/zh/hot-update-build-cdn.pngindex 5d484e973..65c0f854e 100644Binary files a/docs/astro/src/assets/guides/zh/hot-update-build-cdn.png and b/docs/astro/src/assets/guides/zh/hot-update-build-cdn.png differdiff --git a/docs/astro/src/assets/guides/zh/import-platform-overrides.png b/docs/astro/src/assets/guides/zh/import-platform-overrides.pngnew file mode 100644index 000000000..96d3b265cBinary files /dev/null and b/docs/astro/src/assets/guides/zh/import-platform-overrides.png differdiff --git a/docs/astro/src/content/docs/guides/assets.mdx b/docs/astro/src/content/docs/guides/assets.mdxindex 3768d8ffe..62f6414f6 100644--- a/docs/astro/src/content/docs/guides/assets.mdx+++ b/docs/astro/src/content/docs/guides/assets.mdx@@ -119,9 +119,9 @@ way it can:- **Compress textures** — encode PNGs to GPU-ready **KTX2** (Basis Universal),which the runtime transcodes to the best format the device supports (ASTC → ETC2→ S3TC, falling back to RGBA8), mip chain included. Per-asset **Import Settings**- decide this, with a tab per platform, so a texture can be compressed harder for a- phone than for the web; the Package dialog's **Compression** switch only chooses- whether to honor those settings or skip them all.+ decide this, with a tab per platform (below), so a texture can be compressed+ harder for a phone than for the web; the Package dialog's **Compression** switch+ only chooses whether to honor those settings or skip them all.- **Content-address** — name each shipped file by a hash of its bytes, so URLsare immutable and identical files dedupe to a single copy. On by default forWeb/Desktop.@@ -129,6 +129,10 @@ way it can:them into atlas pages (with the frame UVs written into the manifest), so manysmall sprites ship as one texture and batch in one draw call.+++*A texture's **Platform Overrides**: each target gets its own tab, and a platform that overrides nothing follows the Default settings above it.*+### Shipping what only code namesReachability is what keeps a build from shipping everything — and it is **blind todiff --git a/docs/astro/src/content/docs/guides/hot-update.mdx b/docs/astro/src/content/docs/guides/hot-update.mdxindex ffd1aeb55..f3189293e 100644--- a/docs/astro/src/content/docs/guides/hot-update.mdx+++ b/docs/astro/src/content/docs/guides/hot-update.mdx@@ -91,11 +91,11 @@ fallback when a project has no `asset-groups.json`.)Remote-group assets need a **root URL** to fetch from — your CDN. It's a **buildprofile** setting, so `dev` and `prod` can point at different CDNs, and theexport bakes the active profile's root into the shipped game. Set it in the-**Build** dialog (**File → Build…**):+**Package Project** dialog (**File → Build…**), under **Advanced**:-+-*The **CDN root (hot-update)** field in the Build dialog writes the active profile's `remoteRoot` to `asset-groups.json`. Leave it empty to load remote assets same-origin (e.g. for local testing).*+*The **CDN root** field writes the active profile's `remoteRoot` to `asset-groups.json`. Leave it empty to load remote assets same-origin (e.g. for local testing).*### `.esengine/asset-groups.json`diff --git a/docs/astro/src/content/docs/zh-cn/guides/assets.mdx b/docs/astro/src/content/docs/zh-cn/guides/assets.mdxindex c2588d48f..57b381a1e 100644--- a/docs/astro/src/content/docs/zh-cn/guides/assets.mdx+++ b/docs/astro/src/content/docs/zh-cn/guides/assets.mdx@@ -105,13 +105,17 @@ const { failed } = await assets.preload(- **压缩纹理** —— 把 PNG 编码为 GPU 就绪的 **KTX2**(Basis Universal),运行时再转码为设备支持的最佳格式(ASTC → ETC2 → S3TC,最后回退 RGBA8),连同 mip 链。这由逐资产的- **导入设置**决定,每个平台一个页签,所以一张纹理可以为手机压得比网页端更狠;+ **导入设置**决定,每个平台一个页签(见下图),所以一张纹理可以为手机压得比网页端更狠;打包对话框的**资源压缩**开关只选择遵循还是全部跳过这些设置。- **内容寻址** —— 每个发布文件按字节哈希命名,于是 URL 不可变,相同文件去重成一份。Web/桌面默认开启。- **自动图集** —— 把零散的 PNG 放进 `<name>.atlas/` 文件夹,烘焙时会把它们打包成图集页(帧 UV 写进清单),于是许多小精灵作为一张纹理发布、在一次绘制里合批。+++*一张纹理的**平台覆盖**:每个目标各有页签;没有覆盖任何东西的平台,沿用上方的默认设置。*+### 只有代码点名的资产可达性分析正是拦住"什么都往包里塞"的东西——而它对**你的代码在运行时才点名的一切是瞎的**:diff --git a/docs/astro/src/content/docs/zh-cn/guides/hot-update.mdx b/docs/astro/src/content/docs/zh-cn/guides/hot-update.mdxindex a74d7e4e6..353af65b9 100644--- a/docs/astro/src/content/docs/zh-cn/guides/hot-update.mdx+++ b/docs/astro/src/content/docs/zh-cn/guides/hot-update.mdx@@ -64,11 +64,11 @@ Estella 的热更新是**内容寻址**、**原子**(要么全成、要么回### 设置 CDN 根地址-远端组资产需要一个**根 URL** 来拉取——你的 CDN。它是一个**构建 profile** 设置,因此 `dev` 与 `prod` 可以指向不同的 CDN,导出时会把活动 profile 的根地址烘进发布的游戏里。在**构建**对话框(**文件 → 构建…**)中设置:+远端组资产需要一个**根 URL** 来拉取——你的 CDN。它是一个**构建 profile** 设置,因此 `dev` 与 `prod` 可以指向不同的 CDN,导出时会把活动 profile 的根地址烘进发布的游戏里。在**打包项目**对话框(**文件 → 构建…**)的**高级**里设置:-+-*构建对话框中的 **CDN 地址(热更)** 字段会把活动 profile 的 `remoteRoot` 写入 `asset-groups.json`。留空则远端资产从游戏同源加载(例如本地测试时)。*+***CDN 地址** 字段会把活动 profile 的 `remoteRoot` 写入 `asset-groups.json`。留空则远端资产从游戏同源加载(例如本地测试时)。*### `.esengine/asset-groups.json`