Releases: mathworks-ref-arch/matlab-openapi-generator
v3.0.3
v3.0.2
Version 3.0.0 - Adds a server stub generator
Version 3.0.0 (July 9th 2025)
-
Breaking Change: The MATLAB Client Generator previously named
MATLABwas renamed tomatlab-client(this brings the MATLAB Client generator better in line with other OpenAPI generator names, which by convention are in kebab-case, and makes a clearer distinction between the Client generator and the newly introduced Server generator which is namedmatlab-server). When generating clients usingopenapi.build.Clientinside MATLAB, no changes are required, the builder has been updated to reflect this change. However, if calling generator from the command line usingnpx @openapitools/openapi-generator-cli(or by invoking the generator throughjavadirectly) make sure to update the command line arguments, replace-g MATLAB(or--generator MATLAB) with-g matlab-client(or--generator matlab-client). -
Breaking Change: The name of the MATLAB Generator JAR-file was changed from
MATLABClientCodegen-openapi-generator-0.0.1.jartoMATLAB-openapi-generator-3.0.0.jarto better reflect the version of the generator and to reflect that it no longer supports generating clients only; it now also supports server stub generation. When generating clients usingopenapi.build.Clientinside MATLAB, no changes are required, the builder has been updated to reflect this change. However, if calling generator from the command line usingnpxmake sure to update the--custom-generatorcommand line arguments. -
Major New Feature: Added a MATLAB server generator
matlab-server. It generates skeleton code which is designed to be deployed to MATLAB Production Server or as Microservice and makes use of the Custom Routes and Payloads feature. -
Updated listed system requirements for the client generator to MATLAB R2021a or newer. Previous versions of the package accidentally incorrectly listed R2020b as minimum supported version. This is not necessarily a breaking change in this particular package update since older versions of the package were already not (fully) compatible with MATLAB R2020b. Note that the server generator supports release R2023b or newer as it depends on various newer MATLAB Production Server and MATLAB features.
-
When
JAVA_HOMEis setopenapi.build.Clientandopenapi.build.Servernow specifically usejavafrom the specifiedJAVA_HOME. I.e. ifJAVA_HOMEis set,fullfile(getenv("JAVA_HOME"),"bin","java")is called wheneverjavaneeds to run. IfJAVA_HOMEis unset, they simply continue to calljava(which requiresjavato be on thePATH). -
It is no longer necessary to run
setupto download the OpenAPI Generator CLI JAR-file (or to manually download it). The required JAR-file is now downloaded by Maven as part of the build process of the MATLAB Generator JAR-file.setupis still provided for backwards compatibility but may be removed in future versions of the package. -
The Maven Java build is no longer configured to specifically build the Java code as Java 11 binaries. Instead it simply allows the compiler to use its own default binary target. This for example enables support for Java 21 (which actually no longer supports producing Java 11 binaries). Note that the minimum supported Java version is still Java 11.
-
Updated default generator Java library to v7.13.0.
-
Publishing HTML rendered version of the package documentation to GitHub pages.