The 2.7.1 release is a minor LTS release for bugfixes and improvements

🙏Thanks to all contributers of axmol include financial sponsors: @scorewarrior,@peterkharitonov,@duong,@thienphuoc, @bingsoo, @asnagni and Past sponsors

Bug fixes

• Fix .axproj not load on non windows platforms by @halx99
• Fix missing extensions spine,fairygui preprocessors for axlua by @halx99
• Fix #2594 link error when build win32 exe with cmake generator Ninja by @halx99 in #2595

Improvements

• Make msvc delay load mfmedia dlls also works with clang-cl or clang++ by @halx99 in #2595
• Improve plainlua CMakeLists.txt, make it compatibile with lua-5.1~5.5 by @halx99
• Remove unnecessary preprocessor: AX_ENABLE_BULLET_INTEGRATION by @halx99
• Ensure package name consistent for axmol new -r by @halx99
• Add parameter -r for axmol new command to regenerates the missing common and platform spec files by @halx99 in #2590
• Remove redundant cc prefix by @halx99 in #2587
• Improve android sdk root selection strategy by @halx99
• Improve android sdk setup by @halx99 in #2588, load sdk.dir from proj.android/local.properties as preferred android sdk root if it's present
• Improve lua bindings generator, make it can works with ndk versions: r23~latest by @halx99 in #2592
• Update imgui to 1.92.1 & tidy sources structure by @halx99 in #2593
• Re-indent all axmol spec cmake scripts with 2 spaces by @halx99 in #2599

SDK & Tools updates

• cppwinrt: 2.0.240405.15 => 2.0.250303.1

3rdparty updates

• imgui: 1.92.0 => 1.92.1
• webp: 1.5.0 => 1.6.0

MD5 Hash of the release artifacts

• axmol-2.7.1.zip: 5aa09c0c09c9600f38bf0b6294b96e7e
• axmol-bs-2.7.1.zip: 0b929a4bbf589fcc2484ed5ec33bcc16

The 2.7.0 release is a minor LTS release for bugfixes and improvements

🙏Thanks to all contributers of axmol include financial sponsors: @scorewarrior,@peterkharitonov,@duong,@thienphuoc, @bingsoo, @asnagni, @paulocoutinhox

Significant changes relative to 2.6.x

• The minimum required version of Android Studio has been updated to 2025.1.1
• Add mouse events listener for Widgets by @AlexandreK38 in #2580 (the callback function return type was changed from void to bool)
• Refactor imgui axmol backend by @halx99 in #2584, now both android and PC platform backends share it.
• The ImGuiPresenter's APIs mergeFontGlyphs,clearGlyphRanges,removeGlyphRanges,addGlyphRanges,getGlyphRangesId have been removed(no longer needed), benefit from imgui-1.92.0 dynamic font atlas support, see imgui 1.92.0 release notes: https://github.com/ocornut/imgui/releases/tag/v1.92.0
• Add ImGuiPresenter::getMainScale, mark ImGuiPresenter::getContentZoomFactor as DEPRECATED
• Remove all overload stubs of API ImGuiPresenter::addFont, now only void ImGuiPresenter::addFont(std::string_view fontFile, float fontSize = DEFAULT_FONT_SIZE); available

Bug fixes

• Fix Calling Label::setString after Label::getLetter causes layout issues by @halx99 in #2572
• Fix Label wrapping, overflow and alignment issues by @rh101 in #2567
• Fix #2569 build fail on ubuntu-22.04 by @halx99
• Fix statsLabel not show after Director::restart() by @remtori in #2581
• Fix linux crash on exiting cpp-tests after running Scene3DTest by @halx99 in #2582

Improvements

• Improve system font text rendering under WASM by @halx99, also fix issue: #2349
• Improve prompt when cmd 'xcodebuild' missing by @halx99
• Fix Bug-350.cpp of cpp-tests by @aismann in #2568
• Update Clipper2 to 1.5.4 by @aismann in #2563
• Update 3rdparty README.md (Clipper2 1.5.4) by @aismann in #2564
• Update and re-enable Scene3D test by @rh101 in #2562
• Update SDFGen.cpp (fix typo) by @aismann in #2565
• Change wasm initial memory to 128MB, allow memory increase by @AlexandreK38 in #2575
• Add locating visual studio build tools without full vs installed by @martinking71 in #2576
• Add click listener for WASM (without touches AKA on desktop) to cancel the current 'touches' by @AlexandreK38 in #2577
• WASM Option to use main loop timing 'timeout' instead of 'requestAnimationFrame' (RAF) by @AlexandreK38 in #2578
• Remove Director redundant release statements by @halx99,@remtori
• Add close code and reason for Websocket close / onClose by @AlexandreK38 #2579
• Fix typo for 1kiss.ps1 by @halx99

