Changes between Version 65 and Version 66 of MacBuild


Ignore:
Timestamp:
Oct 8, 2010, 4:03:38 AM (14 years ago)
Author:
charlief
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • MacBuild

    v65 v66  
    11= Building BOINC Client and Manager on Macintosh OS X =
    2 '''Last updated 10/7/10'''
     2'''Last updated 10/8/10'''
    33
    44This document applies to BOINC version 6.11.9 and later.  It has instructions for building the BOINC Client and Manager for Macintosh OS X. For information on building science project applications to run under BOINC on Macintosh OSX, see BuildMacApp.
     
    2626You need to take certain steps to ensure that you use only APIs that are available in all the OS versions BOINC supports for each architecture. The best way to accomplish this is to use a single development system running OS 10.6.x and cross-compile for the various platforms. The remainder of this document describes that process.
    2727
    28 '''The above requirements apply not only BOINC itself, but also the !WxWidgets, JPEG, c-ares and cURL libraries, as well as all project applications.''' Only theJPEG library must be built for  the x86_64 architecture, since it is used by the libboinc_graphics_api library.
     28'''The above requirements apply not only to BOINC itself, but also to the !WxWidgets, JPEG, c-ares and cURL libraries, as well as all project applications.''' Note: only the JPEG library must be built for  the x86_64 architecture, since it is used by the libboinc_graphics_api library.
    2929
    3030Be sure to follow the directions in this document to ensure that these requirements are met.
     
    3939Apple provides the tools necessary to cross-compile for all three BOINC Mac platform on any Mac running OS 10.6.x.
    4040
    41 You get these tools, including the GCC compilers and system library header files, by installing the XCode Tools package. Building BOINC and the library packages on which it depends requires XCode 3.2 or later running under OS 10.6.x or later. If you have the OS 10.6 installation DVD for your system, you can install XCode Tools at the time you install the OS, or you can install it later by opening the file Optional Installs/XCode Tools/XCodeTools.mpkg.
     41You get these tools, including the GCC compilers and system library header files, by installing the XCode Tools package. Building BOINC and the library packages on which it depends requires XCode 3.2 or later running under OS 10.6.x or later. If you have the OS 10.6 installation DVD for your system, you can install XCode Tools at the time you install the OS, or you can install it later by opening the file `Optional Installs/XCode Tools/XCodeTools.mpkg`.
    4242
    4343Otherwise, you can download it from Apple's web site (it is large: 1.1 GB).  You must be a member of the Apple Developer Connection to download the software, but you can join for free at:
    4444http://connect.apple.com
    4545
    46 '''Building BOINC now requires XCode Tools version 3.2 or later.'''  Note that the MacOS10.4u SDK is not automatically included unless you customize the installation; click  the '''Customize''' button in the ''Installation type'' step when you run the XCode Tools installe.  The MacOS10.4u SDK is required to build wxWidgets (wxMac-2.8.10).
     46'''Building BOINC now requires XCode Tools version 3.2 or later.'''  Note that the MacOS10.4u SDK is not automatically included unless you customize the installation; click  the '''Customize''' button in the ''Installation type'' step when you run the XCode Tools installer.  The MacOS10.4u SDK is required to build wxWidgets (wxMac-2.8.10).
    4747
    4848Source files are now archived using Subversion. You can download svnX, a free GUI application for running Subversion from either [http://www.apple.com/downloads/macosx/development_tools/svnx.html] or [http://www.lachoseinteractive.net/en/community/subversion/svnx/].
     
    5757== Building BOINC Manager with embedded Core Client ==
    5858
    59 BOINC depends on four third-party libraries: wxMac-2.8.10, c-ares-1.6.0, curl-7.19.4, and jpeg-6b. You can obtain these from the following URLs:
     59BOINC depends on four third-party libraries: wxMac-2.8.10, c-ares-1.6.0, curl-7.19.7, and jpeg-6b. You can obtain these from the following URLs:
    6060
    6161wxMac-2.8.10 (needed only if you are building the BOINC Manager):
     
    6767[http://downloads.sourceforge.net/wxwindows/wxMac-2.8.10.tar.bz2]
    6868
    69 curl-7.19.4:
     69curl-7.19.7:
    7070
    7171[http://curl.haxx.se]
    7272
    73 [http://curl.haxx.se/download/curl-7.19.4.tar.gz]
     73[http://curl.haxx.se/download/curl-7.19.7.tar.gz]
    7474
    7575c-ares-1.6.0 (used by curl):
     
    9090MAC_OS_X_VERSION_MIN_REQUIRED=1030
    9191}}}
    92 These are not done by either the XCode projects which come with wxMac-2.8.10, nor the !AutoMake scripts supplied with wxMac-2.8.10, c-ares-1.6.0, curl-7.19.4, or jpeg-6b. So be sure to use our special scripts to build these packages.
     92These are not done by either the XCode projects which come with wxMac-2.8.10, nor the !AutoMake scripts supplied with wxMac-2.8.10, c-ares-1.6.0, curl-7.19.7, or jpeg-6b. So be sure to use our special scripts to build these packages.
    9393
    9494   1. Create a parent directory within which to work. In this description , we will call it BOINC_dev, but you can name it anything you wish.
    95    2. Put the following 3 directories inside the BOINC_dev folder (omit any you don't need):
     95   2. Put the following 4 directories inside the BOINC_dev folder (omit any you don't need):
    9696{{{
    9797c-ares-1.6.0
    98 curl-7.19.4
     98curl-7.19.7
    9999jpeg-6b
    100100wxMac-2.8.10
    101101}}}
    102       Important: do not change the names of any of these 3 directories.
     102      Important: do not change the names of any of these 4 directories.
    103103   3. Get the BOINC source tree from SVN, and put it in the same BOINC_dev folder. To do this, type the following in Terminal:
    104104{{{
     
    160160== Building BOINC Manager Installer ==
    161161
    162 In order to execute BOINC Manager, you have to install it using BOINC Manager Installer. Otherwise, you will encounter an error prompting for improper installation.
     162In order to execute BOINC Manager, you have to install it using BOINC Manager Installer. Otherwise, you will encounter an error prompting for proper installation.
    163163
    164164To build the Installer for the BOINC Manager, you must be logged in as an administrator.  If you are building BOINC version number x.y.z, type the following in Terminal, then enter your administrator password when prompted by the script:
     
    169169}}}
    170170
    171 Substitute the 3 parts of the BOINC version number for x y and z in the above. For example, to build the installer for BOINC version 5.5.4, the command would be
     171Substitute the 3 parts of the BOINC version number for x y and z in the above. For example, to build the installer for BOINC version 6.11.9, the command would be
    172172
    173173{{{
    174 source {path}/BOINC_dev/boinc/mac_installer/release_boinc.sh 5 5 4
     174source {path}/BOINC_dev/boinc/mac_installer/release_boinc.sh 6 11 9
    175175}}}
    176176
    177 This will create a directory 'BOINC_Installer/New_Release_5_5_4' in the BOINC_dev directory.
    178 
    179 The installer is located in 'BOINC_Installer/New_Release_x_y_z/boinc_x.y.z_macOSX_universal'.
     177This will create a directory 'BOINC_Installer/New_Release_6_11_9' in the BOINC_dev directory, and the installer will be located in `{path}/BOINC_dev/BOINC_Installer/New_Release_6_11_9/boinc_6.11.9_macOSX_universal`.
    180178
    181179== Debugging and BOINC security ==