Local Setup Process for FRC Programmers

Joseph Jackson

1. Create a personal GitHub account

• http://github.com/

1. [OPTIONAL] Install the Mac or Windows GitHub client application:

• http://mac.github.com/
• http://windows.github.com/

1. Install Eclipse according to FRC directions

• Follow these directions for installing Java, Eclipse, and the FRC plug-ins:
  https://wpilib.screenstepslive.com/s/4485/m/13809/l/145002-installing-eclipse-c-java

1. Install extra GitHub support in Eclipse

2. Help > Install New Software…

3. In the "Work with:" pop-up, select "Luna - http://download.eclipse.org/releases/luna"

4. In the filter text box, enter "github" and press return

5. That should reveal a single package. Check the box in front of:
   Eclipse GitHub integration with task focused interface

6. Press Next a few times and then Finish to complete the installation

7. When prompted, restart Eclipse to enable the new software

8. Set up Eclipse Perspectives

9. In the upper right corner of Eclipse, find the buttons for the configured perspectives

10. If you see "C/C++", right-click and Close the perspective

11. Under the Window menu, choose Open Perspective, then Other...

12. Choose Java

13. Repeat the steps to open the Git perspective

14. You should see the Java and Git buttons in the upper right corner now

15. Import the existing team projects from GitHub

16. Start Eclipse if it's not already running

17. From the File menu, choose Import...

18. Open up the Git item using the disclosure triangle

19. Select Projects from Git

20. Select GitHub as the source

21. Click Next >

22. Enter "2015season" into the search field and click Search

23. Select this item from the list: GirlsOfSteelRobotics/2015season

24. Click Next >

25. Make sure the Master branch is checked

26. Click Next >

27. Leave the default settings

28. Click Next >

29. The "Working Directory" should be selected, showing "git/2015season" under your home directory

30. Click Next >

31. A list of projects appears. Make sure they're all selected.

32. Click Finish

The above process created a "git" folder in your home directory, with a "2015season" folder under it. Each of the projects that were imported exist as a folder under the "2015season" folder.

1. Fix build path errors

The project imported in the step above all show build errors. To fix this issue, create a temporary project based on the WPIlib templates. The process of creating a new project will define a set of build variables needed by all robot projects. Once created, the temporary project can be removed.

1. Create a temporary FRC Java project

   1. From the File menu, choose New...
   2. In the submenu, choose Project (NOT Java Project!)
   3. Open WPILib Robot Java Development
   4. Select Example Robot Java Project
   5. Click Next >
   6. The Select Example Project to Create wizard opens
   7. Choose GearsBot, click Next >
   8. Enter the Project Name "temp"
   9. Click Finish
   10. All (or at least most) of the errors should disappear after a minute

2. Now delete the "temp" project:

   1. Right-click on "temp"
   2. Select Delete from the pop-up menu
   3. IMPORTANT: enable the "Delete project contents on disk" option to clean up the unneeded files
   4. Click OK

3. Add a bookmark for the Javadocs

   The WPI library (WPIlib) comes with documentation for every class and method. The details can be a little thin in some places, but it's generally a great thing to have available. The Eclipse environment is already set up to enable access to the Javadocs for the library. (The older Netbeans environment required manual steps.)

   To access the documentation, hover over a class or method name and the details will appear in a yellow box. Move toward the bottom and click on the "@" icon to show the documentation in a Javadoc tab in the bottom pane of Eclipse.

   The Javadocs are also published by WPI at the following URL for access via a web browser. I'd recommend adding it as a bookmark now so you have it handy:
   http://first.wpi.edu/FRC/roborio/release/docs/java/