SDKs & Tools updates

• AGP: 8.10.0 => 8.11.0
• gradle: 8.13 => 8.14.3

3rdparty updates

• Clipper2: 1.5.3 => 1.5.4
• libpng: 1.6.48 => 1.6.50
• imgui: 1.91.6 => 1.92.0
• jpeg-turbo: 3.1.0 => 3.1.1
• ogg: 1.3.5 => 1.3.6
• openssl: 3.0.16 => 3.0.17
• plainlua: 5.4.7 => 5.4.8

MD5 Hash of the release artifacts

• axmol-2.7.0.zip: e6f109f32481a15b0030fbb228902940
• axmol-bs-2.7.0.zip: 4f7987d3c9d04ccf521225d3f8db2a15

The 2.6.1 release is a minor LTS release for bugfixes and improvements

🙏Thanks to all contributers of axmol include financial sponsors: @scorewarrior,@peterkharitonov,@duong,@thienphuoc, @bingsoo, @asnagni, @paulocoutinhox, @DelinWorks

Bug fixes

• Fix #2559 crash on android armv7 by @halx99
• Fix blending so that the fairygui animation clip renders with the correct blend function by @thienphuoc in #2560
• Fix opus not link when linking prebuilt engine to axmol apps by @halx99
• Fix build win32 by clang fail due to openal set incorrect preprocessors by @halx99
• Fix gradle can't lookup cmake from axmol/tools/external/cmake

Improvements

• No longer use android legacy cmake toolchain file by @halx99
• Add build options to game cmake module for easier access by @rh101 in #2553
• Move AXGameFinalSetup.cmake to cpp and lua templates because of differences in code by @rh101 in #2557
• Add win prebuilt workflow check ci by @halx99 in #2558
• Improve gradle scripts by @halx99 in #2561
• Holding a VM reference to the android asset manager jobject to prevent its being garbage collected while the native object is in use by @halx99
• Remove unused workaround code by @halx99
• Ensure setup correct version for android buildtools and target_sdk by @halx99
• Move axmol.gradle outside the libaxmol gradle project by @halx99

SDKs & Tools updates

• cmdlinetools: 12.0 => 19.0

3rdparty updates

• astcenc: 5.2.0 => 5.3.0
• luajit: 2.1-eec7a80 => 2.1-f9140a6
• openssl: 3.5.0 => 3.0.16

New Contributors

• @thienphuoc made their first contribution in #2560

MD5 Hash of the release artifacts

• axmol-2.6.1.zip: 76f1b27fdc5b79f69918fddcd072760c
• axmol-bs-2.6.1.zip: f7f699b97bd191f11a745bfae5e71f43

The 2.6.0 release is a minor LTS release for bugfixes and improvements

🙏Thanks to all contributers of axmol include financial sponsors: @scorewarrior,@peterkharitonov,@duong,@thienphuoc, @bingsoo, @asnagni, @paulocoutinhox, @DelinWorks

Significant changes relative to 2.5.0:

• Update android devenv to support android 16 by @halx99 in #2546
• Update Android Studio minimum required version to 2024.3.2
• Downgrade emsdk from 4.0.6 to 3.1.73 to ensure that the developer can debug axmol wasm apps properly on all platforms. If you use linux or macos, you can set and use without issue a higher emsdk version (4.0+) in your .axproj, for example emsdk=4.0.11.
  If you use windows you won’t be able to debug the app properly on higher versions than 3.1.73

Bug fixes

