Sunday, November 2, 2025
spot_img

[IMPORTANT] Android 16K Replace Information – Cocos Creator


Good day builders,

To enhance the engine compatibility and efficiency on sure Android units (for instance terminals with ARM64 structure), we lately applied help for the Android 16KB reminiscence web page dimension function. The associated code modifications are prepared — we hereby invite you to combine and take a look at them to assist guarantee stability and reliability of this replace.

:bullseye: Core contents of this replace

  1. Engine core repository (engine)
  1. Exterior dependency repository (exterior)
  • Contents: Primarily upgrades V8 model (11.8 → 12.7.140) to match the brand new function. See PR #499.

:counterclockwise_arrows_button: Different: keep away from package deal dimension enhance from V8 improve

Should you favor to not improve V8 (for instance to regulate package deal dimension), we offer alternate options:

  1. Engine code modifications: manually apply the code modifications referenced within the engine PR #18999 to your engine model.
  2. exterior V8 libraries: replace V8 libs (together with x64 and arm64) from the offered PR #501.

:test_tube: Key testing areas and requested suggestions

Please take a look at the next situations and report any points:

  • Core regression testing: confirm primary engine functionalities on ARM64 Android units (particularly units utilizing 16KB web page dimension).
  • Compatibility: test for any venture compatibility points earlier than and after the V8 improve.
  • Efficiency: monitor modifications in startup time, reminiscence footprint, and JS execution efficiency.
  • Stability: run long-duration checks to detect crashes or reminiscence leaks.

:rocket: The best way to begin testing

  1. Get the code:
  • Change to the repository department v3.8.7-16k and construct from that department.
  • The exterior repo makes use of massive information — please set up git-lfs earlier than downloading.
  1. Put together the atmosphere:
  • [Strongly recommended] Improve your improvement atmosphere: replace Android Studio to 2024 or later to make sure the construct course of handles new dependencies and configurations.
  • [Important] Clear native venture:
    • If you have already got a constructed Android venture domestically, please BACK UP your venture’s native listing (when you’ve got customized modifications).
    • DELETE the native listing and associated construct caches (e.g. construct), then rebuild to make sure all native dependencies are accurately up to date.

For Cocos Creator 2.x customers

Cocos Creator 2.x customers please seek advice from the engine-native repo PR #4403 for validation. Throughout verification, make sure you use NDK 28 or newer.

Thanks for this discover.

Is that this repair applied over the v3.8.7 launch? In case sure, the one wanted step can be to do the engine replace?

it’s simply an instance for 3.8.7, comply with the PRs, it may very well be used for 3.6. and three.7.x as effectively

Related Articles

LEAVE A REPLY

Please enter your comment!
Please enter your name here

- Advertisement -spot_img

Latest Articles