The mx tool is a Windows and Linux command-line tool that can be used to do useful things with your Mendix app project.
Mendix Studio Pro comes with the mx command-line tool. The executable
mx.exe file can be found in the same folder that contains
studiopro.exe (for example, C:\Program Files\Mendix\18.104.22.168215\modeler\mx.exe).
3 mx Tool Options
The mx tool enables the options described below.
mx convert command converts the inputted app project(s) to the Studio Pro version with which the tool was bundled. For example, if you are using the mx command-line tool that came with Mendix version 22.214.171.124215, then
mx convert will convert app projects to that version.
The input can be a single file, directory, or multiple files.
The mx tool can only upgrade. You cannot use it to convert to a lower version.
Use this command pattern for
mx convert [OPTIONS] INPUT... OUTPUT
These are the
||Displays the help text and exits.|
||Convert an app project directory in place. Use this option to convert a folder containing a Mendix app project. Otherwise,
||Does not check for errors. Use this option to disable app project error-checking during the conversion. When omitted, the tool will report on the number of errors, warnings, and deprecations in the app project and do the conversion.|
INPUT..., enter one or more .mpk files or one directory that needs to be converted.
OUTPUT, enter the output location for the converted results. Keep the following points in mind:
INPUT...is a single file,
OUTPUTcan be a single file or directory; otherwise,
OUTPUTmust be a directory.
- When using the
INPUT...folder will also be used as the
OUTPUTfolder, so you do not need to specify a separate
||Converts the app project in folder C:\MxProjects\App-main to the Studio Pro version with which the mx tool was bundled.|
||Converts the App1.mpk and App2.mpk app project packages that are in the *C:\Mendix* folder and puts the results in the *C:\Mendix\ConvertedProjects* folder.|
||Converts all app project packages in the *C:\Mendix\Packages* folder and outputs to the *C:\Mendix\ConvertedPackages* folder without checking for errors.|
3.1.5 Return Codes
|0||The conversion was successful.|
|1||An internal error occurred.|
|2||There is something wrong with the command-line options.|
|3||Converting the project(s) failed.|
3.2 Undocumented Options
The mx tool contains options that are not described in this document. Those are for internal Mendix usage and are not officially supported. This might change in the future, but these options can be used only at your own risk.