macOS installation

Installation Procedure

Install Homebrew

Follow the installation instructions from there: https://brew.sh Note: When installing Brew, the XCode Command Line Tools are also installed.

And then install the following packages:

brew install cmake swig wget

Clone the Github Repository

From a Terminal app, create the development directory in your home directory and clone the repository.

Note: instead of cloning https://github.com/omichel/webots.git, we recommend to create your own fork and clone it, so that you can commit your changes directly on it.

cd
mkdir develop
cd develop
git clone https://github.com/omichel/webots.git
cd webots
git submodule init
git submodule update

Environment variables

It is convenient to add the following environment variables into your ~/.bash_profile file:

export WEBOTS_HOME=$HOME/develop/webots/webots      # Defines the path to Webots home.
export WEBOTS_ALLOW_MODIFY_INSTALLATION=1           # If defined, you are allowed to modify files in the Webots home using Webots.
export WEBOTS_DISABLE_SAVE_PERSPECTIVE_ON_CLOSE=1   # If defined, Webots will not save perspective changes when closed.
export WEBOTS_DISABLE_WORLD_LOADING_DIALOG=1        # If defined, the lodaing world progress dialog will never be displayed.

To make the changes available close and reopen your Terminal.

Build Webots

You are know ready to compile Webots and all the required resources. The first time you compile Webots some dependencies will be automatically downloaded and installed in the Webots development environment.

make release -jX  # X is the number of cores.

In addition to the default release target, the following targets are also available:

• debug: Compiles with debugging symbols.
• profile: Compiles with debugging and profiling symbols (required to run GNU gprof for example).
• distrib: Compiles Webots in release mode and then create the distribution package.
• clean: Clean the compilation outputs.
• cleanse: Deep clean (some additional files such as dependencies are removed too).