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.

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.png
index f22d389b8..fa180abc4 100644
Binary 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 differ
diff --git a/docs/astro/src/assets/guides/en/import-platform-overrides.png b/docs/astro/src/assets/guides/en/import-platform-overrides.png
new file mode 100644
index 000000000..746e39412
Binary files /dev/null and b/docs/astro/src/assets/guides/en/import-platform-overrides.png differ
diff --git a/docs/astro/src/assets/guides/zh/hot-update-build-cdn.png b/docs/astro/src/assets/guides/zh/hot-update-build-cdn.png
index 5d484e973..65c0f854e 100644
Binary 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 differ
diff --git a/docs/astro/src/assets/guides/zh/import-platform-overrides.png b/docs/astro/src/assets/guides/zh/import-platform-overrides.png
new file mode 100644
index 000000000..96d3b265c
Binary files /dev/null and b/docs/astro/src/assets/guides/zh/import-platform-overrides.png differ
diff --git a/docs/astro/src/content/docs/guides/assets.mdx b/docs/astro/src/content/docs/guides/assets.mdx
index 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 URLs
are immutable and identical files dedupe to a single copy. On by default for
Web/Desktop.
@@ -129,6 +129,10 @@ way it can:
them into atlas pages (with the frame UVs written into the manifest), so many
small sprites ship as one texture and batch in one draw call.
+![The Inspector's Platform Overrides strip — a tab per platform, Android selected with Max Size, Compress and Format](../../../assets/guides/en/import-platform-overrides.png)
+
+*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 names
Reachability is what keeps a build from shipping everything — and it is **blind to
diff --git a/docs/astro/src/content/docs/guides/hot-update.mdx b/docs/astro/src/content/docs/guides/hot-update.mdx
index 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 **build
profile** setting, so `dev` and `prod` can point at different CDNs, and the
export 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 Build dialog's CDN root (hot-update) field](../../../assets/guides/en/hot-update-build-cdn.png)
+![The Package dialog's Advanced group — the CDN root field, source maps, and open-output-folder](../../../assets/guides/en/hot-update-build-cdn.png)
-*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.mdx
index 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 写进清单),于是许多小精灵作为一张纹理发布、在一次绘制里合批。
+![检视面板的「平台覆盖」条——每个平台一个页签,选中 Android 时显示 Max Size、压缩与格式](../../../../assets/guides/zh/import-platform-overrides.png)
+
+*一张纹理的**平台覆盖**:每个目标各有页签;没有覆盖任何东西的平台,沿用上方的默认设置。*
+
### 只有代码点名的资产
可达性分析正是拦住"什么都往包里塞"的东西——而它对**你的代码在运行时才点名的一切是瞎的**:
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.mdx
index 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 地址(热更)」字段](../../../../assets/guides/zh/hot-update-build-cdn.png)
+![打包对话框的「高级」分组——CDN 地址、源码映射与完成后打开输出文件夹](../../../../assets/guides/zh/hot-update-build-cdn.png)
-*构建对话框中的 **CDN 地址(热更)** 字段会把活动 profile 的 `remoteRoot` 写入 `asset-groups.json`。留空则远端资产从游戏同源加载(例如本地测试时)。*
+***CDN 地址** 字段会把活动 profile 的 `remoteRoot` 写入 `asset-groups.json`。留空则远端资产从游戏同源加载(例如本地测试时)。*
### `.esengine/asset-groups.json`