Celestia/Development/MacOS platform

From Wikibooks, open books for an open world
Jump to: navigation, search

Install XCode Tools[edit]

If you've not already done so, install Xcode 2.4.x or higher from the OS X CD/DVD, or download it from Apple. Make sure that you choose options and install the Universal SDK.

Subversion[edit]

Before compiling Celestia, you must obtain the source code. The very latest source code is kept in SourceForge's Subversion (SVN) repository. You can get the source code by following these instructions:

  1. Open Terminal
  2. See if SVN is installed on your system. Type "svn" in the terminal (without the quotes.) If you get a "command not found" error message, you need to install SVN. See this guide for information on installing SVN on Mac OS X.
  3. Type, or paste in: svn co https://celestia.svn.sourceforge.net/svnroot/celestia/trunk celestia
  4. Wait for a while, until the download is complete

The above steps are for the SVN command line client; the procedure will be different for graphical SVN client.

CVS[edit]

Celestia has moved to using Subversion for version control. This section is obsolete and will be removed.

Before compiling Celestia, you must obtain the source code. The very latest source code is kept in SourceForge's CVS archive. You can get the source code by following these instructions:

  1. Open Terminal
  2. Type, or paste in: cvs -d:pserver:anonymous@celestia.cvs.sourceforge.net:/cvsroot/celestia login
  3. As the Password: prompt, hit return
  4. Type: cvs -z3 -d:pserver:anonymous@celestia.cvs.sourceforge.net:/cvsroot/celestia co -P celestia (the "co" means "check out")
  5. Wait for a while, until the download is complete

Compiling[edit]

Navigate to the new "celestia" folder inside your home folder. Look for the celestia.xcodeproj file inside the "macosx" folder and double click it. Once XCode has launched, choose Build > Build and Debug, or Build and Run.

Notes[edit]

  • When compiling a version for everyday use, make sure that you select the Universal_Release target before compiling. Choosing the Debug target will result in a slow version of Celestia that is only suitable for debugging purposes.
  • You can tell if your Celestia is a debug version or not by looking at the splash screen when Celestia starts up. Debug versions will say DEBUG BUILD in capital letters.
  • Compiling on versions of Mac OS X earlier than Tiger 10.4.x is no longer officially supported.
  • Using makefiles and X11 on Mac OS X is not officially supported, but might work.