Building NodeBox

Do you need a build?

If you want to use NodeBox as a Python module inside of another application or from the command line, you might not need your own custom build. Read the  console instructions for more information.

Tiger support

OS X 10. 4 (Tiger) is no longer supported. This build instructions need to be carried out on Leopard or Snow Leopard.

Note that a build created on Snow Leopard will not work on Leopard. You have to use Leopard to create a build that works on both.

Getting the source

Read the download instructions for information on how to get the NodeBox source.

Requirements

You only need to have the Mac OS X Developer Tools, available from the  Mac Dev Center. Free registration necessary.

XCode

NodeBox is set up as an XCode project, with all necessary build steps created as XCode targets. You can execute a target from the IDE, or from the command line.

Development

To work on NodeBox, just use XCode as a Python IDE and press the run button to create a new development build. Alternatively, you can create a build from the command line:

   xcodebuild -target NodeBox -configuration Debug

Distribution

To create a NodeBox distribution, you first need to set the version number. Change the version number in the following files:

   NodeBox-Info.plist (change the line below CFBundleShortVersionString)
   nodebox/__init__.py
   README

Then you're ready to execute the "Build Distribution" target. Right-click it from the IDE (it's under Targets) and select 'Build "Build Distribution" '. Make sure the build configuration is "Debug". The release configuration does not work.

Alternatively, you can do this from the command line:

   xcodebuild -target "Build Distribution" -configuration Debug

When this is done, it will result in a NodeBox.dmg file in the "dist" folder. Rename this dmg to include the version number, so that it looks like this:

   NodeBox-1.9.6.dmg

That's all. You have created a NodeBox distribution.