1.3. Install on macOS¶
This section of the guide refers to the installation of the IDE under Mac OS. These instructions should work for all versions of macOS. You may need to give the Administrator password when installing some programs, depending on your user settings.
So, we are now going to walk through the process of installing CMake on your computer. We use CMake to manage software project(s), and to instruct your compiler how to generate and link libraries.
- Step 1: Download CMake
- Download CMake from the CMake website.
- Step 2: Launch Apple disk image
- Once you have successfully downloaded the
.dmgfile, simply double-click on it.
- Step 3: Install CMake application
- To complete the installation, drag and drop CMake onto the Applications folder.
- Step 4: Launch CMake
Launch CMake from Launchpad or Spotlight. The interface that pops up is only used to test whether CMake has been correctly installed, and to perform step 5 of this guide. You do not need to fill anything in.
If you get the warning: “‘CMake’ can’t be opened because it is from an unidentified developer.”, please make sure to enable “Allow apps dowloaded from: Anywhere” under the “System Preferences” > “Security & Privacy”.
- Step 5: Add CMake to path
From the “Tools” menu select “How to Install For Command Line Use”. From the dialog that pops up, note the
cmake-gui path, this may be required later. Open a terminal by executing Cmd+Space, typing terminal and confirming with Enter. Type:
sudo mkdir -p /usr/local/bin sudo /Applications/CMake.app/Contents/bin/cmake-gui --install=/usr/local/bin
Hopefully no errors occured.
If an error occurs, check whether the path
/Applications/CMake.app/Contents/bin/cmake-guicorresponds to the
cmake-gui paththat you noted down earlier. If not, change the above command so that the two match.
Now, Verify that it has been correctly installed to PATH by executing:
If cmake can’t be found, even after succesfully installing CMake for command-line use, you first need to verify that the symbolic links were properly made, execute:
ln -al /usr/local/bin/cmake
You should see something like:
lrwxr-xr-x 1 root wheel 42 5 Feb 10:49 /usr/local/bin/cmake -> /Applications/CMake.app/Contents/bin/cmake
This means that
/usr/local/binis not added to the list of paths. Do this now manually by editing
sudo pico /etc/paths
/usr/local/binon a new line. Exit (Cmd+X) and save (Y) your changes. Close the terminal and restart the terminal:
should now give you the desired result, showing some details on your CMake installation.
We are now going to walk through the process of installing git on your computer. We use git to download the software of the project(s) and to make sure that you can always be up-to-date on the latest modifications to the code.
- Step 1: Download git
- The install process for git is very similar to that for CMake: go to the git website to download the installer
- Step 2: Install git
- Run the
.dmgand open the enclosed
.pkgto install git on your system. Step through the installation and provide you administrator password when prompted.
For the compilation of Tudat and its libraries, XCode (or the command-line tools for XCode) version 7.3 or newer is required. You can upgrade XCode through the AppStore or by downloading a new version, to replace the old one.
- Step 1: Download XCode
- Download XCode (command-line tools alone suffices) from the Apple developer downloads (ADC account and Apple ID required) or through the Mac App Store. Note installing only the “Command Line Tools OSX 10.XX for Xcode 7.X” offers a significant reduction in size (download size of 157MB vs 4.7GB).
Step 2: Install XCode
Open the downloaded
.dmg and execute the enclosed
.pkg to start the installation. Complete the installation.
1.3.4. Qt Creator¶
- Step 1: Download Qt Creator
- Download QtCreator from the Qt website.
- Step 2: Execute the installer
- Open the downloaded
.dmgand execute the enclosed installer.
- Step 3: Skip account
- You can safely skip logging into your Qt account. Press “Skip” and “Next”, the online installer will prepare the sources. Click continue. The installer will now prepare the installation (this will take a short while). You might be prompted by an Xcode warning, even though you have Xcode or the Xcode command-line tools installed. If you encounter this, click away the warning by pressing “Ok”, three times, the installation will continue as normal.
- Step 4: Choose a location
- Specify your preferred installation directory (or leave it at default).
- Step 5: Select components
- Click “Continue” until you get to the “Select Components” step. Here you get the option to select which parts of the Qt SDK you wish to install, shown below. Only QtCreator (default, can not be unchecked) from the Tools section is necessary. Finish the installation.
- Step 6: Check Settings
- Once Qt Creator is installed, you will need to verify that the various compilation settings have been defined correctly. Make sure to check
Qt Creator Kitson the Verify Build & Run options page.