Context Navigation

Changes between Version 84 and Version 85 of MacBuild

Timestamp:: Apr 20, 2015, 5:16:22 AM (9 years ago)
Author:: charlief
Comment:: --

Legend:

: Unmodified
: Added
: Removed
: Modified

MacBuild

-                      v84
+                      v85
 = Building BOINC Client and Manager on Macintosh OS X =
 '''Last updated 4/9/15'''
 This document applies to BOINC version 7.4.42and 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.
+'''Last updated 4/20/15'''
+This document applies to BOINC version 7.4.42 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.
 '''Note''': the information in this document changes from time to time for different versions of BOINC. For any version of BOINC source files, the corresponding version of this document can be found in the source tree at:
 …
 Note: building BOINC Manager 7.3.0 and later requires the OS 10.8 SDK or later.
+BOINC depends on six third-party libraries: wxWidgets-3.0, c-ares-1.10.0, curl-7.39.0, openssl-1.0.1j,  freetype-2.4.10, ftgl-2.1.3~rc5 and sqlite-3.8.3. You can obtain the source files from the following URLs:
+wxWidgets-3.0 (needed only if you are building the BOINC Manager):
+[http://www.wxwidgets.org]
+BOINC depends on seven third-party libraries: wxWidgets-3.0.0, c-ares-1.10.0, curl-7.39.0, openssl-1.0.1j,  freetype-2.4.10, ftgl-2.1.3~rc5 and sqlite-3.8.3.  You can obtain the source files from the following URLs.  Clicking on the URL will download the tar file.  On Mac OS X the tar file will usually be downloaded into the Downloads folder.  You will need to expand the tar files by double-clicking on them, which will create a folder and place the appropriate files into that folder. You will need to move these folders later.
+wxWidgets-3.0.0 (needed only if you are building the BOINC Manager):
 [http://sourceforge.net/projects/wxwindows/files/3.0.0/wxWidgets-3.0.0.tar.bz2/]
 …
 sqlite-3.8.3 (needed  only if you are building the BOINC Manager):
-[http://www.sqlite.org/]
 [http://www.sqlite.org/2014/sqlite-autoconf-3080300.tar.gz]
 curl-7.39.0:
-[http://curl.haxx.se]
 [http://curl.haxx.se/download/curl-7.39.0.tar.gz]
 c-ares-1.10.0 (used by curl):
-[http://daniel.haxx.se/projects/c-ares/]
 [http://c-ares.haxx.se/download/c-ares-1.10.0.tar.gz]
 openssl-1.0.1j:
-[http://www.openssl.org/]
 [http://www.openssl.org/source/openssl-1.0.1j.tar.gz]
 freetype-2.4.10 (needed  only if you are building the BOINC default screensaver or a project screensaver):
-[http://www.freetype.org/]
 [http://sourceforge.net/projects/freetype/files/freetype2/2.4.10/freetype-2.4.10.tar.bz2]
 ftgl-2.1.3~rc5 (needed  only if you are building the BOINC default screensaver or a project screensaver):
-[http://sourceforge.net/projects/ftgl]
 [http://sourceforge.net/projects/ftgl/files/FTGL%20Source/2.1.3%7Erc5/ftgl-2.1.3-rc5.tar.gz]
-(Don't forget to expand the tar files by double-clicking on them.)
 XCode will automatically check compatibility back to OS 10.5 if the following are defined during compilation:
 …
 MAC_OS_X_VERSION_MIN_REQUIRED=1050
 }}}
 These are not done automatically by either the Xcode projects which come with wxWidgets-3.0, nor  the !AutoMake scripts supplied with wxWidgets-3.0, c-ares-1.10.0, curl-7.39.0, openssl-1.0.1j, freetype-2.4.10, ftgl-2.1.3~rc5 and sqlite-3.8.3.  So be sure to use our special scripts to build these packages.
 . 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.
 . Put the following 3 directories inside the BOINC_dev folder (omit any you don't need):
+These are not done automatically by either the Xcode projects which come with wxWidgets-3.0.0, nor  the !AutoMake scripts supplied with wxWidgets-3.0.0, c-ares-1.10.0, curl-7.39.0, openssl-1.0.1j, freetype-2.4.10, ftgl-2.1.3~rc5 and sqlite-3.8.3.  So be sure to use our special scripts to build these packages.
+. Make sure you are logged into the Mac using an account with administrator privileges.  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.
+. Move the following 7 directories from the Downloads folder into the BOINC_dev folder (omit any you don't need):
 {{{
 c-ares-1.10.0
 curl-7.39.0
 openssl-1.0.1j
 wxWidgets-3.0
+wxWidgets-3.0.0
 freetype-2.4.10
 ftgl-2.1.3~rc5
 …
  Important: do not change the names of any of these 6 directories.
+. Get the BOINC source tree from the repository, and put it in the same BOINC_dev folder. To do this, type the following in Terminal:
+. If you have not yet done so, install Xcode and launch it once to accept the license agreement and complete the installation.
+. Get the BOINC source tree from the repository, and put it in the same BOINC_dev folder. To do this, type the following in Terminal:
 {{{
 cd {path}/BOINC_dev/
 …
  (You may change the name of the `boinc` directory to anything you wish.)
+If the above method does not work try the following alternate method:
+{{{
+git clone git://boinc.berkeley.edu/boinc-v2.git boinc
+}}}
 The command above retrieves the source code from the HEAD / MASTER (TRUNK) or development branch of the git repository.  See more information on [SourceCodeGit getting the BOINC source code].
 . Run the script to build the c-ares, curl, openssl, wxWidgets, freetype, ftgl and sqlite3 libraries as follows:
+. Run the script to build the c-ares, curl, openssl, wxWidgets, freetype, ftgl and sqlite3 libraries as follows:
 {{{
 cd {path}/BOINC_dev/boinc/mac_build/
 …
  '''Note 1:''' Be sure to run the script using the `source` command.  Do not double-click on the scripts or use the `sh` command to run them.
  '''Note 2:''' this script tries to build all six third-party libraries: wxWidgets-3.0, c-ares-1.10.0, curl-7.39.0, openssl-1.0.1j,  freetype-2.4.10, ftgl-2.1.3~rc5 and sqlite-3.8.3.  when the script finishes, it will display a warning about any libraries it was unable to build (for example, if you have not downloaded them.)
  '''Note 3:''' The path must not contain any space characters.
  '''Hint:''' you don't need to type the path to a file or folder into Terminal; just drag the file or folder icon from a Finder window onto the Terminal window.
 . Build BOINC as follows:
+ '''Note 2:''' This script tries to build all seven third-party libraries: wxWidgets-3.0.0, c-ares-1.10.0, curl-7.39.0, openssl-1.0.1j,  freetype-2.4.10, ftgl-2.1.3~rc5 and sqlite-3.8.3.  When the script finishes, it will display a warning about any libraries it was unable to build (for example, if you have not downloaded them.) To make it easier to find the error messages, clear the Terminal display and run the script again without -clean.
+ '''Note 3:''' The {path} must not contain any space characters.
+ '''Hint:''' You don't need to type the path to a file or folder into Terminal; just drag the file or folder icon from a Finder window onto the Terminal window.
+. Build BOINC as follows:
  BOINC itself is built using the '''boinc.xcodeproj''' file.  You can either build directly in XCode (more information below) or run the '''BuildMacBOINC.sh''' script:
 …
           build all targets (i.e. target 'Build_All' -- this is the default)
       -lib::
           build the five libraries: libboinc_api.a, libboinc_graphics_api.a, libboinc.a, libboinc_opencl.a, jpeglib.a
+          build the six libraries: libboinc_api.a, libboinc_graphics_api.a, libboinc.a, libboinc_opencl.a, libboinc_zip.a, jpeglib.a
       -client::
           build two targets: BOINC client and command-line utility [http://boinc.berkeley.edu/wiki/Boinccmd_tool boinccmd] (also builds libboinc.a, since boinc_cmd requires it.)
 Both -lib and -client may be specified to build seven targets (no BOINC Manager or screensaver.)
+Both -lib and -client may be specified to build eight targets (no BOINC Manager or screensaver.)
 '''Note 1: boinc.xcodeproj''' in the `BOINC_dev/boinc/mac_build/` directory builds BOINC.  It can be used either with the BuildMacBOINC.sh script or as a stand-alone project.  The ''Development'' build configuration builds only the native architecture and is used for debugging.  The ''Deployment'' build configuration builds a universal binary and is suitable for release builds.  If there are any other build configurations, they should not be used as they are obsolete.
 …
 == Installing and setting up Xcode ==
+Versions of Xcode prior to Xcode 4.3 have an installer package. After downloading Xcode, mount the disk image file by double-clicking on it, then double-click the installer package.
+Starting with Xcode 4.3, the disk image contains a copy of Xcode itself.  After mounting the disk image, drag the Xcode icon to the folder where you wish it to reside.  In most cases, this will be the `/Applications/` folder.  Unmount the disk image by dragging it to the trash.  Finally, double-click on the installed Xcode icon to run Xcode.  Xcode will display a dialog allowing you to finish the installation; you must do this before running BOINC's build scripts.  (Some versions of Xcode may not display this dialog until you open a file with Xcode.)
+If Xcode is obtained from the Apple Store then it will be installed automatically into the Applications folder.  Double-click on the installed Xcode icon to run Xcode.  Xcode will display a dialog allowing you to finish the installation; you must do this before running BOINC's build scripts.  (Some versions of Xcode may not display this dialog until you open a file with Xcode.)