Installing C++ and Java Development Tools for FRC

Windows

Offline Installer

Note:

Windows 7: You must install the NI Update or .NET Version 4.62 (or later) before proceeding with the install of VSCode for FRC. The NI Update installer will automatically install the proper version of .NET. The stand alone .NET installer is here: https://support.microsoft.com/en-us/help/3151800/the-net-framework-4-6-2-offline-installer-for-windows

Download the appropriate offline installer for your Windows installation (32 bit or 64 bit). If you're not sure, open the Control Panel -> System to check.

For Beta, these installers are found in the File Releases section of the Teamforge Beta project.

Double click on the installer to run it. If you see any Security warnings, click Run (Windows 7) or More Info->Run Anyway (Windows 8+).

Installation Type

Choose whether to install for All Users on the machine or the Current User. The All Users option requires Admin privileges, but installs in a way that is accessible to all user accounts, the Current User install is only accessible from the account it is installed from.

If you select All Users, you will need to accept the security prompt that appears.

Download VSCode

For licensing reasons, the installer cannot contain the VSCode installer bundled in. Click Select/Download VSCode to either Download the VSCode installer or select a pre-downloaded copy. If you intend to install on other machines without internet connections, after the download completes, you can click Open Downloaded File to be taken to the zip file on the file system to copy along with the Offline Installer.

Execute Install

Make sure all checkboxes are checked (unless you have already installed 2019 WPILib software on this machine and the software unchecked them automatically), then click Execute Install.

What's Installed?

The Offline Installer installs the following components:

  • Visual Studio Code - The supported IDE for 2019 robot code development. The offline installer sets up a separate copy of VSCode for WPILib development, even if you already have VSCode on your machine. This is done because some of the settings that make the WPILib setup work may break existing workflows if you use VSCode for other projects.
  • C++ Compiler - The toolchains for building C++ code for the roboRIO
  • Gradle - The specific version of Gradle used for building/deploying C++ or Java robot code
  • Java JDK/JRE - A specific version of the Java JDK/JRE that is used to build Java robot code and to run any of the Java based Tools (Dashboards, etc.). This exists side by side with any existing JDK installs and does not overwrite the JAVA_HOME variable
  • WPILib Tools - SmartDashboard, Shuffleboard, Robot Builder, Outline Viewer, Pathweaver
  • WPILib Dependencies - OpenCV, etc.
  • VSCode Extensions - WPILib extensions for robot code development in VSCode

What's Installed - Continued

The Offline Installer also installs a Desktop Shortcut to the WPILib copy of VSCode and sets up a command shortcut so this copy of VSCode can be opened from the command line using the command "frccode2019"

Both of these reference the specific year as the WPIlib C++\Java tools will now support side-by-side installs of multiple environments from different seasons.

Finished!

When the installer completes, you will now be able to open and use the WPILib version of VSCode. If you are using any 3rd party libraries, you will still need to install those separately before using them in robot code.

Mac OS

The beta tools (except the Driver Station and the roboRIO Imaging Tool) will run natively on a Mac.

Note: if you have the alpha release of VSCode for FRC installed, you should uninstall it before proceeding or create a new VSCode install. Failing to do this will have both versions installed at the same time causing things to not operate properly.

To install it follow these steps.

Download and move the directory

Download the software release by opening the File Releases tab of the FRC2019 Project in your browser. Then select the WPILib package as shown.

Then select the latest WPILib Beta and download the file WPILib_Full-Mac_2019.1.1-beta-1.tar.gz (the version number of this file may be different as newer updates are released). Uncompress the file by opening the downloads folder in Finder and double-clicking on the downloaded file .gz file (the gz file may have already been uncompressed depending on your settings). Then double-click on the .tar file so that the uncompressed folder is showing in Finder.

Using Finder (or command line) copy the contents of the folder to a new folder in your home directory, ~/frc2019 as shown below.

Known Issue: The ToolsUpdater.sh script referenced in the next step does not currently work correctly on Mac (as of Beta 2), Skip that step and proceed to "Setting up VSCode..."

Run the ToolsUpdater.sh script

Open a terminal window and change directory to ~/frc2019/tools and run the script, ToolsUpdater.sh.

Setting up VSCode to use Java 11

Java 11 is required to be installed on systems that use VSCode or the 2019 tools. In VSCode it is required to set the "java.home" preference for the user or workspace to be the directory of the Java 11 home. To do that open the settings by selecting Settings from the Preference menu.

Search for the java home settings by entering "java home" into the search window. Then select "Edit in settings.json" to make changes to the java home setting.

In the settings file you must edit the java.home variable in the right hand pane as shown in the screen capture below. On the default install of Java 11 on Mojave, the line is shown in the following picture. The text is:

"java.home": "/Library/Java/JavaVirtualMachines/jdk-11.0.1.jdk/Contents/Home"

0 Report Errors

Use this form to report any errors with the documentation. For help with WPILib, please use the FIRST Forums at http://forums.usfirst.org For reporting WPILib bugs, please submit an issue on GitHub at https://github.com/wpilibsuite/allwpilib/issues/new

Ignore