Installation on OS X using Homebrew
On Apple's OS X SLADE can be installed using Homebrew package manager.
This guide assumes that you are using the recent version of OS X, like Mavericks or Yosemite. Particular combination of older versions of OS and development tools may require additional actions.
The earliest supported version of OS X is Lion.
For instance, some versions of Xcode don't install Command Line Tools by default. You need to configure it by hand.
How to install
Start from the fourth step if you already have Homebrew installed. But first, check the important note below.
- Install Xcode from Mac App Store. If you have a developer account, you can also install it from Apple Developer website.
- Start Xcode, accept its license agreement and enter your password to finalize the installation process.
- Install Homebrew. It's likely that you need to enter your password once again.
- Start Terminal.app.
brew doctor command to verify Homebrew operation. It should output something like
Your system is ready to brew. If it's not the case, carefully read messages and follow proposed actions.
brew tap alexey-lysiuk/slade command to add SLADE formula.
brew install --HEAD slade command to install SLADE. This step will take a while.
brew linkapps slade command to add SLADE to Applications folder.
- Start SLADE from the Launchpad or directly from Applications folder.
How to update
- Start Terminal.app.
brew update command to update Homebrew to the latest version.
brew upgrade slade command to update SLADE to the latest version.
Wait, I want to debug!
Just a warning: You must have some experience with Xcode and programming in general to do so.
- Complete all installation steps.
- If you are on Yosemite or higher you will need to build wxWidgets against the LLVM C++ Standard Library (
libc++). When configuring wxWidgets, try
../configure --enable-debug --with-macosx-version-min=10.10
- Clone SLADE repository using your favorite Git client or simply from the command line:
cd && git clone https://github.com/sirjuddington/SLADE.git.
- Generate XCode project using CMake.app. Use ~/SLADE as a source code path, and ~/SLADE/release as a binaries path. Press Configure button, wait for process to finish, then press Generate button. If you don't have CMake.app installed, use
cd SLADE && mkdir release && cd release && cmake -GXcode .. command.
- Open XCode project located in SLADE/release folder, from the Finder or by using
open SLADE.xcodeproj command.
- Build and run SLADE by pressing
Command + R.
Next time, when you want to grab the latest SLADE source code, do the following:
- Pull from SLADE repository using your favorite Git client or use
cd ~/SLADE && git pull command.
- Update XCode project using CMake.app, i.e. press Configure, wait, press Generate. Or from the command line:
cd release && cmake -GXcode ...
- Open XCode project and run as usual.
Important note for Homebrew users
At the moment of writting, wxWidgets formula cannot be used to build SLADE. Use
brew info wxmac command to check the status of wxWidgets. If it's installed, you need to execute
brew unlink wxmac command, because SLADE installation will fail otherwise. Hopefully, this will be fixed with the next release of wxWidgets.