From b300e198d3a4401f0944a02038a1cd4b94128d23 Mon Sep 17 00:00:00 2001
From: Martin Rais <martin.rais@broadcom.com>
Date: Thu, 13 Nov 2025 15:37:26 +0100
Subject: [PATCH 1/3] openapi-generator-cli is not compatible with Gradle 9.x

Enforce the latest 8.x version until the compatibility issue is solved. See: https://github.com/OpenAPITools/openapi-generator/issues/22084
---
 .../downloader/gradle/bootstrap/bootstrap-gradlew.bat      | 6 ++++--
 .../downloader/gradle/bootstrap/bootstrap-gradlew.sh       | 7 +++----
 .../favorites/gradle/bootstrap/bootstrap-gradlew.bat       | 6 ++++--
 .../favorites/gradle/bootstrap/bootstrap-gradlew.sh        | 7 +++----
 4 files changed, 14 insertions(+), 12 deletions(-)

diff --git a/output-management/web-viewer/downloader/gradle/bootstrap/bootstrap-gradlew.bat b/output-management/web-viewer/downloader/gradle/bootstrap/bootstrap-gradlew.bat
index 581dcb8..6fbad51 100644
--- a/output-management/web-viewer/downloader/gradle/bootstrap/bootstrap-gradlew.bat
+++ b/output-management/web-viewer/downloader/gradle/bootstrap/bootstrap-gradlew.bat
@@ -1,16 +1,18 @@
 @echo off
 
