Install ROS on macOS

Installation:

1. Disable SIP: You must disable system protection

2. Install xcode

Caution

You must have installed xcode (the entire editor not just command line tools). Make sure to open the installation.

3. Install brew

4. Run echo "source ~/.ros2rc" >> ~/.zshrc

5. Run curl -o ./bootstrap.sh -LO https://raw.githubusercontent.com/jbrhm/MACOS-HUMBLE/refs/heads/main/bootstrap.sh && chmod +x bootstrap.sh &&./bootstrap.sh

Caution

If you run into the issue fatal error: 'Availability.h' file not found run sudo xcode-select -s /Applications/Xcode.app/Contents/Developer to switch from command line xcode to developer xcode.

If you encounter an error with your qt version run brew uninstall --ignore-dependencies qt and open a new terminal and then type in the rest of the commands starting with colcon build ...

6. Run ./build.sh

7. Run ros2 launch mrover simulator.launch.py

Alternative VM Installation

If you’re having trouble with the regular installation above(installation failing, simulator crashing, etc), ask a lead if you should use a VM instead. If so follow the installation method here.