Setting up build tools

If you're interested in contributing to the development of GRIP, check out these instructions on getting the tools set up.

Pre-requisites

• The JDK 8 is needed to build this
  • If you have problems with the setup make sure you have the newest version of the JDK http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html
• Use of the IntelliJ IDEA IDE, although not required, is highly recomended as it has been used by all primary developers. We know the most about it so can support you the best if you have problems with setup.

Setting up the GRIP source with IntelliJ

1. Select either Import Project or New > Project From Existing Sources... and select the folder with the GRIP source.
2. Select Gradle as the external model to import the project.
3. Make sure the Gradle JVM is set to 1.8 and click finish.
4. When prompted to select the modules to include in the project, leave them all selected and click OK.
5. To setup running GRIP from IntelliJ, open Run > Edit Configurations...
6. Add a new Gradle configuration, and give it a name.
7. Click on the ellipsis to the right of the Gradle project: text field and select ui.
8. Type :ui:run into the Tasks: text box.
9. The run configuration should look like this.

You are done setting up the development environment and can start developing.

Checkstyle

We use a slightly modified version of the Google Styleguide. You can import the style guide into IntelliJ using a plugin like this one. You're code will not be merged if you do not follow the style guide as the build will not pass the the check phase of gradle.

Common Problems

Failed to launch JVM

Symptom

GRIP crashes on startup and logs:

Exception in Application start method
GRIP Error invoking method.
GRIP Failed to launch JVM

Solution

Build GRIP with a launcher compiled with -pthread. Either follow @PeterJohnson's instructions or use the precompiled launcher.

UnsatisfiedLinkError

The opencv library for linux requires gcc version 4.8 or higher in order for GOMP_4.0 to be present. Check the version of gcc you have installed using gcc -v and update if necessary.

Ubuntu: Network Tables throws a bunch of exceptions

This is caused because GLIBCXX_3.4.20 isn't found which causes a bunch of exceptions during dependency injection linking.

This is usually because you have an old version of GCC installed. Basically, follow this Ask Ubuntu post and it should solve your problems