Apache
/
maven
mirror of https://github.com/apache/maven.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

added user doc for no jar approach

This commit is contained in:
Manfred Moser 2018-02-19 19:52:13 -08:00 committed by rfscholte
parent ed6d2b40e9
commit fafe416ac4
1 changed files with 17 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

18
maven-wrapper/README.md
View File

@ -67,6 +67,22 @@ is activated by setting the MVNW_VERBOSE environment variable to `true`.
By default it is off.
## Usage without Binary JAR
By default, the Maven Wrapper JAR archive is added to the using project as small
binary file `.mvn/wrapper/maven-wrapper.jar`. It is used to bootstrap the download and
invocation of Maven from the wrapper shell scripts.
If your project is not allowed to contain binary files like this, you can
configure your version control system to exclude checkin/commit of the wrapper
jar.
If the JAR is not found to be available by the scripts they will attempt to
download the file from the URL specified in
`.mvn/wrapper/maven-wrapper.properties` under `wrapperUrl` and put it in place. The
download is attempted via curl, wget and, as last resort, by compiling the
`./mvn/wrapper/MavenWrapperDownloader.java` file and executing the resulting class.
## Using a Different Version of Maven
To switch the version of Maven used to build a project you can initialize it using
@ -79,7 +95,7 @@ which works for any version except snapshots. Once you have a wrapper you can ch
`distributionUrl` in `.mvn/wrapper/maven-wrapper.properties`, e.g.
```
distributionUrl=https://repo1.maven.org/maven2/org/apache/maven/apache-maven/3.2.1/apache-maven-3.2.1-bin.zip
distributionUrl=https://repo.maven.apache.org/maven2/org/apache/maven/apache-maven/3.2.1/apache-maven-3.2.1-bin.zip
```
[1]: https://github.com/takari/takari-maven-plugin