+SET GRADLE_WRAPPER_GITHUB_URL="https://raw.githubusercontent.com/gradle/gradle/refs/tags/v8.14.3/gradle/wrapper"
+
 if not exist gradle\wrapper\gradle-wrapper.jar (
     echo Gradle wrapper not found. Attempting to download...
 
     mkdir gradle\wrapper
 
-    powershell -Command "& {wget https://raw.githubusercontent.com/gradle/gradle/master/gradle/wrapper/gradle-wrapper.jar -OutFile gradle/wrapper/gradle-wrapper.jar}"
+    powershell -Command "& {wget %GRADLE_WRAPPER_GITHUB_URL%/gradle-wrapper.jar -OutFile gradle/wrapper/gradle-wrapper.jar}"
     IF ERRORLEVEL 1  (
         echo Gradle wrapper jar download failed. Bootstrap failed.
     )
 
-    powershell -Command "& {wget https://raw.githubusercontent.com/gradle/gradle/master/gradle/wrapper/gradle-wrapper.properties -OutFile gradle/wrapper/gradle-wrapper.properties}"
+    powershell -Command "& {wget %GRADLE_WRAPPER_GITHUB_URL%/gradle-wrapper.properties -OutFile gradle/wrapper/gradle-wrapper.properties}"
     IF ERRORLEVEL 1  (
         echo Gradle wrapper properties download failed. Bootstrap failed.
     )
diff --git a/output-management/web-viewer/downloader/gradle/bootstrap/bootstrap-gradlew.sh b/output-management/web-viewer/downloader/gradle/bootstrap/bootstrap-gradlew.sh
index e30be42..b4ccfdd 100755
--- a/output-management/web-viewer/downloader/gradle/bootstrap/bootstrap-gradlew.sh
+++ b/output-management/web-viewer/downloader/gradle/bootstrap/bootstrap-gradlew.sh
@@ -2,21 +2,20 @@
 
 DIR=gradle/wrapper
 JAR=${DIR}/gradle-wrapper.jar
+GRADLE_WRAPPER_GITHUB_URL="https://raw.githubusercontent.com/gradle/gradle/refs/tags/v8.14.3/gradle/wrapper"
 
 if [ ! -f ${DIR}/gradle-wrapper.jar ]; then
     echo "Gradle wrapper not found. Attempting to download..."
 
     mkdir -p "${DIR}"
 
-    curl --silent --output ${DIR}/gradle-wrapper.jar \
-            https://raw.githubusercontent.com/gradle/gradle/master/gradle/wrapper/gradle-wrapper.jar
+    curl --silent --output ${DIR}/gradle-wrapper.jar ${GRADLE_WRAPPER_GITHUB_URL}/gradle-wrapper.jar
     if [ $? != 0 ]; then
         echo "Gradle wrapper jar download failed. Bootstrap failed."
         exit 1
     fi
 
-    curl --silent --output ${DIR}/gradle-wrapper.properties \
-            https://raw.githubusercontent.com/gradle/gradle/master/gradle/wrapper/gradle-wrapper.properties
+    curl --silent --output ${DIR}/gradle-wrapper.properties ${GRADLE_WRAPPER_GITHUB_URL}/gradle-wrapper.properties
     if [ $? != 0 ]; then
         echo "Gradle wrapper properties download failed. Bootstrap failed."
         exit 2
diff --git a/output-management/web-viewer/favorites/gradle/bootstrap/bootstrap-gradlew.bat b/output-management/web-viewer/favorites/gradle/bootstrap/bootstrap-gradlew.bat
index 581dcb8..6fbad51 100644
--- a/output-management/web-viewer/favorites/gradle/bootstrap/bootstrap-gradlew.bat
+++ b/output-management/web-viewer/favorites/gradle/bootstrap/bootstrap-gradlew.bat
@@ -1,16 +1,18 @@
 @echo off
 
+SET GRADLE_WRAPPER_GITHUB_URL="https://raw.githubusercontent.com/gradle/gradle/refs/tags/v8.14.3/gradle/wrapper"
+
 if not exist gradle\wrapper\gradle-wrapper.jar (
     echo Gradle wrapper not found. Attempting to download...
 
     mkdir gradle\wrapper
 
-    powershell -Command "& {wget https://raw.githubusercontent.com/gradle/gradle/master/gradle/wrapper/gradle-wrapper.jar -OutFile gradle/wrapper/gradle-wrapper.jar}"
+    powershell -Command "& {wget %GRADLE_WRAPPER_GITHUB_URL%/gradle-wrapper.jar -OutFile gradle/wrapper/gradle-wrapper.jar}"
     IF ERRORLEVEL 1  (
         echo Gradle wrapper jar download failed. Bootstrap failed.
     )
 
-    powershell -Command "& {wget https://raw.githubusercontent.com/gradle/gradle/master/gradle/wrapper/gradle-wrapper.properties -OutFile gradle/wrapper/gradle-wrapper.properties}"
+    powershell -Command "& {wget %GRADLE_WRAPPER_GITHUB_URL%/gradle-wrapper.properties -OutFile gradle/wrapper/gradle-wrapper.properties}"
     IF ERRORLEVEL 1  (
         echo Gradle wrapper properties download failed. Bootstrap failed.
     )
diff --git a/output-management/web-viewer/favorites/gradle/bootstrap/bootstrap-gradlew.sh b/output-management/web-viewer/favorites/gradle/bootstrap/bootstrap-gradlew.sh
index e30be42..b4ccfdd 100755
--- a/output-management/web-viewer/favorites/gradle/bootstrap/bootstrap-gradlew.sh
+++ b/output-management/web-viewer/favorites/gradle/bootstrap/bootstrap-gradlew.sh
@@ -2,21 +2,20 @@
 
 DIR=gradle/wrapper
 JAR=${DIR}/gradle-wrapper.jar
+GRADLE_WRAPPER_GITHUB_URL="https://raw.githubusercontent.com/gradle/gradle/refs/tags/v8.14.3/gradle/wrapper"
 
 if [ ! -f ${DIR}/gradle-wrapper.jar ]; then
     echo "Gradle wrapper not found. Attempting to download..."
 
     mkdir -p "${DIR}"
 
-    curl --silent --output ${DIR}/gradle-wrapper.jar \
-            https://raw.githubusercontent.com/gradle/gradle/master/gradle/wrapper/gradle-wrapper.jar
+    curl --silent --output ${DIR}/gradle-wrapper.jar ${GRADLE_WRAPPER_GITHUB_URL}/gradle-wrapper.jar
     if [ $? != 0 ]; then
         echo "Gradle wrapper jar download failed. Bootstrap failed."
         exit 1
     fi
 
-    curl --silent --output ${DIR}/gradle-wrapper.properties \
-            https://raw.githubusercontent.com/gradle/gradle/master/gradle/wrapper/gradle-wrapper.properties
+    curl --silent --output ${DIR}/gradle-wrapper.properties ${GRADLE_WRAPPER_GITHUB_URL}/gradle-wrapper.properties
     if [ $? != 0 ]; then
         echo "Gradle wrapper properties download failed. Bootstrap failed."
         exit 2

From 49cb68d638b2c4455b855da747e42b67cc960f5c Mon Sep 17 00:00:00 2001
From: Martin Rais <martin.rais@broadcom.com>
Date: Thu, 13 Nov 2025 15:54:50 +0100
Subject: [PATCH 2/3] Remove unused variable

---
 .../web-viewer/downloader/gradle/bootstrap/bootstrap-gradlew.sh  | 1 -
 .../web-viewer/favorites/gradle/bootstrap/bootstrap-gradlew.sh   | 1 -
 2 files changed, 2 deletions(-)

diff --git a/output-management/web-viewer/downloader/gradle/bootstrap/bootstrap-gradlew.sh b/output-management/web-viewer/downloader/gradle/bootstrap/bootstrap-gradlew.sh
index b4ccfdd..dd7fde2 100755
--- a/output-management/web-viewer/downloader/gradle/bootstrap/bootstrap-gradlew.sh
+++ b/output-management/web-viewer/downloader/gradle/bootstrap/bootstrap-gradlew.sh
@@ -1,7 +1,6 @@
 #!/usr/bin/env sh
 
 DIR=gradle/wrapper
-JAR=${DIR}/gradle-wrapper.jar
 GRADLE_WRAPPER_GITHUB_URL="https://raw.githubusercontent.com/gradle/gradle/refs/tags/v8.14.3/gradle/wrapper"
 
 if [ ! -f ${DIR}/gradle-wrapper.jar ]; then
diff --git a/output-management/web-viewer/favorites/gradle/bootstrap/bootstrap-gradlew.sh b/output-management/web-viewer/favorites/gradle/bootstrap/bootstrap-gradlew.sh
index b4ccfdd..dd7fde2 100755
--- a/output-management/web-viewer/favorites/gradle/bootstrap/bootstrap-gradlew.sh
+++ b/output-management/web-viewer/favorites/gradle/bootstrap/bootstrap-gradlew.sh
@@ -1,7 +1,6 @@
 #!/usr/bin/env sh
 
 DIR=gradle/wrapper
-JAR=${DIR}/gradle-wrapper.jar
 GRADLE_WRAPPER_GITHUB_URL="https://raw.githubusercontent.com/gradle/gradle/refs/tags/v8.14.3/gradle/wrapper"
 
 if [ ! -f ${DIR}/gradle-wrapper.jar ]; then

From 227242949f0d56071a0480bf8c6dbd403d7b18bd Mon Sep 17 00:00:00 2001
From: Martin Rais <martin.rais@broadcom.com>
Date: Thu, 13 Nov 2025 17:09:34 +0100
Subject: [PATCH 3/3] Document compatibility issue

---
 output-management/web-viewer/downloader/README.md | 5 +++++
 output-management/web-viewer/favorites/README.md  | 5 +++++
 2 files changed, 10 insertions(+)

diff --git a/output-management/web-viewer/downloader/README.md b/output-management/web-viewer/downloader/README.md
index c8b313f..7a89206 100644
--- a/output-management/web-viewer/downloader/README.md
+++ b/output-management/web-viewer/downloader/README.md
@@ -50,6 +50,11 @@ Other OS:
     npm ci
 
 ### Build
+> [!CAUTION]
+> There is a [Gradle 9.x compatibility issue](https://github.com/OpenAPITools/openapi-generator/issues/22084)
+in the OpenAPI Generator. Verify that the `distributionUrl` property in the
+`gradle\wrapper\gradle-wrapper.properties` file contains `gradle-8.14.2-bin.zip`.
+If not, delete the `gradle\wrapper` folder and perform the [First-time Initialization](#first-time-initialization).
 
 Use the following commands to build the application.
 
diff --git a/output-management/web-viewer/favorites/README.md b/output-management/web-viewer/favorites/README.md
index 3c22feb..9fa1e0f 100644
--- a/output-management/web-viewer/favorites/README.md
+++ b/output-management/web-viewer/favorites/README.md
@@ -51,6 +51,11 @@ Other OS:
     npm ci
 
 ### Build
+> [!CAUTION]
+> There is a [Gradle 9.x compatibility issue](https://github.com/OpenAPITools/openapi-generator/issues/22084)
+in the OpenAPI Generator. Verify that the `distributionUrl` property in the
+`gradle\wrapper\gradle-wrapper.properties` file contains `gradle-8.14.2-bin.zip`.
+If not, delete the `gradle\wrapper` folder and perform the [First-time Initialization](#first-time-initialization).
 
 Use the following commands to build the application.