• Fix #2548 Downloader-curl may crash or hang in download thread in #2549 by @halx99
• Fix #2545 install pwsh fail on ubuntu-25.04 by @halx99
• Fix wasm build fail on windows by @halx99 in #2511
• Fix PNG_ARM_NEON_OPT flag by @halx99 in #2512
• Fix #2504 play opus audio fail when build with Apple OpenAL.framework by @halx99 in #2506
• Fix typo in pkg_check_modules for GTK3. by @j-jorge in #2534
• Fix character, underline and strikethrough drawing over label boundary for Overflow::CLAMP mode by @rh101 in #2515
• Fix for clamped and left-aligned text with certain character sets by @rh101 in #2518
• Fix wasm raise runtime error due to HEAPU8 was not exported by @halx99
• Fix decompressGZ infinite-loop when input data invalid by @halx99 in #2544

Improvements

• Improve ZipUtils::decompressGZ by @halx99 in #2544
  • Parsing uncompress size and reserve exactly avoid waste memory
  • Valid input size
• Improve ogg audio files, detect codec via file header by @halx99 in #2500
• Clarify required execution policy settings in PowerShell for IDE builds by @rh101 in #2505
• Enable verbose logging for android projects by @sarooptech in #2509
• Link prebuilt opus by @halx99 in #2514
• DevSetup, added mention of NDK r26+ for C++20 support under Android Studio by @danialias in #2524
• Update 3rd libs by @halx99 in #2527
• [FairyGUI] Add support for blending by @rh101 in #2532
• Committing luabindings for commit 8dab60e by @axmol-bot in #2533
• Undef the pre-processor definitions to stay unity build friendly by @j-jorge in #2535
• Rename ccBezierConfig as BezierConfig. by @j-jorge in #2536
• Committing luabindings for commit 876b5e4 by @axmol-bot in #2537
• Clipper2 1.5.3 by @aismann in #2541
• Set preferred emsdk version to 3.1.73 for chrome can debug axmol wasm app properly by @halx99
• Improve android sdk root lookup prompt, refer https://github.com/axmolengine/axmol/discussions/2494, https://github.com/axmolengine/axmol/discussions/2493 by @halx99
• Fix gradle lint warnings by @halx99
• Improve utils::computeDigest to support base64 digest present by @halx99
• Improve linux android studio support by @halx99
• Improve Improve linux env setup by @halx99
• Improve isolate project axslcc find prompt by @halx99
• Move simd intrinsics detection from 3rd into core by @halx99
• Add minimum version to build docs support by @halx99, now the ci will only build & deploy axmol-2.3+ docs
• Remove deprecated DSL config: renderscriptDebuggable by @halx99 in #2546
• Implement ui::MediaPlayer::getVirtualRenderer by @halx99

SDKs & Tools updates

• agp: 8.7.3 => 8.10.0
• android target sdk: 35 => 36
• android sdk build tools: 34.0.0 => 35.0.0
• emsdk: 4.0.6 => 3.1.73

3rdparty updates

• cares: 1.34.4 => 1.34.5
• Clipper2: 1.5.2 => 1.5.3
• doctest: 2.4.11 => 2.4.12
• fmtlib: 11.1.4 => 11.2.0
• llhttp: 9.2.1 => 9.3.0
• luajit: 2.1-a4f56a4 => 2.1-eec7a80
• libpng: 1.6.47 => 1.6.48
• openssl: 3.0.16 => 3.5.0

MD5 Hash of the release artifacts

• axmol-2.6.0.zip: BF5E1D7DC293C51810B0AA7B03024392
• axmol-bs-2.6.0.zip: 03C9F6DB1C24CB97F2C7C4A0F5973AA8

The 2.5.0 release is a minor LTS release for bugfixes and improvements

🙏Thanks to all contributers of axmol include financial sponsors: @scorewarrior,@peterkharitonov,@duong,@thienphuoc, @bingsoo, @asnagni, @paulocoutinhox, @DelinWorks

Bug fixes

• Fix for invalid event listener ID lookup by @rh101 in #2445
• Fix #2415 c++23 compile error by @halx99
• Fix #2470 wasm CommandBufferGL::readPixels not work by @halx99

Improvements

