Bump 2.10.0 (#2894)

Author: halx99

1k/build.profiles

@@ -58,7 +58,7 @@ min_sdk=17
 
 # The gradle version, @setup.ps1
 # as latest as possible
-gradle=9.2.0
+gradle=9.2.1
 
 # The android gradle plugin, @setup.ps1
 # as stable as possible, match with build-tools,android-studio

CHANGELOG.md

@@ -1,3 +1,51 @@
+# axmol-2.10.0 Nov. ?? 2025
+
+## Significant changes relative to 2.9.1
+
+- Improve SDF glow effect rendering by @halx99 in [#2849](https://github.com/axmolengine/axmol/pull/2849)
+- Switch default audio backend on iOS/macOS from `OpenAL.framework` to `openal-soft` by @halx99 in [#2868](https://github.com/axmolengine/axmol/pull/2868)
+- Add new interface `Application::applicationWillQuit` by @halx99 in [#2870](https://github.com/axmolengine/axmol/pull/2870)
+- Deprecate `FontFreeType::setShareDistanceFieldEnabled` by @halx99 in [#2856](https://github.com/axmolengine/axmol/pull/2856),  
+  use `FontFreeType::setGlobalSDFEnabled` instead
+
+## Bug fixes
+
+- Fix ASTC formats returning false in `testFormatForPvr3TCSupport` by @lucycycy in [#2855](https://github.com/axmolengine/axmol/pull/2855)
+- Fix xcarchive generation on iOS/macOS when using OpenAL-Soft by @rh101 in [#2883](https://github.com/axmolengine/axmol/pull/2883)
+- [Linux] Fix missing shared OpenAL library issue by @rh101 in [#2885](https://github.com/axmolengine/axmol/pull/2885)
+- Add path length checks to prevent out-of-bounds access in `isAbsolutePathInternal` by @tkzcfc in [#2891](https://github.com/axmolengine/axmol/pull/2891)
+- Fix cpp-tests memory leak by @halx99
+- Fix cpp-tests compile failure when ImGui is disabled by @halx99
+
+## Improvements
+
+- DrawNodeTest improvements by @aismann in [#2859](https://github.com/axmolengine/axmol/pull/2859)
+- Add `errno` and `stdint` includes to `IFileStream.h` by @halx99 in [#2875](https://github.com/axmolengine/axmol/pull/2875)
+- Allow setting event code and touches in `EventTouch` by @j-jorge and @halx99 in [#2890](https://github.com/axmolengine/axmol/pull/2890)
+- Improve label effect test by @halx99
+- Improve SDF text rendering shaders by @halx99
+- Enhance Visual Studio 2026 support by @halx99
+- Update binding template files by @halx99
+
+## SDK & Tools updates
+
+- cmake: 4.1.1 → 4.2.0 (required for VS2026 support)  
+- gradle: 9.2.0 → 9.2.1  
+- webview2: 1.0.3537.50 → 1.0.3595.46  
+
+## 3rdparty updates
+
+- curl: 8.16.0 → 8.17.0  
+- luajit: 2.1-871db2c → 2.1-68354f4  
+
+## Community News
+
+- Axmol supports building with **Visual Studio 2026** out of the box.  
+  Ensure that [CMake 4.2.0+](https://cmake.org/download/) is installed.
+
+- In **November 2025**, Axmol introduced **experimental Direct3D12 and Vulkan RHI** support,  
+  marking the first step toward modern, cross‑API rendering backends.
+
 # axmol-2.9.1 Nov.2 2025
 
 ## Significant changes relative to 2.9.0:

INFRA.md

@@ -11,15 +11,15 @@
 ## Microsoft.Web.WebView2
 
 - [![nuget](https://img.shields.io/nuget/v/Microsoft.Web.WebView2?label=Upstream)](https://www.nuget.org/packages/Microsoft.Web.WebView2)
-- Version: 1.0.3537.50
-- License: https://www.nuget.org/packages/Microsoft.Web.WebView2/1.0.3537.50/License
+- Version: 1.0.3595.46
+- License: https://www.nuget.org/packages/Microsoft.Web.WebView2/1.0.3595.46/License
 - Platform: Win32
 - Managed by: `cmake/Modules/AXConfigDefine.cmake`
 
 ## gradle
 
 - [![github](https://img.shields.io/github/v/release/gradle/gradle?label=Upstream)](https://github.com/gradle/gradle)
-- Version: 9.2.0
+- Version: 9.2.1
 - License: Apache-2.0
 - Platform: Android
 - Manged by: `1k/build.profiles`

cmake/Modules/AXConfigDefine.cmake

@@ -30,7 +30,7 @@ if(WINRT)
   set(CMAKE_C_FLAGS "/sdl- ${CMAKE_C_FLAGS}")
   set(CMAKE_CXX_FLAGS "/sdl- ${CMAKE_CXX_FLAGS}")
 elseif(WIN32)
-  set(AX_MSEDGE_WEBVIEW2_VERSION "1.0.3537.50" CACHE STRING "")
+  set(AX_MSEDGE_WEBVIEW2_VERSION "1.0.3595.46" CACHE STRING "")
 endif()
 
 # config c standard

core/CMakeLists.txt

@@ -130,7 +130,7 @@ option(AX_ENABLE_EXT_EFFEKSEER "Build extension Effekseer" OFF)
 
 cmake_dependent_option(AX_ENABLE_EXT_PARTICLE3D "Build extension Particle3D" ${AX_EXT_HINT} "AX_ENABLE_3D" OFF)
 cmake_dependent_option(AX_ENABLE_EXT_PHYSICS_NODE "Build extension physics-nodes" ${AX_EXT_HINT} "AX_ENABLE_PHYSICS" OFF)
-cmake_dependent_option(AX_ENABLE_EXT_IMGUI "Build extension ImGui" ${AX_EXT_HINT} "(WINDOWS AND NOT WINRT) OR MACOSX OR LINUX OR ANDROID OR WASM" OFF)
+cmake_dependent_option(AX_ENABLE_EXT_IMGUI "Build extension ImGui" ${AX_EXT_HINT} "NOT IOS AND NOT WINRT" OFF)
 cmake_dependent_option(AX_ENABLE_EXT_INSPECTOR "Build extension Inspector" ${AX_EXT_HINT} "AX_ENABLE_EXT_IMGUI" OFF)
 cmake_dependent_option(AX_ENABLE_EXT_SDFGEN "Build extension SDFGen" ${AX_EXT_HINT} "AX_ENABLE_EXT_IMGUI" OFF)
 

core/axmolver.h.in

@@ -4,8 +4,8 @@
 // 0x00 HI ME LO
 // 00   03 08 00
 #define AX_VERSION_MAJOR 2
-#define AX_VERSION_MINOR 9
-#define AX_VERSION_PATCH 1
+#define AX_VERSION_MINOR 10
+#define AX_VERSION_PATCH 0
 
 /* Define axmol version helper macros */
 #define AX_VERSION_MAKE(a, b, c) ((a << 16) | (b << 8) | (c & 0xff))

docs/DevSetup.md

@@ -7,7 +7,7 @@
      - macOS, Ubuntu, ArchLinux: run `setup.ps1` in `axmol` root directory (recommended).
      - Windows 10+: system installed PowerShell 5.x should work. You will need to run the command `Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy Bypass -Force` in order to allow PowerShell script to run. This will allow execution of PowerShell scripts for the current user, which is required if you have downloaded the ZIP release of Axmol. If you instead cloned the Axmol repository, then you can use `Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned -Force` instead, which is more secure.
   - Manual installation: [Instructions](https://learn.microsoft.com/en-us/powershell/scripting/install/installing-powershell) /  [Download](https://github.com/PowerShell/PowerShell/releases)
-- **CMake 3.28.1+**
+- **CMake 4.2.0+**
     - Manual installation is recommended ([download](https://cmake.org/download/)). Make sure to add CMake bin to the system `PATH`, otherwise `axmol build` will auto-setup it to `tools/external/cmake`.
 
 ## Prerequisites
@@ -17,7 +17,7 @@
   3. Run `setup.ps1` in windows powershell or (macOS/Linux/ArchLinux terminal).
   4. Restart the console after it has finished for environment variables to take effect.
   5. Ensure that the C / C++ compiler toolset is installed on your host machine.
-     - Windows: Visual Studio 2022 with desktop workflow
+     - Windows: Visual Studio 2022/2026 with desktop workflow
      - macOS: XCode 14.2+
      - Linux: GCC (G++)
 
@@ -118,31 +118,55 @@ Using a PowerShell console window (command `pwsh`), go to `axmol\tests\<testdir
 
 ## Manually build with CMake
 
-### Windows (Visual Studio 2022)
-
-  1. Install [CMake 3.27.4+](https://cmake.org/download/).
-  2. Install Visual Studio 2022.
-  3. Create a new project as shown [here](#creating-a-new-project).
-  4. In a console window, navigate into the root directory of the project you created in the previous step.
-  5. Generate the relevant Visual Studio project using the cmake command:
-  
-     ```axmol build``` command described in the previous sections (preferred method)
-     or
-     ```cmake -S SOURCE_DIR -B BUILD_DIR -G VISUAL_STUDIO_VERSION_STRING -A [Win32|x64]```
-
-     For example, let's say `SOURCE_DIR` is the current path `"."`, and `BUILD_DIR` (out-of-source build directory) is named `"build"`:
-
-     (Since Axmol 2.1 c++20 is required for all platforms)
-        - 32 bit Visual Studio 2019:
-            ```cmake -S . -B build -G "Visual Studio 16 2019" -A Win32```
-        - 64 bit Visual Studio 2019:
-            ```cmake -S . -B build -G "Visual Studio 16 2019" -A x64```
-        - 32 bit Visual Studio 2022:
-            ```cmake -S . -B build -G "Visual Studio 17 2022" -A Win32```
-        - 64 bit Visual Studio 2022:
-            ```cmake -S . -B build -G "Visual Studio 17 2022" -A x64```
-
-  6. Use Visual Studio to open the newly created solution file. For example, `./build/ProjectName.sln`.
+### Windows (Visual Studio 2022/2026)
+
+> **Note:** Visual Studio 2026 is supported, but requires [CMake 4.2.0+](https://cmake.org/download/).  
+> Use generator string `-G "Visual Studio 18 2026"` when invoking cmake.
+
+1. Install [CMake 4.2.0+](https://cmake.org/download/).
+2. Install Visual Studio 2022 (or 2026 if preferred).
+3. Create a new project as shown [here](#creating-a-new-project).
+4. In a console window, navigate to the root directory of your project.
+5. Generate the Visual Studio project using either:
+   - The recommended shortcut:
+     ```bash
+     axmol build
+     ```
+   - Or directly with cmake:
+     ```bash
+     cmake -S SOURCE_DIR -B BUILD_DIR -G "Visual Studio <version>" -A [Win32|x64]
+     ```
+
+   Example (`SOURCE_DIR = "."`, `BUILD_DIR = "build"`):  
+   *(Since Axmol 2.1, C++20 is required on all platforms)*
+
+   - **Visual Studio 2022 (32-bit):**
+     ```bash
+     cmake -S . -B build -G "Visual Studio 17 2022" -A Win32
+     ```
+   - **Visual Studio 2022 (64-bit):**
+     ```bash
+     cmake -S . -B build -G "Visual Studio 17 2022" -A x64
+     ```
+   - **Visual Studio 2026 (64-bit):**
+     ```bash
+     cmake -S . -B build -G "Visual Studio 18 2026" -A x64
+     ```
+     *(requires CMake 4.2.0+)*  
+
+
+  6. Use Visual Studio to open the newly created solution file:
+
+   - **Visual Studio 2022**  
+     ```text
+     ./build/ProjectName.sln
+     ```
+
+   - **Visual Studio 2026**  
+     ```text
+     ./build/ProjectName.slnx
+     ```
+     *(Note: VS2026 introduces the new `.slnx` solution file format.)*
 
 #### Windows UWP (Visual Studio 2022)
 

templates/common/proj.android/gradle/wrapper/gradle-wrapper.properties

@@ -1,6 +1,6 @@
-#Fri Oct 31 21:24:14 UTC+08 2025
+#Thu Nov 27 12:13:44 UTC+08 2025
 distributionBase=GRADLE_USER_HOME
 distributionPath=wrapper/dists
-distributionUrl=https\://services.gradle.org/distributions/gradle-9.2.0-bin.zip
+distributionUrl=https\://services.gradle.org/distributions/gradle-9.2.1-bin.zip
 zipStoreBase=GRADLE_USER_HOME
 zipStorePath=wrapper/dists

tests/cpp-tests/CMakeLists.txt

@@ -386,7 +386,9 @@ list(APPEND GAME_SOURCE
    Source/Box2DTest/Box2dTest.cpp
 )
 
-if((WINDOWS OR MACOSX OR LINUX OR WASM) AND (NOT WINRT) AND AX_ENABLE_EXT_IMGUI)
+
+if(NOT IOS AND NOT ANDROID AND AX_ENABLE_EXT_IMGUI)
+    # android support imgui, but box2d testbed not adapt for android which requires GLFW_KEY_XX
     list(APPEND GAME_HEADER
         Source/Box2DTestBed/tests/test.h
         Source/Box2DTestBed/tests/settings.h
@@ -587,7 +589,7 @@ endif()
 
 if((NOT IOS) AND (NOT WINRT))
     message(STATUS "CMake precompile headers for ${APP_NAME}")
-    target_precompile_headers(${APP_NAME} PRIVATE 
+    target_precompile_headers(${APP_NAME} PRIVATE
       "$<$<COMPILE_LANGUAGE:CXX>:axmol.h>"
     )
 endif()

tests/cpp-tests/Source/controller.cpp

@@ -58,11 +58,11 @@ class RootTests : public TestList
         addTest("AudioEngine", []() { return new AudioEngineTests(); });
 
         addTest("Box2D - Basic", []() { return new Box2DTests(); });
-#if AX_ENABLE_EXT_IMGUI
+#if AX_ENABLE_EXT_IMGUI && AX_TARGET_PLATFORM != AX_PLATFORM_ANDROID
         addTest("Box2D - TestBed", []() { return new Box2DTestBedTests(); });
 #endif
         addTest("Chipmunk2D - Basic", []() { return new ChipmunkTests(); });
-#if AX_ENABLE_EXT_IMGUI
+#if defined(AX_PLATFORM_PC) || defined(__EMSCRIPTEN__)
         addTest("Chipmunk2D - TestBed", []() { return new ChipmunkTestBedTests(); });
 #endif
         addTest("Bugs", []() { return new BugsTests(); });
@@ -189,7 +189,7 @@ Coroutine TestController::traverseTestList(TestList* testList)
          _logIndentation += LOG_INDENTATION;
      }
 
-     co_yield DelayTime::create(0.5);  
+     co_yield DelayTime::create(0.5);
      AXLOGD("{}{}Begin traverse TestList:{}", LOG_TAG, _logIndentation, testList->getTestName());
 
      auto scheduler = _director->getScheduler();
@@ -201,7 +201,7 @@ Coroutine TestController::traverseTestList(TestList* testList)
          while (_isRunInBackground)
          {
              AXLOGD("_director is paused");
-             co_yield DelayTime::create(0.5);  
+             co_yield DelayTime::create(0.5);
          }
          if (callback)
          {
@@ -288,7 +288,7 @@ Coroutine TestController::traverseTestList(TestList* testList)
              {
                  testCase         = (TestCase*)transitionScene->getInScene();
                  testCaseDuration = transitionScene->getDuration() + 0.5f;
-                 
+
              }
              else
              {