Update android sdk tools: agp to 8.11.0, gradle to 8.14.3 (#2585)

Author: halx99

1k/build.profiles

@@ -10,7 +10,7 @@ axslcc=1.9.6+
 
 # The cmake, @gradle @axmol-cmdline
 # as latest as possible
-cmake=3.30.0~4.0.2+
+cmake=3.30.0~4.0.3+
 
 # The ninja
 ninja=1.10.0~1.12.1+
@@ -58,19 +58,19 @@ min_sdk=17
 
 # The gradle version, @setup.ps1
 # as latest as possible
-gradle=8.13
+gradle=8.14.3
 
 # The android gradle plugin, @setup.ps1
 # as stable as possible, match with build-tools,android-studio
-agp=8.10.0
+agp=8.11.0
 
 # The android build-tools, @axmol-cmdline @gradle
 # as stable as possible, match with agp,android-studio
 buildtools=35.0.0
 
 # The android studio, @hint
 # as latest as possible, but match with agp, build-tools
-androidstudio=2024.3.2+
+androidstudio=2025.1.1+
 
 # The android dependencies managed by @gradle 
 appcompat=1.7.0

docs/DevSetup.md

@@ -162,19 +162,19 @@ Please see the [Windows workflow guide](https://github.com/axmolengine/axmol/iss
 
 ### Android (with Android Studio)
 
-  1. Install [Android Studio 2024.3.2+](https://developer.android.com/studio).
+  1. Install [Android Studio 2025.1.1+](https://developer.android.com/studio).
   2. When starting Android Studio for the first time, it will guide you through the installation of the SDK and other tools. Please make sure that you do install them.
   3. Ensure that the ANDROID_HOME environment variable is set up correctly to point to the Android SDK folder.
   4. Open a *new* Powershell instance, and enter the `axmol` root directory in Powershell.
   5. Run `./setup.ps1 -p android` to download the a supported version of the NDK, which in this case is r23d. You can set a project to use a different version of the NDK.
   6. Start Android Studio and choose [Open an existing Android Studio Project] and select your project. For example, the existing `cpp-test` project located in `axmol\tests\cpp-tests\proj.android`.
   7. Start Android Studio and open 'Tools' -> 'SDKManager', then switch to 'SDK Tools', check the 'Show Package Details' field, and choose the following tools clicking the button 'Apply' to install them:  
      - Android SDK Platform 36
-     - Android Gradle Plugin (AGP) 8.10.0
+     - Android Gradle Plugin (AGP) 8.11.0
      - Android SDK Build-Tools 35.0.0 match with AGP, refer to: <https://developer.android.com/studio/releases/gradle-plugin>
-     - Gradle 8.13
+     - Gradle 8.14.3
      - NDK r23c, if you need support Android 15 16KB page size, you must use r23d or r27+
-     - __IMPORTANT__: axmol itself not use all c++20 features, so just require ndk-r23c+, if you need more c++20 feature in your game project, consider use NDK r26+
+     - __IMPORTANT__: axmol itself not use all c++20 features, so just require ndk-r23c+, if you need more c++20 feature in your game project, consider use NDK r26+ (LTS version r27c is recommended)
   8. Wait for the `Gradle sync` to finish.
 
 Note: if you use non-SDK provided CMake, you will need to download `ninja` from <https://github.com/ninja-build/ninja/releases>, and copy `ninja.exe` to CMake's bin directory.

setup.ps1

@@ -377,6 +377,9 @@ if (!(Test-Path $prefix -PathType Container)) {
 . $1k_script -setupOnly -prefix $prefix @args
 
 if ($updateAdt) {
+    [System.Threading.Thread]::CurrentThread.CurrentCulture = 'en-US'
+    $current_time = Get-Date -UFormat "%a %b %e %T UTC%Z %Y"
+
     # ---------- Update gradle ----------
     $gradleVer = $build_profiles['gradle']
     $aproj_source_root = Join-Path $AX_ROOT 'templates/common/proj.android'
@@ -391,8 +394,16 @@ if ($updateAdt) {
     }
 
     $gradle_settings_file = Join-Path $aproj_source_gradle_wrapper 'gradle-wrapper.properties'
-    $settings_content = [System.IO.File]::ReadAllText($gradle_settings_file)
-    $settings_content = [Regex]::Replace($settings_content, 'gradle-.+-bin.zip', "gradle-$gradleVer-bin.zip")
+    $settings_lines = Get-Content $gradle_settings_file
+    $settings_lines[0] = "#$current_time"
+    for($i = 1; $i -lt $settings_lines.Count; ++$i) {
+        $line_text = $settings_lines[$i]
+        if ($line_text -match '^distributionUrl\s*=.*') {
+            $settings_lines[$i] = [Regex]::Replace($line_text, 'gradle-.+-bin.zip', "gradle-$gradleVer-bin.zip")
+            break
+        }
+    }
+    $settings_content = $settings_lines -join "`n"
     [System.IO.File]::WriteAllText($gradle_settings_file, $settings_content)
 
     # download gradle-wrapper.jar gradlew and gradlew.bat from upstream

templates/common/proj.android/build.gradle

@@ -7,7 +7,7 @@ buildscript {
     }
 
     dependencies {
-        classpath 'com.android.tools.build:gradle:8.10.0'
+        classpath 'com.android.tools.build:gradle:8.11.0'
 
         // NOTE: Do not place your application dependencies here; they belong
         // in the individual module build.gradle files

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

@@ -1,6 +1,6 @@
-#Sat Apr 6 23:59:59 CST 2024
+#Sun Jul  6 00:44:51 UTC+08 2025
 distributionBase=GRADLE_USER_HOME
 distributionPath=wrapper/dists
-distributionUrl=https\://services.gradle.org/distributions/gradle-8.13-bin.zip
+distributionUrl=https\://services.gradle.org/distributions/gradle-8.14.3-bin.zip
 zipStoreBase=GRADLE_USER_HOME
 zipStorePath=wrapper/dists

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

@@ -7,7 +7,7 @@ buildscript {
     }
 
     dependencies {
-        classpath 'com.android.tools.build:gradle:8.10.0'
+        classpath 'com.android.tools.build:gradle:8.11.0'
 
         // NOTE: Do not place your application dependencies here; they belong
         // in the individual module build.gradle files