Basic instructions for setting up tests

The following is a series of brief, step-by-step instructions on setting up a project to compile and run Boost unit tests from Xcode. These steps assume a workable knowledge of Xcode and how to build projects. They are intended to provide a short overview of how the associated demonstration project was set up.

Step 1

Add a new target to your Xcode project. This is found under the New submenu of the File menu.

Step 2

Choose the Aggregate target under the Other group. Give it a meaningful name.

Step 3

Create a folder called "tests" at your source root (where you have your Xcode project).

Step 4

Create your unit test files in the tests folder and add them to your Xcode project. They should be added to your new aggregate build target. (I'm assuming you already know how to do this).

Step 5

Copy the run_tests.sh shell script from the repository into the tests folder.

Step 6

Configure your Build Settings for the aggregate build target. Set your header search path to wherever your headers are located.

Step 7

Set the linker flags for the Build Settings of your aggregate build target.

Step 8

Configure the Build Phases of your aggregate build target. Your dependencies should include whatever libraries you are linking against that need to be built. You'll also need to add a Run Script phase that executes the script in tests.

Run Script code


exec "${SRCROOT}/tests/run_tests.sh"
exit 1

Step 9

Choose your aggregate build target and build.