Development Tools

Tools and utilities for Stryke Force software developers.

Compiling

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:

1. Start the Vagrant VM with vagrant up.
2. Edit.
3. Log into the VM with vagrant ssh.
4. Compile.
5. Deploy the compiled executable to the robot for testing.
6. When finished, suspend the Vagrant VM with vagrant halt.

Resources

• WPILib C++ documentation
• navX MXP C++ Class Library for RoboRIO documentation