diff --git a/chapters/setup/macos.md b/chapters/setup/macos.md index 5f656ea..e1c064a 100644 --- a/chapters/setup/macos.md +++ b/chapters/setup/macos.md @@ -2,18 +2,20 @@ ## Dependencies -| Program | Description | Source | Comment | -| :------: | :--------------------------------------------: | :-------------: | :------: | -| XCode | Compiler & IDE | AppStore | | -| CMake | Build file generator | brew / download | Optional | -| Ninja | Build system similar to Makefiles, but faster. | brew / download | Optional | -| xcpretty | Pretty prints XCode command line output | brew / download | Optional | +| Program | Description | Source | Comment | +| :---------------------------------------------------------: | :--------------------------------------------: | :-------------: | :------: | +| [XCode](https://apps.apple.com/app/xcode/id497799835?mt=12) | Compiler & IDE | AppStore | | +| [CMake](https://cmake.org) | Build file generator | brew / download | Optional | +| [Ninja](https://ninja-build.org) | Build system similar to Makefiles, but faster. | brew / download | Optional | +| [xcpretty](https://github.com/xcpretty/xcpretty) | Pretty prints XCode command line output | brew / download | Optional | ## Install +The minimum setup, you'll need for writing JUCE applications, consists of 3 parts: Xcode as your compiler and IDE, the Projucer for creating and managing JUCE projects. and the JUCE library, so you can include the headers in your source code. + ### Xcode -Xcode is Apples in-house IDE. The same that Visual Studio is to Windows. Xcode is free for personal and professional use. So no fees required. The only thing that you will need, is an Apple Computer that is signed in to your Apple ID. If that's the case you can simply search for Xcode on the AppStore and start downloading. This may take a while, depending on your internet connection, since it needs to download around 10 gigabytes. +Xcode is Apples in-house IDE. The same that Visual Studio is to Windows. Xcode is free for personal and professional use. So no fees required. The only thing that you will need, is an Apple Computer that is signed in to your Apple ID. If that's the case you can simply search for [Xcode on the AppStore](https://apps.apple.com/app/xcode/id497799835?mt=12) and start downloading. This may take a while, depending on your internet connection, since it needs to download around 10 gigabytes. ### JUCE via download @@ -29,17 +31,26 @@ xcodebuild --project Projucer.xcodeproj --configuration Release | xcpretty ### Projucer from the command line -If you want to run the Projucer and Xcode from the command line you need to add both to your PATH environment variable. Up until macOS 10.15 `bash` is set as the default shell. With Catalina Apple switched to `zsh`. The syntax for adding environment variables is the same for both shells. You just need to pick the correct configuration file: +If you want to run the Projucer and Xcode from the command line you need to add both to your PATH environment variable. Up until macOS 10.15 **bash** is set as the default shell. With Catalina Apple switched to **zsh**. The syntax for adding environment variables is the same for both shells. You just need to pick the correct configuration file: ```sh nano ~/.bashrc nano ~/.zshrc ``` +Add your location: + ```sh export PATH=/path/to/Projucer.app/Contents/MacOS:$PATH ``` +Reload the environment: + +```sh +source ~/.bashrc +source ~/.zshrc +``` + ## Tools ### Homebrew