Do czego służą pliki mvnw i mvnw.cmd?

257

Kiedy utworzyłem aplikację Spring Boot, mogłem zobaczyć mvnwi mvnw.cmdpliki w katalogu głównym projektu. Jaki jest cel tych dwóch plików?

maven spring-boot

— shaunthomas999
źródło

345

Te pliki pochodzą z opakowania Maven . Działa podobnie do owijarki Gradle .

Umożliwia to uruchomienie projektu Maven bez konieczności instalacji i obecności Maven na ścieżce. Pobiera poprawną wersję Maven, jeśli nie została znaleziona (o ile domyślnie wiem w katalogu osobistym użytkownika).

mvnwPlik jest dla Linux (bash) i mvnw.cmdjest dla środowiska Windows.

Aby utworzyć lub zaktualizować wszystkie niezbędne pliki Maven Wrapper, wykonaj następujące polecenie:

mvn -N io.takari:maven:wrapper

Aby użyć innej wersji maven, możesz określić wersję w następujący sposób:

mvn -N io.takari:maven:wrapper -Dmaven=3.3.3

Oba polecenia wymagają włączenia maven PATH(dodaj ścieżkę do maven bindo PathZmiennych systemowych), jeśli masz już mvnw w swoim projekcie, którego możesz użyć ./mvnwzamiast mvnpoleceń.

— Unik
źródło

Twoja odpowiedź jest bardzo pomocna. Sprawdzam dokumentację opakowania maven. I był przy użyciu mvnpolecenia dla Maven operacji chociaż mogę użyć ./mvnwdo tego samego celu.

— shaunthomas999

2

Dziękuję za odpowiedź. Czy potrafisz wyjaśnić, kiedy to zostanie wygenerowane, tak jak to jest podczas początkowego tworzenia projektu? Czy będzie aktualizowany wzdłuż linii, gdy wprowadzasz zmiany w pom, takie jak dodawanie zależności zależnych / wtyczek?

— Asanke

1

i czy należy dodać / zatwierdzić pliki mvnw.cmd?

— jpganz18

tak oczywiście. pozwala na szybkie uruchomienie kompilacji maven bez potrzeby dodatkowej instalacji maven lub posiadania go na PATH.

— Dodge

1

Bardzo dziękuję za odpowiedź, jest bardzo pomocna. Czy możesz nam powiedzieć coś na temat przenośności plików ustawień maven, gdy pracujemy w ten sposób? Saludos i jeszcze raz dziękuję.

— Daniel Hernández

26

Polecenie mvnwużywa Maven, który jest domyślnie pobierany ~/.m2/wrapperprzy pierwszym użyciu.

Adres URL z Maven jest określony w każdym projekcie na .mvn/wrapper/maven-wrapper.properties:

distributionUrl=https://repo1.maven.org/maven2/org/apache/maven/apache-maven/3.3.9/apache-maven-3.3.9-bin.zip

Aby zaktualizować lub zmienić wersję Maven, wywołaj następujące (pamiętaj o --non-recursiveprojektach wielomodułowych):

./mvnw io.takari:maven:wrapper -Dmaven=3.3.9

lub po prostu zmodyfikuj .mvn/wrapper/maven-wrapper.propertiesręcznie.

Aby wygenerować opakowanie od zera za pomocą Maven (musisz mieć to już PATHuruchomione:

mvn io.takari:maven:wrapper -Dmaven=3.3.9

— Michał Kordas
źródło

5

Maven Wrapper jest doskonałym wyborem dla projektów, które wymagają specyficznej wersji Maven (lub dla użytkowników, którzy nie chcą się zainstalować Maven w ogóle). Zamiast instalować wiele jego wersji w systemie operacyjnym, możemy po prostu użyć skryptu opakowania specyficznego dla projektu.

mvnw: jest wykonywalnym skryptem powłoki Uniksa używanym zamiast w pełni zainstalowanego Maven

mvnw.cmd : dotyczy środowiska Windows

Przypadków użycia

Opakowanie powinno współpracować z różnymi systemami operacyjnymi, takimi jak:

Linux
OSX
Windows
Solaris

Następnie możemy uruchomić nasze cele w następujący sposób dla systemu Unix:

./mvnw clean install

Oraz następujące polecenie dla partii:

./mvnw.cmd clean install

Jeśli nie mamy określonego Maven we właściwościach opakowania, zostanie on pobrany i zainstalowany w folderze $USER_HOME/.m2/wrapper/distssystemu.

Wtyczka Maven Wrapper

Wtyczka Maven Wrapper do automatycznej instalacji w prostym projekcie Spring Boot.

Najpierw musimy przejść do głównego folderu projektu i uruchomić następującą komendę:

mvn -N io.takari:maven:wrapper

Możemy również określić wersję Maven:

mvn -N io.takari:maven:wrapper -Dmaven=3.5.2

Opcja -N oznacza –nierekurencyjny, dzięki czemu opakowanie zostanie zastosowane tylko do głównego projektu bieżącego katalogu, a nie do żadnych podmodułów.

— Patel Romil
źródło

2

Zdecydowanie najlepszą opcją byłoby użycie kontenera maven jako narzędzia do budowania. Wystarczy mvn.shtaki skrypt:

#!/bin/bash
docker run --rm -ti \
 -v $(pwd):/opt/app \
 -w /opt/app \
 -e TERM=xterm \
 -v $HOME/.m2:/root/.m2 \
 maven mvn "$@"

— André
źródło

7

To nie odpowiada na pytanie PO, po prostu sugeruje alternatywę

— ahmedjaad

2

Podstawową ideą otoki maven jest zadeklarowanie poprawnej wersji maven dla tego projektu. Dodatkową zaletą jest uniknięcie konieczności ręcznego instalowania maven. Twoje podejście nie tylko nie rozwiązuje problemu z wersją, ale wymaga jeszcze jednego narzędzia zainstalowanego lokalnie.

— Maks.

2

Należy również pamiętać, że to instaluje własne lokalne repozytorium Maven w instancji dokera. Zwykle działa to jako root, więc wszystko, co napisane przez zadokowaną instancję maven, jest własnością root w Linuksie. To niekoniecznie jest pożądane. Zauważyłem, że poprawnie skonfigurowana instancja nexusa dostępna dla instancji kompilacji dokera była mniej bolesna, szczególnie jeśli chcesz odtwarzalnych kompilacji.

— Thorbjørn Ravn Andersen

To było dawno temu, ale nadal wolę tę drogę. O wersji maven zapewniają ją tagi graficzne (wystarczy spojrzeć na stronę maven w Docker Hub). Jeśli chodzi o własność roota, po prostu nie dzieje się to na pulpicie dokera - ale faktycznie dzieje się to w pudełkach z linuksem (i oczywiście budowanie węzłów). Mała sztuczka może w tym przypadku „wymusić” bieżący UID (argument -u), więc problem zostanie rozwiązany. Ale wszystko oznacza, że uważam to podejście o rząd wielkości za lepsze. Docker i tak jest wszechobecny, szczególnie w węzłach kompilacji.

— André

1

(kontynuacja) Old-schoolowa konfiguracja Jenkins i sposób myślenia prowadzą do tego rodzaju rzeczy. Nowoczesne narzędzia CI / CD działają odwrotnie: wystarczy wybrać kontener kompilacji. Ale to tylko moja opinia.

— André