wiki:FRCSoftwareSetup

Version 5 (modified by awollack, 10 years ago) (diff)

--

Setting Up Your Computer for FRC Java Programming

1. Install Java SE 8

Make sure the correct version of Java SE 8 is installed. You will need the JDK (Java Software Development Kit); the current version is jdk1.8.0_25.

The installation can be found at ​Oracle's site. Make sure to accept the license agreement, or it won't let you download.

2. Install Eclipse Luna

For best performance and to avoid compatibility errors, download the latest version of Eclipse for Java Developers, currently ​Eclipse Luna.

Troubleshooting

I downloaded a zip file, but no installer. How do I get Eclipse?

Eclipse is actually a Java program, not an executable. To use, simply find the program file inside the folder hierarchy and open. As long as Java has been installed correctly, the application will start up successfully.

For ease of operation, it is usually beneficial to move the folder containing the Eclipse program files to a more appropriate place and/or create a shortcut to the program.

"No compiler/jdk found" - JAVA_HOME not set correctly

This error usually occurs when the Eclipse reference to the JDK is not set to the right location on the local computer.

To fix this, go to Window (Eclipse on Macs), Preferences, Java, and under the Java hierarchy, select Installed JREs and in the menu, make sure there is a valid link to a JDK on the local computer.

See ​here for more detailed instructions not covered here.

3. Install the Java FRC Plugins

These plugins will allow you to be able to program the roboRIO.

  1. In Eclipse, select the Help menu in the top menu bar.
  2. Select Install new software....
  3. In the site field, enter in 
    http://first.wpi.edu/FRC/roborio/release/eclipse/
  4. In the menu below, check the box Show only software applicable to target environment.
  5. Then select only the Java Plugins and click Next.
  6. Accept all license agreements when they come up.
  7. Click Install.
  8. After installing, restart Eclipse. The plugins will continue to install when Eclipse starts back up. This is normal operation.

4. Install Subversive for Eclipse

The programming teams for our team use subversion (SVN) for configuration management of code.

  1. In Eclipse, select the Help menu in the top menu bar.
  2. Select Eclipse Marketplace....
  3. Search for "Subversive" without the quotes.
  4. Select Subversive.
  5. When prompted for SVN connectors, select the 1.8 version. Accept any and all license agreements which appear.
  6. When a dialog comes up saying some features aren't available, click ok and continue.
  7. Continue to the end of the wizard and restart eclipse.

5. Creating a FRC Java Project

  1. In Eclipse, right-click in the open space in the Package Explorer and select New >, and then inside the sub-menu that pops up, select Project.... Selecting Java Project... will not work.
  2. Under WPILib Robot Java Development, select Robot Java Project.
  3. After clicking next, if creating a FRC Java Project for the first time, there will be a prompt for team number. Enter 
    2537
  4. In the next screen, specify a unique, identifiable project name, preferably one that will not be confused with other, similar projects. Enter in a new, custom package hierarchy or leave the default.
  5. Choose a project template:
    1. Iterative - cyclic program execution; this template is the most basic and requires the programmer to implement much more
    2. Command-Based - event-driven program execution; includes many features FIRST & WPI have developed
    3. Simple - DO NOT USE
  6. Click Finish.

6. Accessing the Subversion Server for the First Time

  1. To open the SVN perspective, select Window, Open perspective >, Other.... Then, select SVN Repository Exploring.
  2. In the perspective, right-click the open space in the SVN Repositories. Select New >, then Repository Location.
  3. In the window that pops up, enter one of the following in the URL field:

Test Repository(including last years code) 

svn+ssh://jupiter2.raidtech.net/home/svn/test

Sensors Repository 

svn+ssh://jupiter2.raidtech.net/home/svn/sensors

Website Repository 

svn+ssh://jupiter2.raidtech.net/home/svn/web

Core Software Repository 

svn+ssh://jupiter2.raidtech.net/home/svn/FIRST

Game App Repository 

svn+ssh://jupiter2.raidtech.net/home/svn/gameapp
  1. Authenticate using your username and password. Default password for most users is '1234' without the quotes.
  2. Click finish.

For more information on how to use SVN and subversive, see the Configuration Management page.