Skip to content
b-ely edited this page Jan 9, 2019 · 3 revisions

Welcome to the 2019-Robot wiki!

Getting started:

You need to have some tools to make this all work: Git, Java, VSCode, Gradle

Git

All of the team computers have Git installed. If you are using your own, just download the appropriate version from https://git-scm.com/downloads.

Java

All of the team computers have Java, but may need to be updated to Java 11. Download (if you are on Windows: Java 11) or upgrade on Fedora:

sudo dnf install java-11-openjdk.x86_64

VSCode

Installing VSCode requires some setup: this is all pulled straight from the Microsoft site.

sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc

sudo sh -c 'echo -e "[code]\nname=Visual Studio Code\nbaseurl=https://packages.microsoft.com/yumrepos/vscode\nenabled=1\ngpgcheck=1\ngpgkey=https://packages.microsoft.com/keys/microsoft.asc" > /etc/yum.repos.d/vscode.repo'

dnf check-update

sudo dnf install code

Gradle

We will use the Gradle wrapper so you don't need to have the full version of Gradle.

Working with the code

Our repository is private and control is limited to the students on the team. In addition, we do not allow the students to have write permission to the repository. This means that you have to "fork" the repository and create pull-requests from your fork.

Forking the repo:

Go to the main page of the repository and click the Fork button in the upper right hand corner. This will copy the code to your own account.

Clone your repo

Go to your account (click on your icon in the upper right of the page) and then go to forked copy of the 2019-Robot. Click the green "Clone or download" button and Git URL (you can click the clipboard icon). Open a command prompt (on Windows, you need to use Git Bash, on Fedora, just use the Terminal). Change into the directory you want to use (like repos, but can be whatever you want - just remember it). Type git clone <url> where is the Git URL that you copied.

Keep your fork up to date

Change into the directory where the clone was pulled down to your computer. Then type the following:

git remote add upstream https://github.com/frc-4931/2019-Robot

git fetch upstream

Daily TODO

EVERYDAY you need to make sure that you keep your local version of the code up-to-date with all of the changes that your teammates have made. Change into the cloned directory and type:

git pull upstream master

UNIX cheats

  • mkdir <name of dir> - make a directory
  • cd <name of dir> - change to a directory
  • ./<command> - run a command in the current directory
  • CTRL + SHIFT + C - copy a value
  • CTRL + SHIFT + V - paste a value