docs/mac/install.txt

   1 Installing latest headers (and Carbon Support)
   2 ----------------------------------------------
   3
   4 NOTE : these steps are not necessary for Pro 6, only for Pro 5.3
   5
   6 the latest build for carbon support lead to a few changes you will have to
   7 follow, in order to successfully compile the code (also necessary if you don't
   8 want to build the carbon targets)
   9
  10 1. you need CodeWarrior Pro 5.3 , i.e. 5.0 with all the upgrades
  11 2. you have to download the 3.3.2 universal interfaces from
  12         ftp://ftp.apple.com/developer/Development_Kits/UniversalInterfaces3.3.2.sit.hqx
  13 3. put the Interfaces and Libraries Folder into the MacOS Support folder and replace older versions
  14 4. remove from the MacOS Support folder the separate OpenTransport folder
  15 5. open the file MacOS Support:MacHeaders:MacHeaders.c and add the line
  16                 #include <ControlDefinitions.h>
  17         after the
  18                 #include <Controls.h>
  19 6. rebuild all MacHeaders from the MacHeaders.mcp project in the same folder
  20
  21 if you want to build the carbon targets, you will also need the latest
  22 carbonized version of MSL from Metrowerks, at the time of writing, this meant
  23 applying the changes from the folders
  24 CodeWarrior Pro 5:Pre-Release:Carbon & MacOSX Development:Carbonized MSL and
  25 CodeWarrior Pro 5:Pre-Release:Carbon & MacOSX Development:Carbonized Runtimes
  26 (consult the file CodeWarrior Pro 5:Pre-Release:Carbon & MacOSX Development:Carbon & MacOSX README)
  27
  28 setup.h
  29 -------
  30
  31 in order to build wxMac with CodeWarrior, you must copy or alias the file
  32 include/wx/mac/setup0.h to include/wx/setup.h.
  33
  34 this step is not needed when using the Apple Developer Tools under Mac OS X
  35 since the setup.h file is automatically generated during the configuration.
  36
  37 OpenGL
  38 ------
  39
  40 In order to build opengl support with CodeWarrior, you must install the opengl
  41 libraries and headers from http://developer.apple.com/opengl/index.html
  42
  43 If you want OpenGL support with CodeWarrior, set wxUSE_OPENGL to 1 in
  44 include/wx/setup.h
  45
  46 If you don't want OpenGl support, remove the file "glcanvas.cpp" from the
  47 project before compilation and leave the setting at 0
  48
  49 If you want OpenGL support with the Apple Developer Tools under Mac OS X, add
  50 --with-opengl to the arguments of configure when configuring wxMac.
  51
  52 Project Files
  53 -------------
  54
  55 The project files are stored as xml text files and converted to binary
  56 CodeWarrior projects in the distribution (see AppleScript Files below):
  57   - *M5.xml -> *M5.mcp for CodeWarrior 5.3
  58   - *M6.xml -> *M6.mcp for CodeWarrior 6
  59   - *M7.xml -> *M7.mcp for CodeWarrior 7
  60
  61 In order to build the library (and then the samples) you need to make the
  62 following projects (for 5.3)
  63 :src:wxxindowsM5.mcp
  64 :src:png:pngM5.mcp
  65 :src:tiff:tiffM5.mcp
  66 :src:jpeg:jpegM5.mcp
  67 :src:zlib:zlibM5.mcp
  68
  69 AppleScript Files
  70 -----------------
  71
  72 Several AppleScript files are provided in the docs:mac directory (currently
  73 only for CodeWarrior 5.3 related projects):
  74   - M5xml2mcp.applescript to convert xml files to CodeWarrior projects
  75   - M5mcp2xml.applescript to convert CodeWarrior projects to xml files
  76   - M5build.applescript to automatically build all samples/demos projects
  77
  78 Apple Developers Tools
  79 ----------------------
  80
  81 As in all Unix projects, you need to do something like this under MacOS 10.1
  82 with the Apple Developers Tools installed:
  83
  84 1) cd into the source dir
  85 2) mkdir build
  86 3) cd build
  87 4) ../configure
  88 5) make
  89
  90 If you want to install the library, you need to be able to log in as "root".
  91 For this, "root" has to be activated in the NetInfo utility - there you will
  92 also have to choose a password for the "root" user. Then
  93
  94 6) su
  95 7) type <PASSWORD>
  96 8) make install
  97 9) exit
  98
  99 Note:
 100 You might want to configure a static library instead:
 101
 102 4) ../configure --disable-shared
 103
 104 or activate OpenGL:
 105
 106 4) ../configure --with-opengl
 107
 108
 109 Problems with .xpm files
 110 ------------------------
 111
 112 if you have downloaded all the files and get errors like :
 113
 114 Error   : the file 'wx/generic/tip.xpm' cannot be opened
 115 tipdlg.cpp line 201   #include "wx/generic/tip.xpm"
 116
 117 then your cvs has changed the type of the .xpm files to something other than
 118 text, in order to fix this either change the type by using a resource editor
 119 or drag the files from /include/wx/generic/..xpm on the SetTypeFromExtension
 120 application that is included in this folder. This small applet itself queries
 121 the Internet Config, so you will have to associate the "xpm" extension with
 122 CodeWarrior before making use of this applet.
 123
 124 Missing PLStringFuncsLib
 125 ------------------------
 126
 127 You will have to build All Targets for MacOS Support:Libraries:Sources:PLStringFuncs:Glue:PLStringFuncsGlue.mcp