I will add my questions and lessons here in hopes that some answers will be easier to find when other documentation and instructions are updated.
Kolmafia is phasing out Ant and replacing it with Gradle.
To use Gradle your system will need a command line git client, an installed version of Java 9 or better and a git clone of the KoLmafia repository from GitHub.
gradle is usually invoked from a command line, followed by a list of parameters or targets. Windows users should invoke gradlew.bat and users of other systems should try gradlew. Things are simplest if these are invoked from the top level directory of the local repository. gradle should probably not be separately installed on a system if it is only needed for KoLmafia. There are some versioning incompatibilities and the wrappers will just use Java to run the right version.
The target, shadowjar will compile and build a KoLmafia jar from the local repository. At present (and unlike Ant daily) it does not pull the latest code from GitHub first. It will delete KoLmafia*.jar from the dist directory and create KoLmafia-abcde.jar where "abcde" is a revision number. If it is not a five digit number in the built jar name then there is probably a problem with something local, with Java being older than version 9 the prime suspect.
Targets to run tests, generate coverage metrics and update the local repository are under development (but not be me). There are likely to be targets that combine one or more of these tasks as well.
Kolmafia is phasing out Ant and replacing it with Gradle.
To use Gradle your system will need a command line git client, an installed version of Java 9 or better and a git clone of the KoLmafia repository from GitHub.
gradle is usually invoked from a command line, followed by a list of parameters or targets. Windows users should invoke gradlew.bat and users of other systems should try gradlew. Things are simplest if these are invoked from the top level directory of the local repository. gradle should probably not be separately installed on a system if it is only needed for KoLmafia. There are some versioning incompatibilities and the wrappers will just use Java to run the right version.
The target, shadowjar will compile and build a KoLmafia jar from the local repository. At present (and unlike Ant daily) it does not pull the latest code from GitHub first. It will delete KoLmafia*.jar from the dist directory and create KoLmafia-abcde.jar where "abcde" is a revision number. If it is not a five digit number in the built jar name then there is probably a problem with something local, with Java being older than version 9 the prime suspect.
Targets to run tests, generate coverage metrics and update the local repository are under development (but not be me). There are likely to be targets that combine one or more of these tasks as well.