premake/README-macosx.txt
author Sam Lantinga <slouken@libsdl.org>
Wed, 04 Jun 2014 10:56:56 -0700
changeset 8820 0e935d5b193a
parent 7925 f090a47eb7f7
child 9112 345a7d41dda9
permissions -rwxr-xr-x
Added annotations to help code analysis tools

CR: Bruce Dawson
     1 Use the Xcode command files (located in the Xcode/build-scripts folder)
     2 to conveniently generate a workspace for Xcode 3 or Xcode 4. It also
     3 contains a cleaner script and a convenient script for automatically
     4 running all the test suites.
     5 
     6 If you use the script to automatically build the workspace file, you
     7 need to open the workspace at least once after generating it, or it
     8 will give errors that certain schema do not exist within the workspace.
     9 Also, the script depends on Xcode command line tools being installed.
    10 
    11 There are separate build files for building for i386 architecture
    12 versus x86_64 architecture. There are separate build scripts for
    13 Xcode 3 versus Xcode 4, but these just use the different toolchains.
    14 
    15 There is a script for automatically running through all known supported
    16 tests on that platform.
    17 
    18 The Mac OS X projects currently have reliance on the following dependencies:
    19 
    20   -AudioToolbox.framework
    21   -AudioUnit.framework
    22   -Cocoa.framework
    23   -CoreAudio.framework
    24   -IOKit.framework
    25   -Carbon.framework
    26   -ForceFeedback.framework
    27   -CoreFoundation.framework
    28 
    29 It will also link to OpenGL.framework, as the dependency function for OpenGL
    30 assumes that OpenGL always exists on Mac OS X. However, this is defined in
    31 a segmented way to allow the possibility of no OpenGL support on Mac OS X.
    32 
    33 Run the clean script to clear out the directory of Xcode-related files
    34 and binaries.