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(export): an Android package carries its Spine runtimes on every architecture, not the first only

yhhba558e134cf9
diff --git a/CHANGELOG.md b/CHANGELOG.md
index a77ed6ea7..b4d63e195 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -14,6 +14,10 @@ published separately; it ships inside the editor.
## [Unreleased]
+### Fixed
+
+- **An Android package built for the emulator carries its Spine runtimes on x86_64 too.** v0.101.0 put each Spine runtime's library into the first architecture only, so on an x86_64 emulator or device a Spine skeleton did not load. Phones (arm64) were not affected.
+
## [0.101.0] - 2026-11-10
### Added
diff --git a/build-tools/utils/nativeTemplate.js b/build-tools/utils/nativeTemplate.js
index e096cf7c1..c50beb094 100644
--- a/build-tools/utils/nativeTemplate.js
+++ b/build-tools/utils/nativeTemplate.js
@@ -517,9 +517,12 @@ export const androidSpineLibrary = (version) => `libestella_spine${version.repla
* @returns {Record<string, string[]>}
*/
export function androidSpineLibs(dir, abis, versions) {
+ // Read once: an iterator (a Map's keys) is spent by the first ABI, and every
+ // ABI after it would get no Spine at all — v0.101.0's x86_64 emulator did.
+ const releases = [...versions];
const out = {};
for (const abi of abis) {
- const files = [...versions].map((v) => path.join(dir, 'plugins', abi, androidSpineLibrary(v)))
+ const files = releases.map((v) => path.join(dir, 'plugins', abi, androidSpineLibrary(v)))
.filter((file) => existsSync(file));
if (files.length) out[abi] = files;
}
diff --git a/pipeline/tests/native-template.test.ts b/pipeline/tests/native-template.test.ts
index 9181ec440..f9a2e604a 100644
--- a/pipeline/tests/native-template.test.ts
+++ b/pipeline/tests/native-template.test.ts
@@ -159,6 +159,19 @@ ${line ?? ''}
expect(Object.keys(libs)).toEqual(['arm64-v8a']);
expect(libs['arm64-v8a'].map((f) => path.basename(f))).toEqual(['libestella_spine38.so', 'libestella_spine42.so']);
});
+
+ // v0.101.0 shipped this: the export passes a Map's keys, which the first ABI
+ // used up, so an emulator package carried no Spine on x86_64.
+ it('gives every ABI its libraries when the releases come as an iterator', () => {
+ const dir = manifestDir(ALL);
+ for (const abi of ['arm64-v8a', 'x86_64']) {
+ mkdirSync(path.join(dir, 'plugins', abi), { recursive: true });
+ for (const v of SPINE_RELEASES) writeFileSync(path.join(dir, 'plugins', abi, androidSpineLibrary(v)), 'so');
+ }
+ const libs = androidSpineLibs(dir, ['arm64-v8a', 'x86_64'], new Map([['4.1', []], ['4.2', []]]).keys());
+ expect(Object.keys(libs).sort()).toEqual(['arm64-v8a', 'x86_64']);
+ expect(libs['x86_64'].map((f) => path.basename(f))).toEqual(['libestella_spine41.so', 'libestella_spine42.so']);
+ });
});
describe('installing a runtime template', () => {
diff --git a/tools/releaseNotes.mjs b/tools/releaseNotes.mjs
index b7d7a2436..10382dee5 100644
--- a/tools/releaseNotes.mjs
+++ b/tools/releaseNotes.mjs
@@ -28,6 +28,10 @@ export const NOTES_FLOOR = 'v0.65.0';
* the reader recognises anyway.
*/
export const NOTED = {
+ "fix(export): an Android package carries its Spine runtimes on every architecture, not the first only":
+ {note: "An Android package built for the emulator carries its Spine runtimes on x86_64 too."},
+ "fix(docs): a component summary with an apostrophe no longer breaks the docs build":
+ {internal: "The docs site failed to build; no shipped game or editor behaviour changed."},
"feat(export): one decision for which Spine runtimes a package carries, with Include and Exclude per runtime":
{ note: "Which Spine runtimes a package carries can be set per runtime." },
"feat(native): every Spine release in one native host, each skeleton read by its own":