X-Git-Url: http://source.jalview.org/gitweb/?a=blobdiff_plain;f=doc%2Fbuilding.md;h=bbcc0117cbee853c7de8c3d68b9a9711f1bc2d83;hb=96f727b57ac588f9307116b79a7f1ab67dbff39b;hp=8e21d5778379ac7aa8554cb364416b1ecc86eb05;hpb=68ecfc084e0dfee86981ef818ecc3184ccef614d;p=jalview.git diff --git a/doc/building.md b/doc/building.md index 8e21d57..bbcc011 100644 --- a/doc/building.md +++ b/doc/building.md @@ -6,7 +6,7 @@ # download git clone http://source.jalview.org/git/jalview.git # compile -cd jalview +cd ./jalview gradle shadowJar # run java -jar build/libs/jalview-all-*-j11.jar @@ -14,7 +14,7 @@ java -jar build/libs/jalview-all-*-j11.jar # and/or create launcher gradle getdown # use launcher -cd getdown/files +cd ./build/getdown/files/11 java -jar getdown-launcher.jar . jalview ``` @@ -23,10 +23,10 @@ java -jar getdown-launcher.jar . jalview > To get set up using _only_ the Eclipse IDE () then please see the section [Setting up in Eclipse IDE](#setting-up-in-eclipse-ide) -The method here is described in terms of using a command line. You can easily do this on linux or in a Terminal window in macOS. You can do it in Windows. +The method here is described assumes using a command line. You can easily do this on linux or in a Terminal window in macOS. You can do it in Windows. * Java 11 compliant JDK -* gradle 5.2 or above *(NB gradle 6.6 and above currently produces NullPointerExceptions during the build. This is non-fatal and does not affect the build. Use gradle 6.5.1 to avoid this)* +* gradle 7.6.3 or above, but not gradle 8 * git > The versions and installation methods here are just suggestions (which we have tested @@ -336,7 +336,7 @@ the `tests/` folder. A summary of results should appear in your console. You can run different defined groups of tests with ```bash -gradle test -PtestngGroups=Network +gradle test -Ptestng_groups=Network ``` Available groups include Functional (default), Network, External. @@ -348,9 +348,15 @@ Some of Jalview's Functional tests don't pass reliably in all environments. We t To exclude one or more groups of tests, add them as a comma separated list in testngExcludedGroups. ```bash -gradle test -PtestngExcludedGroups=Not-bamboo +gradle test -Ptestng_excluded_groups=Not-bamboo ``` +#### Viewing stdout and stderr for tests +By default, gradle doesn't report any of the output or error streams produced by tests. You can enable output by setting the following: + +```bash +gradle test -Ptest_output=1 +``` ### Installer packaging with *install4j*