gdub A gradlew / gradle wrapper.开源项目

gdub(gwonthecommandline)isagradle/gradlewwrapper.NottobeconfusedwiththeGradleWrapper,gwinvokes./gradlewonprojectswhereoneisconfigured,andfallsbacktousethegradlefromthe$PATHifawrapperisnotavailable.Also,gwis66%shortertotypethangradleand78%shortertotypethan./gradlew.

Therearenowafewwaystoinstallgdub,withmoreontheway.Usewhicheverismostconvenientforyouorfeelfreetosuggestanother!

IfyouareonOSXandnotusinghomebrew,I'mnotquitesurewhattodowithyou.Installgdubwithhomebrewlikeso:

IfyouuseMacPorts,youcaninstallgdublikeso:

Ifyouusebpkg,youmayinstalllikeso:

YouwillprobablywanttoinstallGradlefirst.WhilethisisnottechnicallynecessaryifallyourprojectsareusingaGradleWrapper,itisagoodideatohavethelatestversionofgradleavailablesystem-widebecausesomehandyGradlefeaturesareavailableoutsidethecontextofanexistingproject.

Checkoutacopyofthegdubrepository.Then,eitheraddthegdubbindirectorytoyour$PATH,orruntheprovidedinstallcommandwiththelocationtotheprefixinwhichyouwanttoinstallgdub.Thedefaultprefixis/usr/local.

Forexample,toinstallgdubinto/usr/local/bin:

Note:youmayneedtorun./installwithsudoifyoudonothavepermissiontowritetotheinstallationprefix.

Formaximumfidelityaddagradlealiastogwtoyourshell'sconfigurationfile.

Examplebash:

Fromnowonyoucanjusttypegradle...fromwhereveryouareandgwtakescareoftherest.Happinessensues!

gdubisaconveniencefordevelopersrunninglocalGradlecommandsandaddressesafewminorshortcomingsofgradleandgradlew'scommandlinebehaviour.Theseareknownissues,andtheyaresettobeaddressedinfutureversionsofGradle.Ifyouareinterestedinthediscussionssurroundingthem,checkout:

HerearetheissuesIfeelaremostimportant,andtheonesgdubattemptstoaddress:

Ifyouareusingthegradlecommand,andyouarenotinthesamedirectoryasthebuild.gradlefileyouwanttorun,youhavetoprovidegradlethepath.Dependingonwhereyouhappentobe,thiscanbesomewhatcumbersome:

Withgw,thisbecomes:

Ifyouareusinggradlewandyouwanttorunyourbuild,youneedtodosomethingsimiliarandprovidetherelativepathtothegradlewscript:

Again,withgwthisbecomes:

Idon'tevenwanttotypeoutanexampleofthis,letalonedoitonaday-to-daybasis.Useyourimagination.

Evenwithtabcompletionandsittingattherootofyourproject,youhavetotypeatleast./gr<tab>.ItgetsabitworseifyouhappentohaveaGradle.propertiesfile,andwiththeGradlewrapper,youhaveagradledirectorytocontendwithaswell.Asimplealiaswouldsolvethisproblem,butyoustillhavetheother(moreannoying)issuestocontendwith.

ThiscanbeaproblemiftheprojectyouarebuildinghascustomizationstotheGradlewrapperorforsomereasonisonlycompatiblewithacertainversionofGradlethatisconfiguredinthewrapper.IfyouknowtheprojectusesGradle,youmaybetemptedtojustuseyourownsystem'sGradlebinary.Thismightbeok,oritmightcausethebuildtobreak,butifaprojecthasagradlew,itisaprettysafebetyoushoulduseit,andnotwhateverGradledistributionyouhappentohaveinstalledonyoursystem.

Anywhereyouhappentobeonyourproject,youcanruntheGradletasksofyourprojectbytypinggw<tasks>,regardlessofwhetheryouusetheGradleWrapperinyourprojectornot.

gwworksbylookingupwardsfromyourcurrentdirectoryandwillrunthenearestbuild.Gradlefilewiththenearestgradlew.Ifagradlewcannotbefound,itwillrunthenearestbuild.Gradlewithyoursystem'sGradle.ThisisprobablyalwayswhatyouwanttodoifyouarerunningGradlefromwithinaproject'streethatusestheGradlebuildsystem.