Tools and utilities for Stryke Force software developers.
You will need Vagrant installed. Vagrant is used to build as it will provision a virtual machine (VM) with the correct tools and dependencies.
Note: installation requires a Gitlab deployment secret to be in the .vault_pw
file at the top of the repo. Contact a team member to obtain it.
With Vagrant, the tools
repository (this directory) will be shared in the VM as /vagrant
. Edit files as normal on your host machine and changes are visible in the build VM.
To set up the build environment:
$ # ensure vagrant is installed per above
$ cd tools
$ vagrant up
$ # virtual machine image downloaded, booted and provisioned
$ vagrant ssh
$ # now logged into virtual build environment
$ cd /vagrant
We use CMake to build this project:
$ # ssh'd into virtual build environment and in /vagrant directory
$ mkdir build
$ cd build
$ # set up build
$ cmake ..
$ # run make to compile
$ make
$ # from now on, just run make to rebuild
A normal programming session looks like:
- Start the Vagrant VM with
vagrant up
. - Edit.
- Log into the VM with
vagrant ssh
. - Compile.
- Deploy the compiled executable to the robot for testing.
- When finished, suspend the Vagrant VM with
vagrant halt
.
- WPILib C++ documentation
- navX MXP C++ Class Library for RoboRIO documentation