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

NAME
     RRuunnTTaarrggeettUUnniittTTeessttss - run unit tests for the current target

SYNOPSIS
     RRuunnTTaarrggeettUUnniittTTeessttss

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

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

     RRuunnTTaarrggeettUUnniittTTeessttss 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 architec-
                         ture.  If unspecified, tests are run for the archi-
                         tecture returned by arch(1).

     DEVELOPERDIR       The Xcode folder, e.g. "/Developer". If unspecified
                         the value for SYSTEMDEVELOPERDIR will be used, or
                         "/Developer" if that also is unspecified.

     BUILTPRODUCTSDIR  The directory containing built products; when tests
                         are run, this is specified in DYLDFRAMEWORKPATH.
                         If unspecified tests are run from the current working
                         directory with no DYLDFRAMEWORKPATH.

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

     GCCENABLEOBJCGC  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 collection dis-
                         abled.

     NATIVEARCHACTUAL  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.

     TESTAFTERBUILD    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                       December 21, 2019                      Mac OS X