development.md

Development notes

Requirement

• Java7 (JDK)

Creating IntelliJ project files

./sbt gen-idea

Creating Eclipse project files

./sbt eclipse

Developing UTGB with GWT super-dev mode

• GWT Compile (required only first time) ./sbt gwt-compile

• Launch web container ./sbt "~;container:start; container:reload /"

• Launch GWT code server (super dev mode) ./sbt gwt-superdev

if you need to debug webUI remotely (e.g. using 192.168.xxx.xxx address), launch gwt-superdev with -Dgwt.expose option

./sbt gwt-superdev -Dgwt.expose 

• Visit http://localhost:9876/ and copy the bookmarklet ("Dev Mode On") appeared in the page to your bookmark bar.

• Open http://localhost:8080/gwt, then click "Dev Mode On".

If you need to use 192.xx.xx.xx address to access GWT pages, run gwt-superdev mode with -Dgwt.expose option

./sbt gwt-superdev -Dgwt.expose

You also need to copy bookmarklet from http://192.xx.xx.xx:9876 since it becomes different from when using http://localhost:9876

Install utgb command

$ make install

Run tests

$ ./sbt test -Dloglevel=debug

Run tests when updates of source codes are detected

$ ./sbt "~test" -Dloglevel=debug

Run specific tests matching a pattern

$ ./sbt "~test-only *HelloTest" -Dloglevel=debug

Run tagged test only

$ ./sbt "~test -- -n test1" -Dloglevel=debug