This manual page is part of Xcode Tools version 3.2.2

To obtain these tools:

If you are running a version of Xcode Tools other than 3.2.2, view the documentation locally:

  • In Xcode

  • In Terminal, using the man(1) command

Reading manual pages

Manual pages are intended as a quick reference for people who already understand a technology.

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

  • For more information about this technology, look for other documentation in the Apple Reference Library.

  • For general information about writing shell scripts, read Shell Scripting Primer.


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.

     GCC_ENABLE_OBJC_GC  Whether or not the test bundle was compiled with Objective-C garbage collection
                         enabled.  Possible values are unsupported, supported, and required.  If not set,
                         defaults to unsupported, which will run otest(1) with Objective-C garbage collec-tion collection
                         tion disabled.

     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                                        May 12, 2010                                        Mac OS X

Reporting Problems

The way to report a problem with this manual page depends on the type of problem:

Content errors
Report errors in the content of this documentation with the feedback links below.
Bug reports
Report bugs in the functionality of the described tool or API through Bug Reporter.
Formatting problems
Report formatting mistakes in the online version of these pages with the feedback links below.

Did this document help you? Yes It's good, but... Not helpful...