• Ensure fseeko available on ndk > 23 by @halx99 in #2490
• Add play .opus audio files support by @halx99 in #2488
• Auto install missing msvc toolset with specified version by @halx99
• make some warn message can suppressed by @halx99
• Fix winuwp ci due to github action vm disk space insufficient by @halx99
• [Android] FileUtils::listFiles implementation that works with empty folders by @rh101 in #2463
• [WASM] set _APP_RES_FOLDER if not defined to be able to specify directories of Resources by @AlexandreK38 in #2483
• Fix setup and BUILD_SHARED_LIBS for Linux by @IamSanjid in #2481
• Add supporting 'closed' Splines for DrawNode by @aismann in #2476
• Add GLView::setInteractive by @AlexandreK38 in #2465
• Fix BUILD_SHARED_LIBS for Android by @IamSanjid in #2462
• Fix some deprecated methods not available in gradle 9.0 by @halx99
• Fix #2457 support overwrite build profiles by .axproj by @halx99 in #2460
• Prevent getCurrentTime() from returning 0 at the end of the audio track playback by @rh101 in #2452
• Improve RichText XML parsing by @rh101 in #2420
• Renamed forgotten ccConfig.h to Config.h by @aismann in #2422
• Allow the use of em and % units for font size in RichText XML by @rh101 in #2421
• Minor FastTMXLayer performance optimization by @hasikill in #2437
• Add production ready wasm page by @paulocoutinhox in #2428
• [Template] Add missing override specifier to destructor by @rh101 in #2433
• [Android] Ensure c++ object model consistency by @halx99 in #2434
• Update spine runtime to 4.2 by @halx99 in #2435
• Committing luabindings for commit fe9d98c by @axmol-bot in #2439
• Simplify project CMakeLists.txt by moving code sections to cmake modules by @rh101 in #2426
• Ensure custom button label is released correctly by @rh101 in #2446
• Refactor SpriteFrameCache to use uint64_t as map key by @halx99 in #2444
• Committing luabindings for commit 7f669db by @axmol-bot in #2449
• Log frame names instead of hash values in the call to removeUnusedSpriteFrames() by @rh101 in #2450
• Improve setup.ps1: traits undetermined shell as bash by @halx99
• Add ci verify.yml to verify axmol cmdline commands: axmol new, axmol build by @halx99
• Allow trigger build ci to build with specified c++ standard manually by @halx99
• [CI] Make run name dynamic with c++ standard mark
• [CI] Improve sites build

SDKs & Tools updates

• gradle: 8.11.1 ==> 8.13
• cmake: 3.31.5 ==> 4.0.0
• emsdk: 4.0.3 ==> 4.0.6

3rdparty updates

• yasio: 4.3.1 ==> 4.3.2
• fmtlib: 11.1.3 ==> 11.1.4
• flatbuffers: 24.3.25 ==> 25.2.10
• robin_map: 1.2.1 ==> 1.4.0

MD5 Hash of the release artifacts

• axmol-2.5.0.zip: 1BA9A6D23D687CD3EC603B1C7DE9797A
• axmol-bs-2.5.0.zip: 93BAEFF6BB5C8540AB771EDD3E1BA69B

The 2.4.0 release is a minor LTS release for bugfixes and improvements

🙏Thanks to all contributers of axmol include financial sponsors: @scorewarrior,@peterkharitonov,@duong,@thienphuoc, @bingsoo, @asnagni, @paulocoutinhox, @DelinWorks

🙏Extremely thanks to @scorewarrior become new $3000.00/month financial sponsor, it's a very nice company.

Bug fixes

• Fix build wasm fail with -O0 by @halx99
• Fix #2370 module 'bitop' not found by @halx99
• Fix #2371 Video freezes on the first frame when played on Apple TV by @halx99
• Fix tile animation logic to use correct time per frame by @rh101 in #2345
• Fix: when these extensions set to OFF, compiles by @blairwang in #2347
• Fix tilemap culling by @DelinWorks in #2403

Improvements

