Software Install
- Windows
- macOS
- Linux
Downloads
WPILib
Click to download the 2020 version of WPILib for Windows 64-bit
VS Code
Click to download the VS Code version for 2020 WPILib
Installation
Locate and run the file named WPILibInstaller_Windows-2020.3.2.exe.
Installing for All Users will require admin privileges and install for all users on the machine.
Software will be installed to C:\Users\Public\wpilib\2020.
Installing VS Code
Due to licensing reasons with VS Code the installer does not contain VS Code bundled in. To overcome this hit the Select/Download VS Code button.
This will open up the selector tool.
Select the Select Existing Download option and then select the file OfflineVsCodeFiles-1.41.1.zip. This will change back to the installer window and Execute Install can be pressed to start the install.
The installer creates a separate version of VS Code for robotics development, even if VS Code is already installed locally. This is done to prevent workflows from breaking.
Downloads
WPILib
Click to download the 2020 version of WPILib for macOS
VS Code
Click to download the VS Code version for 2020 WPILib
Installation
This section and macOS examples was completed and tested using macOS High Sierra
After installing you may be required to allow a bunch of processes to work through gatekeeper.
The macOS install requires multiple steps to be completed.
VS Code Install
VS Code needs to be installed before the extensions are installed. The preferred version of VS Code is 1.41.1 which can be found in the downloads above. The file is called VSCode-darwin-stable.zip. Double click on the zip folder if it’s not extracted already and drag the Visual Studio Code into the Applications folder.
After dragging to the Applications folder the VS Code icon will be visible in Applications.
WPILib Install
The WPILib file WPILib_Mac-2020.3.2.tar.gz can be found in the downloads above.
Double click on the WPILib_Mac-2020.3.2.tar.gz to remove the .gz extension. Double click again on the WPILib_Mac-2020.3.2.tar to remove the .tar extension. Drag the WPILib_Mac-2020.3.2 folder into Downloads.
Open the terminal and run these commands:
mkdir wpilib/2020
cp -R ~/Downloads/WPILib_Mac-2020.3.2/ ~/wpilib/2020
This will create the appropriate directories for WPILib and move the contents of WPILib_Mac-2020.3.2 to the ~/wpilib/2020 folder. When done the folder structure should look like this.
The tools need to be updated so they can be used. Run the commands below to do so.
cd ~/wpilib/2020/tools
python ToolsUpdater.py
An example of using the terminal is shown below.
Installing Extensions
For VS Code to work properly the WPILib extensions need to be installed. Open VS Code and use the shortcut Cmd-Shift-P to open the command pallet. Type in the command Extensions: Install from VSIX.
Navigate to the ~/wpilib/2020/vsCodeExtensions folder, select Cpp.vsix and hit install.
Repeat this step for all the vsix files located in ~/wpilib/2020/vsCodeExtensions.
The extensions must be installed in this order:
- Cpp.vsix
- JavaLang.vsix
- JavaDeps.vsix
- JavaDebug.vsix
- WPILib.vsix
On the bottom right of the VS Code window popups will show saying if the installation is complete. Wait until there is a completed popup before preceding with the next extension. Also when installing the JavaLang.vsix there may be an error shown. This should be ignored for now
Getting VS Code to use Java 11
VS Code needs to be pointed to where the WPILib Java Home is. This is simply done by running the following command WPILib: Set VS Code Java Home to FRC Home.
Placeholder