mvnwrapperjar

The mvnwrapperjar is a Java agent used by the Maven Wrapper to provide a consistent Maven runtime for a project. It is distributed as a jar file and placed in the .mvn/wrapper directory of a repository, alongside the maven-wrapper.properties file. When a developer runs the wrapper script (mvnw or mvnw.cmd), the script downloads Maven if it is not already present, then launches Maven with the embedded wrapper jar so that the exact Maven distribution used during development is preserved on all developers’ machines and in continuous‑integration environments.

History of the Maven Wrapper dates back to 2014, when the community recognized that sharing a specific Maven version was difficult in projects that use a script to invoke Maven. The wrapper simplifies this by bundling a small bootstrap program that guarantees the same Maven binaries are used, thereby eliminating the “works‑on‑my‑machine” problem. The wrapper has been included as an optional “Extension” in Maven Core but is most frequently used as a standalone remote dependency.

Typical usage is executing: ./mvnw -version, which calls the wrapper script that, if necessary, pulls the correct Maven artifacts and then runs Maven in a JVM whose classpath includes the mvnwrapperjar. The jar contains code that loads the necessary Maven libraries and forwards the command‑line arguments to the real Maven executable.

Licensing is the Apache License 2.0, which allows free use, modification, and distribution. Alternatives to the wrapper include writing custom scripts or using build platforms that bake Maven into the environment, but the mvnwrapperjar remains the most widely accepted method for ensuring deterministic Maven builds across diverse development setups.