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: the app icon is a project setting, not a platform chore
esenginefa6261eab5a3
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex fecf55e99..756b80fb2 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -16,6 +16,15 @@ published separately; it ships inside the editor.### Added+- **A packaged game carries its own icon.** *Project Settings → Packaging → App+ Icon* takes one square PNG (1024×1024 is ideal) and every installable target+ uses it: Android as the launcher mipmap, iOS as the asset catalog Xcode derives+ its sizes from. Nothing resizes it — both platforms scale, so one image is all a+ project keeps. Android needs a resource table for this (`android:icon` must be a+ reference, not a path), and that table is now written directly in both encodings+ — `resources.arsc` for the APK, `resources.pb` for the bundle — rather than+ bringing aapt2 back to build one. Projects that set no icon ship Estella's mark+ instead of the platform's placeholder.- **Google Play: Package Project writes the App Bundle (`.aab`) too.** Play hasrequired a bundle rather than an APK for new apps since 2021, so packaging forAndroid stopped at sideloading. Tick **Google Play App Bundle** in the Androiddiff --git a/docs/astro/src/content/docs/guides/mobile.mdx b/docs/astro/src/content/docs/guides/mobile.mdxindex 45f58f3fb..796d99473 100644--- a/docs/astro/src/content/docs/guides/mobile.mdx+++ b/docs/astro/src/content/docs/guides/mobile.mdx@@ -127,6 +127,7 @@ whoever assembles the app, in **Project Settings → Packaging**:| Setting | What it becomes ||---|---|+| **App Icon** | The launcher icon on both platforms — one project-relative square PNG (1024×1024 is ideal). Android takes it as the launcher mipmap, iOS as the asset catalog Xcode derives every size from, so nothing is resized and one image is all you keep. Left empty, the app ships Estella's mark rather than the platform's placeholder. || **Application ID** | The Android manifest package and the iOS bundle id (reverse-DNS). Left empty it is derived from the project name; a published app should set its own. || **Android Version Code** | The integer Google Play orders builds by — it must increase with every upload. The version users see comes from the project version. || **Orientation** | *Project Settings → Display → Orientation*, one project-wide setting every target honors. Left unset it follows the design resolution's aspect. |diff --git a/docs/astro/src/content/docs/zh-cn/guides/mobile.mdx b/docs/astro/src/content/docs/zh-cn/guides/mobile.mdxindex f98fcfa06..209b1d0b8 100644--- a/docs/astro/src/content/docs/zh-cn/guides/mobile.mdx+++ b/docs/astro/src/content/docs/zh-cn/guides/mobile.mdx@@ -106,6 +106,7 @@ Android 和 iOS 是**两个目标而不是一个"Mobile"**,因为它们被组装| 设置 | 它会变成什么 ||---|---|+| **应用图标** | 两个平台的启动图标——项目内的一张方形 PNG(建议 1024×1024)。Android 用作 launcher mipmap,iOS 用作 Xcode 据以派生各尺寸的 asset catalog,所以不做任何缩放,只需保留这一张。留空则使用 Estella 的标识,而不是平台的占位图。 || **应用 ID** | Android 的 manifest package 和 iOS 的 bundle id(反向域名)。留空则按项目名推导;正式发布的应用应当自己指定。 || **Android 版本号** | Google Play 用来排序构建的整数,每次上传都必须递增。用户看到的版本号来自项目版本。 || **朝向** | *项目设置 → 显示 → 朝向*,一个项目级设置,所有目标都遵守。不设则跟随设计分辨率的宽高比。 |diff --git a/native/README.md b/native/README.mdindex 8169da02c..606471f8b 100644--- a/native/README.md+++ b/native/README.md@@ -209,6 +209,14 @@ all three formats are written directly (`build-tools/utils/{androidBinaryXml,zip* **Native libraries are stored, 16 KiB-aligned**, with `extractNativeLibs=false`:the OS maps them out of the package, which halves the install and is the postureAndroid 15's page size wants.+* **The launcher icon** is one square PNG (Project Settings → Packaging), and the+ reason `androidResources.js` exists: `android:icon` must be a resource+ REFERENCE, so an app with its own icon needs a resource table. It is written+ here in both encodings — `resources.arsc` and `resources.pb`, one package, one+ `mipmap/ic_launcher` entry, ids we choose — rather than having the template+ carry tables aapt2 built, which would put the SDK back on a build machine's path+ and freeze the table's shape into the release. The template ships the default+ icon a project without one gets.* **The App Bundle** (`--aab`, or the checkbox in the dialog) is the same contentagain: the manifest re-encoded as aapt2 protobuf (`androidProtoXml.js` — the sameparsed tree and the same resource ids as the binary XML, so the two cannot