X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/980550fcd7ef28e4d8984f7f6495e78aa367471d..1fb1f1d833eb11cab4f4cfeace3044f0255f6df2:/docs/mac/install.txt diff --git a/docs/mac/install.txt b/docs/mac/install.txt index 850726c890..6fff2a4940 100644 --- a/docs/mac/install.txt +++ b/docs/mac/install.txt @@ -1,10 +1,10 @@ -wxWindows 2.5 for Mac installation ----------------------------------- +wxWidgets 2.6.2 for Mac installation +------------------------------------ On MacOS X, you can download Apple's free developer tools (gcc and associated headers and libraries, such as the Carbon API). You can then use configure in a similar way to compiling -wxWindows on Linux (or on Windows using MinGW or Cygwin). See +wxWidgets on Linux (or on Windows using MinGW or Cygwin). See 'Apple Developer Tools' below for more details on using configure. @@ -17,32 +17,15 @@ each type of application on the target operating system. Installing latest headers (and Carbon Support) ---------------------------------------------- -NOTE: these steps are not necessary for CW Pro 6 and above, -only for CW Pro 5.3. - -The latest build for carbon support leads to a few changes you will have to -follow, in order to successfully compile the code (also necessary if you don't -want to build the carbon targets). - -1. You need CodeWarrior Pro 5.3 , i.e. 5.0 with all the upgrades. -2. You have to download the 3.4.0 (or greater) universal interfaces from - ftp://ftp.apple.com/developer/Development_Kits/UniversalHeaders3.4.1.img.bin. -3. put the Interfaces and Libraries Folder into the MacOS Support folder and - replace older versions. -4. remove from the MacOS Support folder the separate OpenTransport folder. -5. open the file MacOS Support:MacHeaders:MacHeaders.c and add the line - #include - after the - #include -6. rebuild all MacHeaders from the MacHeaders.mcp project in the same folder. - -If you want to build the carbon targets, you will also need the latest -carbonized version of MSL from Metrowerks, at the time of writing, this meant -applying the changes from the folders: - -CodeWarrior Pro 5:Pre-Release:Carbon & MacOSX Development:Carbonized MSL and -CodeWarrior Pro 5:Pre-Release:Carbon & MacOSX Development:Carbonized Runtimes -(consult the file CodeWarrior Pro 5:Pre-Release:Carbon & MacOSX Development:Carbon & MacOSX README) +Patching headers: CodeWarrior 8.x +--------------------------------- + +If you run into trouble with WCHAR_MIN and WCHAR_MAX the for +MacOS X Support:Headers:(wchar_t Support fix):machine:ansi.h, +apply the patch ansi.diff. + +You may also need to comment out the _T definition in +ctype.h if you get multiple definition errors. setup.h ------- @@ -74,32 +57,28 @@ Project Files The project files are stored as xml text files and converted to binary CodeWarrior projects in the distribution (see AppleScript Files below): - - *M5.xml -> *M5.mcp for CodeWarrior 5.3 - - *M6.xml -> *M6.mcp for CodeWarrior 6 - - *M7.xml -> *M7.mcp for CodeWarrior 7 and above. - -In order to build the library (and then the samples) you need to make the -following projects (for CW 5.3, similar process for CW 7): - -:src:wxwindowsM5.mcp -:src:png:pngM5.mcp -:src:tiff:tiffM5.mcp -:src:jpeg:jpegM5.mcp -:src:zlib:zlibM5.mcp -Note that if using CW 8 and above, when compiling the samples -you may need to edit the target settings, click on Language -Settings, C/++ Language and remove the forward slash at the -start of /wx/wx_cw_d.h (or similar filename). + - *M8.xml -> *M8.mcp for CodeWarrior 8 and above. AppleScript Files ----------------- -Several AppleScript files are provided in the docs:mac directory (currently -only for CodeWarrior 5.3 related projects): - - M5xml2mcp.applescript to convert xml files to CodeWarrior projects - - M5mcp2xml.applescript to convert CodeWarrior projects to xml files - - M5build.applescript to automatically build all samples/demos projects +Several AppleScript files are provided in the docs:mac directory: + + - M8xml2mcp.applescript to convert xml files to CodeWarrior 8 projects + - M8mcp2xml.applescript to convert CodeWarrior 8 projects to xml files + - SetXMLCreator.applescript to set correct creator type (see below) + +To run the XML to MCP conversion scripts: + +Double click on e.g. docs/mac/M8xml2mcp.applescript, then "run" +the applescript and when asked for a folder pick src/. Then it +takes a while to scan all dirs for the xml files and convert +them to mcps. If some conversions fail it means an mcp already +exists (back them up prior to running the script). + +To set the correct creator type for importing into CodeWarrior, +you may need to run SetXMLCreator.applescript. Apple Developer Tools --------------------- @@ -122,10 +101,10 @@ account marked as a "Computer Administrator". Then 7) type Note that while using this method is okay for development, it is not -recommended that you require endusers to install wxWindows into their +recommended that you require endusers to install wxWidgets into their system directories in order to use your program. One way to avoid this -is to configure wxWindows with --disable-shared. Another way to avoid -it is to make a framework for wxWindows. Making frameworks is beyond +is to configure wxWidgets with --disable-shared. Another way to avoid +it is to make a framework for wxWidgets. Making frameworks is beyond the scope of this document. Note: