Skip to content

[RUN-5189] Upgrade Java Migration Tool docs to 1.0.2 (Mendix 11.14.0) #11618

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
atennapel wants to merge 2 commits into
base: development
Choose a base branch
from
+15 −10
Open

[RUN-5189] Upgrade Java Migration Tool docs to 1.0.2 (Mendix 11.14.0) #11618

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
7588600
Upgrade JMT docs to 1.0.2
atennapel-mx Jul 27, 2026
b0d90e3
Update offline installation docs
atennapel-mx Jul 27, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions content/en/docs/refguide/installation/install.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down Expand Up @@ -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:
Expand Down
21 changes: 11 additions & 10 deletions content/en/docs/refguide/java-programming/java-migration-tool.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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}

Expand All @@ -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 <COMMAND> [OPTIONS]`.
Run the tool with `java -jar jmt-1.0.2.jar <COMMAND> [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 |
|---------|-------------|
Expand Down Expand Up @@ -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}
Expand Down Expand Up @@ -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.

Expand Down