-
Notifications
You must be signed in to change notification settings - Fork 0
Programming Environment Set Up
Joseph Jackson
- Create a personal GitHub account
- [OPTIONAL] Install the Mac or Windows GitHub client application:
- 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
-
Install extra GitHub support in Eclipse
-
Help > Install New Software…
-
In the "Work with:" pop-up, select "Luna - http://download.eclipse.org/releases/luna"
-
In the filter text box, enter "github" and press return
-
That should reveal a single package. Check the box in front of:
Eclipse GitHub integration with task focused interface -
Press Next a few times and then Finish to complete the installation
-
When prompted, restart Eclipse to enable the new software
-
Set up Eclipse Perspectives
-
In the upper right corner of Eclipse, find the buttons for the configured perspectives
-
If you see "C/C++", right-click and Close the perspective
-
Under the Window menu, choose Open Perspective, then Other...
-
Choose Java
-
Repeat the steps to open the Git perspective
-
You should see the Java and Git buttons in the upper right corner now
-
Import the existing team projects from GitHub
-
Start Eclipse if it's not already running
-
From the File menu, choose Import...
-
Open up the Git item using the disclosure triangle
-
Select Projects from Git
-
Select GitHub as the source
-
Click Next >
-
Enter "2015season" into the search field and click Search
-
Select this item from the list: GirlsOfSteelRobotics/2015season
-
Click Next >
-
Make sure the Master branch is checked
-
Click Next >
-
Leave the default settings
-
Click Next >
-
The "Working Directory" should be selected, showing "git/2015season" under your home directory
-
Click Next >
-
A list of projects appears. Make sure they're all selected.
-
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.
- 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.
-
Create a temporary FRC Java project
- From the File menu, choose New...
- In the submenu, choose Project (NOT Java Project!)
- Open WPILib Robot Java Development
- Select Example Robot Java Project
- Click Next >
- The Select Example Project to Create wizard opens
- Choose GearsBot, click Next >
- Enter the Project Name "temp"
- Click Finish
- All (or at least most) of the errors should disappear after a minute
-
Now delete the "temp" project:
- Right-click on "temp"
- Select Delete from the pop-up menu
- IMPORTANT: enable the "Delete project contents on disk" option to clean up the unneeded files
- Click OK
-
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/