BeeWM uses gradle to compile and test. It is recommended to use Oracle JDK 7 with BeeWM. To set up JDK 7, assign the JAVA_HOME variable, for example:
To compile from the command line, use:
# clean the last build for a full rebuild: ./gradlew clean # sparse compile excluding all tests: ./gradlew build -x test -x storageIntegrationTest -x clusterIntegrationTest # compile excluding the integration tests (that require a cluster queue setup): ./gradlew build -x storageIntegrationTest -x clusterIntegrationTest # full compile with tests: ./gradlew build
To compile a release, tag the GIT repository for the release (for example 0.3.2):
# find the last commit of the 0.3.2 series, to set the tag there: git log|less # tag the commit with its checksum (or part of it): git tag 0.3.2 4a391b3236770dd70390029af4846d18a4554444
To check out a specific release to compile, check out the tag of the GIT repository:
# list available tags: git tag # check out a specific tag, for example 0.3.2 git checkout tags/0.3.2
# full recompiled release with testing ./gradlew clean build distTar # releases after 0.4.0: full recompiled release without integration testing ./gradlew clean build distTar -x storageIntegrationTest -x clusterIntegrationTest # releases before 0.4.0: full recompiled release without integration testing ./gradlew clean build distTar -x integrationTest # find the release files for BeeWM and the BeeWM Webclient in the directories: ls -la bee-*/build/distributions/* # store the archive on the server for downloading: cp -iv bee-*/build/distributions/*0.4.0-SNAPSHOT-61*tar.gz \ /home/www/de.biodataanalysis/pages/data/beewm/releases/ && \ sudo chmod 660 /home/www/de.biodataanalysis/pages/data/beewm/releases/*tar.gz && \ sudo chown www-mario:www-mario /home/www/de.biodataanalysis/pages/data/beewm/releases/*tar.gz
After a version is finished and released, enter the release date in Jira, and tag the GIT repository for the next release series. Assuming the current release was 0.3.2, tag for the next release 0.4.0:
# find the first commit of the 0.4.0 series, to set the tag there: git log|less # tag the commit with its checksum (or part of it): git tag 0.4.0-SNAPSHOT 70004f4e725840d7835f0ebe3a835e22e8d4e8ac # push the new tags to the server: git push origin --tags
To set up a the development environment to develop bee first download the enterprise java version of the Eclipse IDE. After installing Eclipse one should install the Gradle IDE plugin for Eclipse.
NOTE: When this guide was written Gradle IDE was not working with the latest Gradle version which is used by default. To be able to use it one should download Gradle 1.12 from gradle.org install it and and change the preferences of Gradle IDE to use this version.
After installing Gradle IDE the source can be imported via the import as Gradle Project. The root folder in the import wizard should be set to the root directory of the repository then Build Model should be executed. After building the model the subproject can be selected an imported.