Installing on macOS
There are currently two ways to install PROS 3 on macOS. The recommended method uses Homebrew, and the other method involves installing components manually.
Recommended Method (Homebrew)
The recommended method of installing PROS 3 for macOS involves using Homebrew.
- If you do not already have Homebrew installed, install it by following the instructions on their site. This will take a while, and may prompt you to follow some additional instructions.
- Once you have Homebrew installed, run
brew tap osx-cross/arm && brew install arm-gcc-bin
to register a repository with Homebrew that contains the toolchain used to build PROS projects, and then install the toolchain. - Run
brew tap purduesigbots/pros
to register the PROS Homebrew repository with Homebrew. - Run
brew cask install pros-editor
to install the PROS Editor (the CLI will also be installed). This may also take a while. - That's it! You can now start using PROS 3.
Other Methods
If you don't want to use Homebrew to install PROS 3, you can install all the components manually.
Install the toolchain
- Download the latest version of the GNU Arm Embedded Toolchain for macOS from their site.
- Once you have downloaded the toolchain, double click the file to extract its contents.
- Copy the contents of the
gcc-arm-none-eabi-X-20XX-qX-update
folder (where the Xs are numbers specific to the version you downloaded) to another folder, for example/usr/local/lib/pros-toolchain
. - Now you will need to link the toolchain binaries to somewhere that the system will be able to find them. There are two ways to do this:
- recommended, easy to update: run
mkdir -p /usr/local/bin/pros-toolchain && ln -s /usr/local/lib/pros-toolchain/bin/* /usr/local/bin/pros-toolchain
replacing/usr/local/lib/pros-toolchain
with the path to the folder you made in step 4 above. Finally, add/usr/local/bin/pros-toolchain
to the end of your/etc/paths
file. - easier, less easy to update: simply run
ln -s /usr/local/lib/pros-toolchain/bin/* /usr/local/bin
.
- recommended, easy to update: run
Install the CLI
- Install Python 3.6 or higher from the Python website.
- Install the CLI by downloading the latest version of the Python Wheel file (.whl) from here. Once downloaded, run
python3 -m pip install ~/Downloads/pros-cli-v5_3.X.X-py3-none-any.whl
(replacing that path with the path to which you downloaded the file).
Install the Editor
- Build and install cquery by following the instructions on their wiki page.
- Download the pros-editor-mac.zip file from our releases page. Once downloaded, double click to extract the application, then drag the
PROS Editor.app
file to your/Applications
folder.
Requirements
Minimum macOS version: 10.8 Minimum Python version: 3.6
Known Issues
RuntimeError: Click will abort further execution because Python 3 was configured to use ASCII as encoding for the environment.
If you are using the PROS Editor, open up your init script (File > Init Script) and add the following two lines:
process.env.LANG = 'en_US.utf-8' process.env.LC_ALL = 'en_US.utf-8'
If you are just using the CLI at the Terminal:
- Open up your Terminal.
- Run
cd
to make sure you're in your home directory. - Run
touch .bash_profile
to make sure you have a shell login configuration file. - Edit the
~/.bash_profile
file in your preferred editor (you can also runopen -e .bash_profile
to edit it in TextEdit), adding the following two lines at the end:
export LANG="en_US.utf-8" export LC_ALL="en_US.utf-8"
- Run
. .bash_profile
to reload the file for the current session.
/bin/sh: intercept-c++: command not found
- Check your PROS CLI version by running
prosv5 --version
. If your version is <= 3.1.2, try updating first to check if that solves your problem. If not, continue with step 2. - Follow steps 1-4 listed above for those using the CLI only. In step 4, however, add the following line instead (replacing the Xs with the numbers found in step 1):
export PATH="/usr/local/Cellar/pros-cli/3.X.X/libexec/bin:$PATH"