SUMO Build Instructions

Overview

This document will walk through what I have found to be the best way to build SUMO as well as contributing to the project. In general, the workflow looks like:

  1. Fork SUMO
  2. Clone the SUMO fork to your local computer
  3. Create a branch for your development & switch to that branch
  4. Build SUMO in it's entirety once
  5. Development Loop
    • Make changes to SUMO's internals
    • Build (just sumo or sumo-gui)
    • Test
  6. Ready for contribution?
    • Follow the instructions for contributing
    • Create a pull request on Github

Detailed Instructions

Cloning the Repository

Cloning the repository should be the same on all platforms. If you haven't used Github since August of 2021, you may have to create a personal access token.