• Improve build system, support select msvc toolset version by @halx99
• Improve Label: underline, strikethrough and color by @aismann in #2382
• Disable Spine references if Spine is not enabled by @rh101 in #2346
• Increase MAX_AUDIOINSTANCES value to 128 in AudioEngine by @MartinLutherSu in #2348
• Clipper2 ver. 1.5.0 by @aismann in #2350
• Remove folder DrawNodeExTest by @aismann in #2352
• Clipper2 1.5.2 by @aismann in #2360
• [Android] Allow project to specify Axmol engine root path by @rh101 in #2361
• Improve gradle by @halx99 in #2363
• Add zip in memory support by @AlexandreK38 in #2368
• Use axmol proguard file in template and clean by @AlexandreK38 in #2366
• [Windows] Ensure vertical scrolling is enabled when EditBox is in multiline mode by @rh101 in #2374
• Add Android event for Warm Start by @AlexandreK38 in #2367
• [Windows] Ensure EditBox shows text correctly when it receives focus for the first time by @rh101 in #2376
• Add Image flip Raw data vertically by @AlexandreK38 in #2369
• Committing luabindings for commit 0656f87 by @axmol-bot in #2377
• Improve site and add donate page with donate channels and sponsors list by @halx99
• Improve build system by @halx99
  • Install android cmdline-tools into android sdk root
  • Improve setup.ps1 on macOS
  • Update live2d SDK download url
  • Improve gradle scripts
• Remove unused 3rd lib: yaml-cpp by @halx99
• Fix wasm compile warnings
• Added methods to modify audio pitch by @Janglee123 in #2381
• Improve webgl render fps by @halx99 in #2379
• Add missing const qualifiers for DrawNode by @crazyhappygame in #2394
• Ensure opacity is applied to DrawNode used in Label by @rh101 in #2396
• Update button size if title renderer is changed and ignore size is true by @rh101 in #2401
• Calculate correct positions for underline and strikethrough by @rh101 in #2398
• [Android] Add a way to disable interactions on the SurfaceView by @AlexandreK38 in #2410

SDKs updates

• emsdk: 3.1.73 ==> 4.0.3

3rdparty updates

• astcenc: 5.1.0 ==> 5.2.0
• clipper2: 1.4.0 ==> 1.5.2
• curl: 8.11.1 ==> 8.12.1
• libpng: 1.6.45 ==> 1.6.47
• fmt: 11.1.2 ==> 11.1.3
• openssl: 3.0.15 ==> 3.0.16

MD5 Hash of the release artifacts

• axmol-2.4.0.zip: 88C9EBB706921846BFC0E65B021A0A67
• axmol-bs-2.4.0.zip: 3FEE1585C88334106A785AC349FD98B8

The 2.3.2 release is a minor LTS release for bugfixes and improvements

🙏thanks to all contributers of axmol include financial sponsors: @thienphuoc, @bingsoo, @asnagni, @paulocoutinhox, @DelinWorks, @duong, @peterkharitonov

Bug fixes

• Fix bit op error on lua < 5.4 by @halx99
• Fix luajit luaL_openlibs crash on android by @halx99
• Fix setup.ps1 Error in parsing PowerShell and OS versions by @halx99
• Fix cpp template scene listeners leaked by @halx99

Improvements

• Fix clang-19 compile warnings
• Improve 7z cmdline compatibility
• DrawNode: new method: drawColoredTriangle(const Vec2* vertices3, const Color4B* color3) by @aismann in #2305
• Committing luabindings for commit 5c84ccd by @axmol-bot in #2307
• Correctly load resources that exist in a different folder to TMX file by @rh101 in #2316
• Update DevSetup.md for Android by @rh101 in #2319
• Add support for the creation of layers that are set to invisible in tilemap by @rh101 in #2321
• Committing luabindings for commit 2212048 by @axmol-bot in #2323
• Issue Template: Add Documentation_report.md by @aismann in #2326
• Use correct color type to fix debug drawing in PhysicsWorld by @rh101 in #2334
• Committing luabindings for commit 3da481f by @axmol-bot in #2335
• Add more fine-grained callbacks supports for MenuItem by @MartinLutherSu in #2342

3rdparty updates

• libpng: 1.6.44 ==> 1.6.45
• fmt: 11.1.1 ==> 11.1.2
• luajit: 2.1-f73e649 ==> 2.1-a4f56a4

MD5 Hash of the release artifacts

• axmol-2.3.2.zip: 0BE45A566733E6F5AF9CC8516289B808
• axmol-bs-2.3.2.zip: 782BD5642FB0E1FCCB3E2C992A42B9F6

The 2.3.1 release is a minor LTS release for bugfixes and improvements

Bug fixes

• Fix RenderTexture internal sprite positioning and test cases by @rh101 in #2301
• Fix imgui compile and link error for wasm by @halx99 in #2297
• Fix continues drawCardinalSplines() drawing outside the control points on last control point by @aismann in #2303

