Mac OS X
Building the viewer on Mac OS X
Install the Development Tools
In order to build Alchemy, you will need to download a few software packages and install them. These are:
- Xcode 8 or later (with Command Line Tools)
- CMake 3.6 or later
- Mercurial
- Linden Lab Autobuild
Please refer to the applicable software distributors for installation instructions.
Getting the Source Code
Our source code is hosted in a mercurial repository on Bitbucket and can be cloned to your hard drive with the following command:
hg clone https://bitbucket.org/alchemyviewer/alchemy
Configuring the Viewer
We highly recommend building with autobuild. While there are ways to build the viewer without autobuild, these methods are both unsupported and unadvised.
For a basic self-compiled build, simply run these commands from the Alchemy repository on your local machine:
autobuild configure -c RelWithDebInfoOS -- -DPACKAGE:BOOL=FALSE -DFMODSTUDIO:BOOL=TRUE
For a 64-bit build, add:
-DWORD_SIZE=64
Building the Viewer
Now that you've successful configured the viewer, start a build with the following command:
autobuild build -c RelWithDebInfoOS --no-configure
If you want to get fancy, you can configure and build in one command, like so:
autobuild build -c RelWithDebInfoOS -- -DPACKAGE:BOOL=FALSE -DFMODSTUDIO:BOOL=TRUE
The viewer may also be built from inside the Xcode IDE once you have configured the viewer, though we do not officially support this method. To do so, simply open Alchemy.xcodeproj located in the build-i386-darwin directory.
Running your Newly Built Viewer
You can run your newly created application from the repository's root directory with the following command:
open build-darwin-i386/newview/configuration-type/Alchemy.app
or, using Finder, navigate to this very same directory and double click Alchemy.