1.4.InstallUnderMacOS

Table of contents

• Overview
• Video
• Steps
  • 1.4.1. Find Xcode
  • 1.4.2. Authorize at Apple Developer network site
  • 1.4.3. Download Xcode
  • 1.4.4. Move Xcode to Applications
  • 1.4.5. Launch Xcode
  • 1.4.6. Agree to open Xcode
  • 1.4.7. Accept Xcode and iOS SDK license agreement
  • 1.4.8. Provide your password to install additional components
  • 1.4.9. Find OpenSceneGraph repository
  • 1.4.10. Get latest OpenSceneGraph
  • 1.4.11. Create build directory
  • 1.4.12. Find and download CMake
  • 1.4.13. Install CMake
  • 1.4.14. Launch CMake
  • 1.4.15. Specify build and source directories
  • 1.4.16. Configure OpenSceneGraph
  • 1.4.17. Observe configuration notice
  • 1.4.18. Generate Xcode project file
  • 1.4.19. Build OpenSceneGraph
  • 1.4.20. Observe installation error
  • 1.4.21. Install OpenSceneGraph
  • 1.4.22. Check 'box.osgt' with 'osgviewer'

Overview

This tutorial is part of OpenSceneGraph cross-platform guide.

In this tutorial we install OpenSceneGraph under macOS and take a look at the cube with osgviewer tool.

Note: this tutorial requires OpenSceneGraph model created in 1.1. Create a cube.

Video

YouTube | Download

Video depicts OpenSceneGraph installation under macOS El Capitan (10.11).

Steps

Note: steps below use frames from the video as screenshots. Watch the video to see all details.

1.4.1. Find Xcode

Xcode is an integrated development environment for macOS. It contains C/C++ compiler that we will use to build OpenSceneGraph.

1.4.2. Authorize at Apple Developer network site

You need a valid Apple ID to download Xcode.

1.4.3. Download Xcode

Choose the latest Xcode version that suits your macOS version. In case of El Capitan, it's Xcode 8.2.

1.4.4. Move Xcode to Applications

Move Xcode from Downloads directory into Applications directory. This lets CMake, which we install later, find Xcode development tools without additional help.

1.4.5. Launch Xcode

Since Xcode has been downloaded from the Internet, macOS first verifies the file. This may take up some time.

1.4.6. Agree to open Xcode

Since Xcode has been downloaded from the Internet, macOS needs your permission to open the file.

1.4.7. Accept Xcode and iOS SDK license agreement

Accept Xcode and iOS SDK license agreement to be able to use the product.

1.4.8. Provide your password to install additional components

Provide your password to allow Xcode to install necessary additional components like Git and xcodebuild.

Close Xcode after it has been launched.

1.4.9. Find OpenSceneGraph repository

Find OpenSceneGraph repository at the website.

1.4.10. Get latest OpenSceneGraph

Get the latest copy of OpenSceneGraph with the following command:

git clone https://github.com/openscenegraph/OpenSceneGraph.git

1.4.11. Create build directory

OpenSceneGraph uses CMake build system, which supports out-of-source builds. We create a build directory to keep generated (built) content separate from the original source.

1.4.12. Find and download CMake

Find CMake and download its macOS version.

1.4.13. Install CMake

Launch downloaded dmg package and follow instructions to install CMake.

1.4.14. Launch CMake

Open CMake.

1.4.15. Specify build and source directories

Build directory is the one we created to host binaries.

Source directory is the one where we cloned OpenSceneGraph using Git.

1.4.16. Configure OpenSceneGraph

Before we can build OpenSceneGraph, we need to configure the build. Do it by pressing Configure button.

Make sure to select Xcode generator when prompted.

1.4.17. Observe configuration notice

By default, OpenSceneGraph libraries are installed into /usr/local/lib, which is not where libraries usually reside.

However, macOS El Capitan is aware of /usr/local/lib location, so we don't need to do anything about it.

1.4.18. Generate Xcode project file

Press Generate to generate Xcode specific project file.

1.4.19. Build OpenSceneGraph

We are finally ready to build OpenSceneGraph with the following command:

xcodebuild -IDEBuildOperationMaxNumberOfConcurrentCompileTasks=6 -target install -configuration Release

xcodebuild is a command line utility to build Xcode projects. Of course, we could use Xcode itself, but then this tutorial would be a lot longer.

Here's a brief overview of the parameters we used:

• -IDEBuildOperationMaxNumberOfConcurrentCompileTasks=6 requests 6 parallel jobs to speed up the build process;
• -target install makes installation phase start right after the building one;
• -configuration Release strips binaries of debug information, which we don't need in this tutorial.

1.4.20. Observe installation error

Installation failed, because xcodebuild needs administrative privileges to install OpenSceneGraph into /usr/local/lib.

1.4.21. Install OpenSceneGraph

Run xcodebuild with administrative privileges using the following command:

sudo xcodebuild -IDEBuildOperationMaxNumberOfConcurrentCompileTasks=6 -target install -configuration Release

Make sure to provide your password for sudo when prompted.

1.4.22. Check 'box.osgt' with 'osgviewer'

Finally, take a look at the cube with osgviewer:

/usr/local/bin/osgviewer /path/to/box.osgt