This document is a Mac OS X manual page. Manual pages are a command-line technology for providing documentation. You can view these manual pages locally using the man(1) command. These manual pages come from many different sources, and thus, have a variety of writing styles.

This manual page is associated with the Mac OS X developer tools. The software or headers described may not be present on your Mac OS X installation until you install the developer tools package. This package is available on your Mac OS X installation DVD, and the latest versions can be downloaded from developer.apple.com.

For more information about the manual page format, see the manual page for manpages(5).

RunTargetUnitTests(1)     BSD General Commands Manual    RunTargetUnitTests(1)

NAME
     RunTargetUnitTests -- run unit tests for the current target

SYNOPSIS
     RunTargetUnitTests

DESCRIPTION
     RunTargetUnitTests examines its environment and runs the unit tests it presumes are present using
     otest(1).

     RunTargetUnitTests is intended to be called from a shell script build phase.  It expects certain envi-ronment environment
     ronment variables to be configured from Xcode build settings (see below).

     RunTargetUnitTests will run tests for all built architectures appropriate for the machine running the
     tests.

ENVIRONMENT
     ARCHS               The architectures the tests were built for; when tests are run, they will be run
                         once per architecture.  If unspecified, tests are run for the architecture returned
                         by arch(1).

     DEVELOPER_DIR       The Xcode folder, e.g. "/Developer". If unspecified the value for SYSTEM_DEVEL-OPER_DIR SYSTEM_DEVELOPER_DIR
                         OPER_DIR will be used, or "/Developer" if that also is unspecified.

     BUILT_PRODUCTS_DIR  The directory containing built products; when tests are run, this is specified in
                         DYLD_FRAMEWORK_PATH.  If unspecified tests are run from the current working direc-tory directory
                         tory with no DYLD_FRAMEWORK_PATH.

     FULL_PRODUCT_NAME   The full name of the built product, including its wrapper extension if any.

     NATIVE_ARCH_ACTUAL  The architecture of the machine running the tests, used to determine for which
                         architectures tests can be run.  If unspecified, defaults to the architecture
                         returned by arch(1).

     OTEST               The path to the otest command line tool; defaults to /Developer/Tools/otest.

     TEST_AFTER_BUILD    Set to YES to run tests, any other value will prevent test execution.

FILES
     /Developer/Tools/RunTargetUnitTests  The script used to run tests from a shell script build phase.

     /Developer/Tools/otest               The OCUnit test rig.

SEE ALSO
     arch(1), otest(1)

Mac OS X                         April 2, 2008                        Mac OS X