Setting up 2019 RoboRio tools - quasics/quasics-frc-sw-2015 GitHub Wiki

There's a series of things that need to be done in order to be able to get, modify, build, and deploy the code for the team's robot:

• Get an account set up on GitHub (this site).
• Install Visual Studio Code and the FRC development tools that are used to edit/build/deploy code for the robot.
• Install Subversion tools, which are used to access the team's source code repository.
• Install the Visual Studio Code extensions to allow Subversion to be used within the GUI.
• Check out an initial copy of the code for the project.
• Open up the project in Visual Studio Code.
• Build the code for the robot (e.g., after making changes).
• Deploy the code to the robot.

Some of these you should only need to do once (e.g., getting an account set up); others need to be done once per computer that you're going to use (e.g., installing various programs).

Instructions are here.

Note: This doesn't actually need to be finished until you're ready to make changes to the code, but it can take time (and people sometimes run into problems), so it's worth starting early. You can continue on with the rest of what's outlined below while you're waiting to get an "invitation to collaborate" with the team on GitHub.

Follow the instructions from FIRST here to install the development tools.

There's a couple of different options here, depending on the operating system you're using.

• If you're working on Microsoft Windows, the easiest tool set to use is probably TortoiseSVN; see directions here.
• If you're working on a Mac or Linux machine, it may be simplest to install the command-line tools for these environments. (They're also available for Windows.) You can largely use them from within the Visual Studio Code via some extensions (covered below).
  • Mac tools installs are covered in a lot of places, including here. If you need help with the part that talks about "edit[ing] your .profile", please talk to Mr. Healy.
  • Linux tools installs are covered in a lot of places, including here. (We assume that if you're using Linux, you'll know the basics of using a terminal window; if not, please talk to Mr. Healy.)

Instructions are here.

• Using TortoiseSVN on Windows
• TBD: Using command-line tools on Mac/Linux

1. Start Visual Studio Code (VSC).
   • If you're on Windows, the installer will typically have put a shortcut to this on your desktop, and you can just double-click that.
2. Select "Open Folder..." from the "File" menu, browse into the project folder that you checked out and want to work in (e.g., the "Quasics2019Code/HedyLamarr" folder), and click on the "Select Folder" button.
   • VSC will update the UI to show the folder's contents, and will building its idea of how everything works. Be patient, as this can take a little while.
   • Among other things, a panel will open up, showing that it's "Executing task: gradlew generateVsCodeConfig" and other stuff (such as "Starting Daemon").
   • Keep being patient.
3. A number of warnings and other indications may pop up periodically, such as "Intellisense configurations might have been updated. Refresh them now?" Feel free to say "Yes" when these appear. (You may then be prompted to restart something: feel free to say "Yes" to this, too.)
   • Eventually, you should see a "BUILD SUCCESSFUL" message in green letters. This isn't actually telling you that it's built the code to be deployed on the robot, it's just finished building the configuration files that VSC uses to do that. But it's a good sign.
   • If you see an error message that you don't understand, come find Mr. Healy or a more experienced coder, and they'll help you out.

1. Start Visual Studio Code (VSC) and open the desired project for the robot.
2. Open the "command window" by either hitting <Ctrl+Shift+P>, or by clicking on the WPILib icon (looks like a "W" in a red hexagon) on the top of the window.
3. Pick the "WPILib: Build Robot Code" command to compile the robot code.
   • Be patient while the code builds.
   • When the build finishes, you should see a "BUILD SUCCESSFUL" message in green letters.

Instructions are here