Improvements

• Improve CI, raise error when build fail by @halx99
• Improve DevSetup.md by @rh101 in #2298

3rdparty updates

• xxhash: 0.8.2 ==> 0.8.3

MD5 Hash of the release artifacts

• axmol-2.3.1.zip: ADFC977211FBA017B2D36A914B35B72D
• axmol-bs-2.3.1.zip: F3651518A2711EB886950D7A3C6E63DE

💥Happy New Year, we are happy publish this release in Jan.1 2025💥

The 2.3.0 release is a minor LTS release for bugfixes and improvements

🙏thanks to all contributers of axmol include financial sponsors: @thienphuoc, @bingsoo, @asnagni, @paulocoutinhox, @DelinWorks, @duong, @peterkharitonov

🙏very thanks to @peterkharitonov become new $250.00/month financial sponsor.

Significant changes relative to 2.2.x:

• Add android15 16KB page size support by @halx99 in #2268
• Improve build profiles by @halx99 in #2273
• Rename org.axmol* to dev.axmol* by @halx99 in #2272
• Rename glslcc to axslcc by @halx99 in #2271
• Add support to create a minmal axmol-bs package for common cross platform build purpose by @halx99
• Add vs2022 preview support in 1kiss.ps1 by @halx99
• Update libclang to 19.1.6 for luabinding generator by @halx99
• Download package to cache instead tools/external
• Add build android .aab support via axmol -p android -aab

Bug fixes

• Fix Label create with long string cause random crash in windows by @halx99
• Fix DrawNode::drawPie(DrawMode::Line, thickness =1) draw a closed line (like DrawMode::Semi) wrong by @aismann in #2217
• Fix for Android build issue by @rh101 in #2225
• Fix media player by @ paulocoutinhox in #2257
• Fix android class name paths incorrect by @rh101 in #2276
• Fix renderer test case batching by @rh101 in #2291

Improvements

• Improve DrawNode::drawPie() by @aismann in #2222
• Metal: enable mipmap support by @smilediver in #2235
• Add support for selecting all text in editbox via CTRL+A by @rh101 in #2238
• Ensure that git ignores build folders created in test projects by @rh101 in #2247
• Detect CTRL+A key combination to select all text in EditBox by @rh101 in #2251
• Prevent excessive calls to deleteBackward method which may cause crashes on Android by @rh101 in #2248
• Updated website. by @danialias in #2274
• Make win32 messageBox always TOPMOST by @aismann in #2221
• Add printLeaks call to alternative Win32 main method by @rh101 in #2278
• Add printLeaks call in appropriate location to help developers by @rh101 in #2275
• Remove TTF Font charCode 65535 limit by @halx99
• Allow publish from specified commitish for ci

sdks updates

• emsdk: 3.1.67 ==> 3.1.73
• AGP: 8.4.0 ==> 8.7.3
• gradle: 8.8.0 ==> 8.11.1
• android target sdk: 34 ==> 35

3rdparty updates

• astcenc: 4.8.0 ==> 5.1.0
• c-ares: 1.34.1 ==> 1.34.4
• curl: 8.10.1 ==> 8.11.1
• flatbuffers: 24.3.25 ==> 24.12.23
• fmt: 11.0.1 ==> 11.1.1
• oboe: 1.9.0 ==> 1.9.3
• webp: 1.4.0 ==> 1.5.0
• jpeg-turbo: 3.0.4 ==> 3.1.0
• luajit: 2.1-97813fb ==> 2.1-f73e649
• imgui: 1.90.6 ==> 1.91.6

Update guide

https://github.com/axmolengine/axmol/wiki/Update-guide-to-v2.3.0-for-Android

MD5 Hash of the release artifacts

• axmol-2.3.0.zip: 635F1D5E46EE938E7D57A9DC591D50BF
• axmol-bs-2.3.0.zip: 31845E841FC8604B768506E5F1B686F0

The 2.2.1 release is a minor LTS release for bugfixes and improvements

Bug fixes

• Fix curl link error on macOS

MD5 Hash of the release artifacts

• axmol-2.2.1.zip: 8FB43DF6C258A25477C23010E54B2777