Difference between revisions of "Compiling/XCode"

From BRL-CAD
(Compiling)
 
(9 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 +
''Note: Some users have been experiencing problems running through this process on Mac OS X Mountain Lion, which dropped support for X11. The problems have been noted and are being worked on.''
 +
 
= Compiling BRL-CAD with Xcode on Mac OS X =
 
= Compiling BRL-CAD with Xcode on Mac OS X =
 
'''''THIS GUIDE IS CURRENTLY UNDER CONSTRUCTION'''''
 
  
 
An already built and running version of BRL-CAD for Mac OS X can be downloaded from [http://sourceforge.net/projects/brlcad/files/BRL-CAD%20for%20Mac%20OS%20X/ here], or these steps will guide you through the process of how to compiling it yourself.
 
An already built and running version of BRL-CAD for Mac OS X can be downloaded from [http://sourceforge.net/projects/brlcad/files/BRL-CAD%20for%20Mac%20OS%20X/ here], or these steps will guide you through the process of how to compiling it yourself.
Line 7: Line 7:
 
== Obtain Dev Tools ==
 
== Obtain Dev Tools ==
  
Download the latest version of [http://www.cmake.org/cmake/resources/software.html CMake for Mac OS X]. Follow the instructions to install and be sure to  
+
Download the latest version of [http://www.cmake.org/cmake/resources/software.html CMake for Mac OS X]. Once downloaded, follow the instructions to install CMake and be sure to select the box for installing the CMake Command Line tools:
 +
 
 +
[[Image:CMakeCommandLineTools.png|none|430px|]]
  
The latest version of the BRL-CAD source is also required, which can be obtained here: [https://sourceforge.net/projects/brlcad/files/BRL-CAD%20Source/ Sourceforge]
+
The latest version of the BRL-CAD source is also required, which can be obtained [https://sourceforge.net/projects/brlcad/files/BRL-CAD%20Source/ here].
  
You will also need Xcode, which can be downloaded from the Mac App Store. When installing, make sure you install the unix development command-line tools. Or if you already have Xcode installed and want to see if you need to install them, you can check in Xcode Preferences > Downloads??
+
You will also need Xcode, which can be downloaded from the Mac App Store. When installing, make sure you install the unix development command-line tools. Or if Xcode is already installed on your system, you can install the command line tools (or double-check to make sure you have them) by navigating to Xcode Preferences > Downloads and in the components tab, you should see Command Line Tools:
 +
 
 +
[[Image:XcodeCommandLineTools.png]]
  
 
== Compiling ==
 
== Compiling ==
  
Open Terminal (in /User/Applications/Utilities) and cd to the location of the brl-cad source folder:
+
Navigate to the BRL-CAD source directory you downloaded and create a new folder titled "brlcad-build." This is where we will store the configured build:
  
  cd brlcad
+
[[Image:BrlcadFolder.png]]
  
Create a new folder called "brlcad-build," which is where we will store the configured CMake build. We will then need CMake to compile the build:
+
[[Image:XcodeBRLCADProject.png|thumb|right|256px|The Xcode project file that should result.]]
 +
Open Terminal (in /User/Applications/Utilities) and cd to the location of the BRL-CAD source folder (Note: you can type cd, press the spacebar, and then drag the brlcad folder to copy its search path):
 +
 
 +
  cd brlcad-7.22.0
 +
 
 +
Now, we create a BRL-CAD Xcode project that we can use to compile BRL-CAD:
 +
(this may take some time)
  
 
   cd brlcad-build
 
   cd brlcad-build
   cmake ..
+
   cmake .. -G Xcode
 
 
Install the CMake configuration:
 
  
  sudo make install
+
== Finishing ==
  ls -la /usr/brlcad
 
  /usr/brlcad/*/bin/mged
 
  
Run to compile a working Xcode BRL-CAD Project:
+
Open the resulting BRLCAD.xcodeproj file with Xcode and press Build and Run. Thats it!

Latest revision as of 03:09, 1 December 2012

Note: Some users have been experiencing problems running through this process on Mac OS X Mountain Lion, which dropped support for X11. The problems have been noted and are being worked on.

Compiling BRL-CAD with Xcode on Mac OS X[edit]

An already built and running version of BRL-CAD for Mac OS X can be downloaded from here, or these steps will guide you through the process of how to compiling it yourself.

Obtain Dev Tools[edit]

Download the latest version of CMake for Mac OS X. Once downloaded, follow the instructions to install CMake and be sure to select the box for installing the CMake Command Line tools:

CMakeCommandLineTools.png

The latest version of the BRL-CAD source is also required, which can be obtained here.

You will also need Xcode, which can be downloaded from the Mac App Store. When installing, make sure you install the unix development command-line tools. Or if Xcode is already installed on your system, you can install the command line tools (or double-check to make sure you have them) by navigating to Xcode Preferences > Downloads and in the components tab, you should see Command Line Tools:

XcodeCommandLineTools.png

Compiling[edit]

Navigate to the BRL-CAD source directory you downloaded and create a new folder titled "brlcad-build." This is where we will store the configured build:

BrlcadFolder.png

The Xcode project file that should result.

Open Terminal (in /User/Applications/Utilities) and cd to the location of the BRL-CAD source folder (Note: you can type cd, press the spacebar, and then drag the brlcad folder to copy its search path):

 cd brlcad-7.22.0

Now, we create a BRL-CAD Xcode project that we can use to compile BRL-CAD: (this may take some time)

 cd brlcad-build
 cmake .. -G Xcode

Finishing[edit]

Open the resulting BRLCAD.xcodeproj file with Xcode and press Build and Run. Thats it!