premake/README-macosx.txt
author Philipp Wiesemann <philipp.wiesemann@arcor.de>
Sat, 06 Dec 2014 00:17:52 +0100
changeset 9267 6fe4583d7e1f
parent 9112 345a7d41dda9
permissions -rwxr-xr-x
Fixed warnings about possible loss of data in conversion.
icculus@7925
     1
Use the Xcode command files (located in the Xcode/build-scripts folder)
icculus@7925
     2
to conveniently generate a workspace for Xcode 3 or Xcode 4. It also
icculus@7925
     3
contains a cleaner script and a convenient script for automatically
icculus@7925
     4
running all the test suites.
icculus@7925
     5
icculus@7925
     6
If you use the script to automatically build the workspace file, you
icculus@7925
     7
need to open the workspace at least once after generating it, or it
icculus@7925
     8
will give errors that certain schema do not exist within the workspace.
icculus@7925
     9
Also, the script depends on Xcode command line tools being installed.
icculus@7925
    10
icculus@7925
    11
There are separate build files for building for i386 architecture
icculus@7925
    12
versus x86_64 architecture. There are separate build scripts for
icculus@7925
    13
Xcode 3 versus Xcode 4, but these just use the different toolchains.
icculus@7925
    14
icculus@7925
    15
There is a script for automatically running through all known supported
icculus@7925
    16
tests on that platform.
icculus@7925
    17
icculus@7925
    18
The Mac OS X projects currently have reliance on the following dependencies:
icculus@7925
    19
slouken@9112
    20
  -CoreVideo.framework
icculus@7925
    21
  -AudioToolbox.framework
icculus@7925
    22
  -AudioUnit.framework
icculus@7925
    23
  -Cocoa.framework
icculus@7925
    24
  -CoreAudio.framework
icculus@7925
    25
  -IOKit.framework
icculus@7925
    26
  -Carbon.framework
icculus@7925
    27
  -ForceFeedback.framework
icculus@7925
    28
  -CoreFoundation.framework
icculus@7925
    29
icculus@7925
    30
It will also link to OpenGL.framework, as the dependency function for OpenGL
icculus@7925
    31
assumes that OpenGL always exists on Mac OS X. However, this is defined in
icculus@7925
    32
a segmented way to allow the possibility of no OpenGL support on Mac OS X.
icculus@7925
    33
icculus@7925
    34
Run the clean script to clear out the directory of Xcode-related files
icculus@7925
    35
and binaries.