From 758860099de93ab731e24f0aa2306cad3078baed Mon Sep 17 00:00:00 2001 From: Albert ten Napel Date: Mon, 27 Jul 2026 19:21:54 +0200 Subject: [PATCH 1/2] Upgrade JMT docs to 1.0.2 --- .../java-programming/java-migration-tool.md | 21 ++++++++++--------- 1 file changed, 11 insertions(+), 10 deletions(-) diff --git a/content/en/docs/refguide/java-programming/java-migration-tool.md b/content/en/docs/refguide/java-programming/java-migration-tool.md index 00f75b62ca7..57b0c7d991d 100644 --- a/content/en/docs/refguide/java-programming/java-migration-tool.md +++ b/content/en/docs/refguide/java-programming/java-migration-tool.md @@ -13,7 +13,7 @@ The tool complements the [Update Assistant (Beta)](/refguide/update-assistant/) ## Installation {#installation} -Download the tool from Mendix CDN: https://cdn.mendix.com/mendix-java-migration-tool/jmt-1.0.1.jar +Download the tool from Mendix CDN: https://cdn.mendix.com/mendix-java-migration-tool/jmt-1.0.2.jar ## Basic Usage {#basic-usage} @@ -24,22 +24,22 @@ The following example rewrites all Java files in your app's `javasource/` folde This example assumes: * The Java executable is saved to `C:\Program Files\Eclipse Adoptium\jdk-21.0.5.11-hotspot\bin\java` -* `jmt-1.0.1.jar` is saved to the current folder +* `jmt-1.0.2.jar` is saved to the current folder * Mendix 11.11.0 is installed at `C:\Program Files\Mendix\11.11.0` * Your app folder is `C:\Users\YourName\Mendix\MyApp` ```cmd -"C:\Program Files\Eclipse Adoptium\jdk-21.0.5.11-hotspot\bin\java" -jar jmt-1.0.1.jar rewrite --to-version 11.11 --studio-pro "C:\Program Files\Mendix\11.11.0" --project-root "C:\Users\YourName\Mendix\MyApp" +"C:\Program Files\Eclipse Adoptium\jdk-21.0.5.11-hotspot\bin\java" -jar jmt-1.0.2.jar rewrite --to-version 11.11 --studio-pro "C:\Program Files\Mendix\11.11.0" --project-root "C:\Users\YourName\Mendix\MyApp" ``` Replace the paths and version number with the actual values for your installation. For all available commands and options, see [Commands](#commands) and [Options](#options). ## Commands {#commands} -Run the tool with `java -jar jmt-1.0.1.jar [OPTIONS]`. +Run the tool with `java -jar jmt-1.0.2.jar [OPTIONS]`. * If Java is on your `PATH`, call `java` directly. If not, provide the full path to the `java` executable. -* Run the command from the folder where you saved `jmt-1.0.1.jar`, or specify its full path in the command. +* Run the command from the folder where you saved `jmt-1.0.2.jar`, or specify its full path in the command. | Command | Description | |---------|-------------| @@ -77,21 +77,21 @@ For the same reason, the Java code in your project must have been successfully c ```bash # List available recipes -java -jar jmt-1.0.1.jar recipes +java -jar jmt-1.0.2.jar recipes # Apply with full project context for accurate type resolution -java -jar jmt-1.0.1.jar rewrite javasource/ -t 11.2.0 \ +java -jar jmt-1.0.2.jar rewrite javasource/ -t 11.2.0 \ -p /path/to/mendix-project \ -s "/path/to/Studio Pro 11.2.0" # Preview changes without writing (dry run) -java -jar jmt-1.0.1.jar rewrite javasource/ -t 11.2.0 -n +java -jar jmt-1.0.2.jar rewrite javasource/ -t 11.2.0 -n # Apply all applicable recipes to the javasource folder -java -jar jmt-1.0.1.jar rewrite javasource/ -t 11.2.0 +java -jar jmt-1.0.2.jar rewrite javasource/ -t 11.2.0 # Machine-readable output for CI/CD integration -java -jar jmt-1.0.1.jar rewrite javasource/ -t 11.2.0 -o json +java -jar jmt-1.0.2.jar rewrite javasource/ -t 11.2.0 -o json ``` ### Output Formats {#output-formats} @@ -137,6 +137,7 @@ Total changes: 2 ## Release Notes +* v1.0.2 - Added the `ReplaceEventHandlers` recipe to handle the `ActionListener.add\*Event` and `ListenersRegistry.register\*Listener` deprecated methods. * v1.0.1 – Fixed a bug in `retrieveXPathQuery` replacement recipe where helper methods were not properly imported. The recipe now generates helper methods with fully qualified class names. * v1.0.0 – Initial release. From b0d90e38e3fce4e3ef76cefb2eca3bcf94b991ec Mon Sep 17 00:00:00 2001 From: Albert ten Napel Date: Mon, 27 Jul 2026 19:25:25 +0200 Subject: [PATCH 2/2] Update offline installation docs --- content/en/docs/refguide/installation/install.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/content/en/docs/refguide/installation/install.md b/content/en/docs/refguide/installation/install.md index 5d4b3e10dee..42bd0574d97 100644 --- a/content/en/docs/refguide/installation/install.md +++ b/content/en/docs/refguide/installation/install.md @@ -68,6 +68,8 @@ Git version 2.48.1 is automatically installed during Studio Pro installation. Ho * [Gradle 8.5](https://gradle.org/install/#manually) with Gradle extracted to the parent directory of the folder where Studio Pro is installed (usually `C:\Program Files\Mendix`) instead of `C:\Gradle`. +* [Mendix Java Migration Tool 1.0.2](https://cdn.mendix.com/mendix-java-migration-tool/jmt-1.0.2.jar) + Depending on the error message you get from the installer, you can choose to install a single prerequisite, or you can install them all. Then, try installing Studio Pro again. @@ -105,6 +107,8 @@ It is possible to prepare the prerequisite installers beforehand so the setup pr * The *MicrosoftEdgeWebview2Setup.exe* does not need to be renamed 7. Gradle * Rename the Gradle zip file to *gradle-8.5-bin.zip* + 8. Mendix Java Migration Tool (JMT) + * Place *jmt-1.0.2.jar* into the **Dependencies** folder without renaming it 6. Run the installer as described in the [Installing Mendix Studio Pro](#install) section above. If an error occurs during JDK installation, try the following: