Rooba
/
boinc
mirror of https://github.com/BOINC/boinc.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
boinc/doc/mac_build.html

256 lines
22 KiB
HTML
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta http-equiv="Content-Style-Type" content="text/css">
<title></title>
<meta name="Generator" content="Cocoa HTML Writer">
<meta name="CocoaVersion" content="824.11">
<style type="text/css">
p.p1 {margin: 0.0px 0.0px 0.0px 0.0px; text-align: center; font: 14.0px Helvetica}
p.p2 {margin: 0.0px 0.0px 0.0px 0.0px; font: 12.0px Helvetica; min-height: 14.0px}
p.p3 {margin: 0.0px 0.0px 0.0px 0.0px; text-align: center; font: 12.0px Helvetica}
p.p4 {margin: 0.0px 0.0px 0.0px 0.0px; font: 12.0px Helvetica}
p.p5 {margin: 0.0px 0.0px 0.0px 0.0px; font: 12.0px Courier}
p.p6 {margin: 0.0px 0.0px 0.0px 0.0px; font: 12.0px Helvetica; color: #ff0000; min-height: 14.0px}
p.p7 {margin: 0.0px 0.0px 0.0px 0.0px; font: 12.0px Courier; color: #0000ff; min-height: 14.0px}
p.p8 {margin: 0.0px 0.0px 0.0px 0.0px; font: 12.0px Courier; min-height: 14.0px}
span.s1 {font: 12.0px Helvetica}
span.s2 {font: 12.0px Courier}
</style>
</head>
<body>
<p class="p1"><b>Building BOINC Clients on Macintosh OSX</b></p>
<p class="p2"><br></p>
<p class="p3">Written by Charlie Fenton</p>
<p class="p3">Last updated 9/8/05</p>
<p class="p2"><br></p>
<p class="p4">This document has instructions for building BOINC for Macintosh OSX, plus information for building science projects to run under BOINC Macintosh OSX.</p>
<p class="p2"><br></p>
<p class="p1"><b>Building BOINC Manager with embedded Core Client plus libraries libboinc.a and libboinc_graphics_api.a</b></p>
<p class="p2"><br></p>
<p class="p4">Substitute the appropriate path for [boincparent] throughout this document.<span class="Apple-converted-space">  </span>This is the parent directory containing the boinc/ tree.<span class="Apple-converted-space">  </span>If used, the following three directories must also be at the top level of [boincparent]/:</p>
<p class="p4">wxMac-2.6.1/, curl-7.14.0 and jpeg-6b.<span class="Apple-converted-space">  </span>If you wish to keep these directories elsewhere or to give them different names, you can create a UNIX symbolic link to the actual directory using the command, for example:<span class="Apple-converted-space"> </span></p>
<p class="p5">ln -s [realpath] [boincparent]/<span class="s1">wxMac-2.6.1</span></p>
<p class="p2"><br></p>
<p class="p4">(Note that the GNU compiler and linker will <b>not</b> recognize a Macintosh alias created by the Finder.)</p>
<p class="p2"><br></p>
<p class="p4">Throughout this document, [boincpath] is shorthand for [boincparent]/boinc.</p>
<p class="p2"><br></p>
<p class="p4">These directions are for building under OS X version 10.4.x (Tiger) using XCode Developer Tools version 2.0, or OS X version 10.3.9 (Panther) using XCode 1.5. <span class="Apple-converted-space"> </span></p>
<p class="p2"><br></p>
<p class="p4">If you are building under OS 10.4, you must first install XCode's optional Cross-Development SDK for system 10.3.9 from the XCode Tools CD.<span class="Apple-converted-space">  </span>This guarantees that all builds are backward compatible to OS 10.3.9.<span class="Apple-converted-space">  </span>This is not necessary for building under OS 10.3.</p>
<p class="p6"><br></p>
<p class="p4">If you are building with XCode 2.0 under OS 10.4, the default compiler is GCC 4.0.<span class="Apple-converted-space">  </span>Software compiled with GCC 4.0 cannot run on systems earlier than OS 10.3.9.<span class="Apple-converted-space">  </span>To ensure compatibility back to OS 10.3.0, <b>all</b> BOINC software <b>must</b> be compiled using GCC version 3.3, <b>including the WxWidgets and cURL libraries</b>.</p>
<p class="p2"><br></p>
<p class="p4">Beware of using the wrong compiler!<span class="Apple-converted-space">  </span>Apple's release notes for GCC 4.0 say:</p>
<p class="p4"><i>If your application must support versions of Mac OS X prior to 10.3.9, you must not use the GCC 4.0 compiler. Instead, build your project using the GCC 3.3 compiler</i></p>
<p class="p2"><br></p>
<p class="p4">Elsewhere on Apple's web site is the warning:</p>
<p class="p4"><i>Do not link C++ modules compiled with one of these compilers against modules compiled with the other. Even if the modules appear to link correctly, C++ ABI differences may still cause problems that will not manifest themselves until run time.</i></p>
<p class="p2"><br></p>
<p class="p4">The BOINC XCode project is already set up to use GCC 3.3.<span class="Apple-converted-space">  </span>For builds from the command-line under OS 10.4, you must set the environment variables CC and CXX.<span class="Apple-converted-space">  </span>For the bash shell:</p>
<p class="p2"><br></p>
<p class="p5">export CC=/usr/bin/gcc-3.3;export CXX=/usr/bin/g++-3.3</p>
<p class="p2"><br></p>
<p class="p4">To make sure that other XCode projects (such as client science applications) use GCC 3.0, do the following:</p>
<p class="p2"><br></p>
<p class="p4">In the XCode project, select your target under the Groups &amp; Files column.<span class="Apple-converted-space">  </span>Press command-I to open the info window for the target, and select the "Rules" tab.<span class="Apple-converted-space">  </span>Press the "+" at the bottom of the window twice to create two new rules.<span class="Apple-converted-space">  </span>Set one rule for C sources to use GCC 3.3, set the other rule for C++ sources to use GCC 3.3.<span class="Apple-converted-space">  </span>Close the window.<span class="Apple-converted-space">  </span>Repeat this for each target in the project.</p>
<p class="p2"><br></p>
<p class="p4">If you are building under OS 10.3.9, the default compiler is GCC 3.3, so these steps are not necessary (but they won't do any harm).</p>
<p class="p2"><br></p>
<p class="p4">If you are building a science project to run under BOINC Macintosh OSX, be sure to read the last section of this document, titled "Building the BOINC SETI client application."</p>
<p class="p2"><br></p>
<p class="p3"><b>One-Time Setup for BOINC Manager and embedded Core Client</b></p>
<p class="p2"><br></p>
<p class="p4">This section describes building two libraries needed by BOINC: wxWidgets for the Macintosh, wxMac-2.6.1, and curl-7.14.0. <span class="Apple-converted-space"> </span></p>
<p class="p2"><br></p>
<p class="p4"><i>XCode 1.5 installs autoconf version 2.57 and automake 1.63.<span class="Apple-converted-space">  </span>XCode 2.0 installs autoconf 2.59 and automake 1.63.</i><span class="Apple-converted-space">  </span><i>To determine the version number, type "autoconf --version" or "automake --version" .<span class="Apple-converted-space">  </span>Building wxMac-2.6.1 and curl-7.14.0 require autoconf 2.59 and automake 1.93 or later.<span class="Apple-converted-space">  </span>Building the BOINC SETI application also requires these.</i></p>
<p class="p2"><i></i><br></p>
<p class="p4"><i>Upgrades for autoconf and automake are available from www.gnu.org.<span class="Apple-converted-space">  </span>XCode installed these utilities in the /usr/bin/ directory, but the upgrades by default will install in /usr/local/bin/.<span class="Apple-converted-space">  </span>If you install there, you must also set your PATH environment variable to include that location before proceeding with any of the steps below; type the following at the start of your terminal session:</i></p>
<p class="p2"><i></i><br></p>
<p class="p5">export PATH=/usr/local/bin:$PATH</p>
<p class="p2"><br></p>
<p class="p4">The wxWidgets library is needed only by the BOINC Manager.<span class="Apple-converted-space">  </span>If you are not building the BOINC Manager, you can skip ahead to step 2 below.</p>
<p class="p2"><br></p>
<p class="p4">(1) First download wxMac-2.6.1 from www.wxwidgets.org into your [boincparent]directory and build it:</p>
<p class="p4">You will need to set the environment variables CPPFLAGS and LDFLAGS as described below.<span class="Apple-converted-space">  </span>These commands are for the bash shell; use the equivalent commands if you are running a different UNIX shell.<span class="Apple-converted-space">  </span>Some of these environment variables allow the application to be built using the OS 10.3.9 compatibility SDK.</p>
<p class="p7"><br></p>
<p class="p4">First set the CPPFlags environment variable. If you are building under OS 10.4:</p>
<p class="p8"><br></p>
<p class="p4">If you have installed autoconf or automake at this path:</p>
<p class="p5">export PATH=/usr/local/bin:$PATH</p>
<p class="p8"><br></p>
<p class="p5">export CPPFLAGS="-isysroot /Developer/SDKs/MacOSX10.3.9.sdk -DMAC_OS_X_VERSION_MAX_ALLOWED=1030";export CC=/usr/bin/gcc-3.3;export CXX=/usr/bin/g++-3.3</p>
<p class="p2"><br></p>
<p class="p4">If you are building under OS 10.3:</p>
<p class="p2"><br></p>
<p class="p5">export CPPFLAGS="-DMAC_OS_X_VERSION_MAX_ALLOWED=1030"</p>
<p class="p2"><br></p>
<p class="p4">Then continue building wxMac-2.6.1:</p>
<p class="p2"><br></p>
<p class="p4"><span class="s2">cd </span>[boincparent]/wxMac-2.6.1</p>
<p class="p7"><br></p>
<p class="p5">mkdir osx-build</p>
<p class="p8"><br></p>
<p class="p5">cd osx-build</p>
<p class="p8"><br></p>
<p class="p5">../configure --disable-shared --with-opengl --disable-webkit</p>
<p class="p8"><br></p>
<p class="p4">If you are building under OS 10.4, set the LDFlags environment variable <b>after</b> the configure but <b>before</b> the make:</p>
<p class="p5">export LDFLAGS="-isysroot /Developer/SDKs/MacOSX10.3.9.sdk -Wl,-syslibroot,/Developer/SDKs/MacOSX10.3.9.sdk"</p>
<p class="p8"><br></p>
<p class="p5">make</p>
<p class="p2"><br></p>
<p class="p4">(2) The cURL library is needed only by the BOINC Core Client.<span class="Apple-converted-space">  </span>If you are not building either the BOINC Manager or the Core Client, you can skip ahead to step 3 below (The BOINC Manager includes the Core Client in its application bundle).</p>
<p class="p2"><br></p>
<p class="p4">Download curl-7.14.0 from http://curl.haxx.se/download.html into your [boincparent] directory. <span class="Apple-converted-space"> </span></p>
<p class="p2"><br></p>
<p class="p4">Open a new terminal window to reset your session environment variables and set the working directory:</p>
<p class="p2"><br></p>
<p class="p4">f you have installed autoconf or automake at this path:</p>
<p class="p5">export PATH=/usr/local/bin:$PATH</p>
<p class="p8"><br></p>
<p class="p5">export CC=/usr/bin/gcc-3.3;export CXX=/usr/bin/g++-3.3</p>
<p class="p4"><span class="s2">cd </span>[boincparent]/curl-7.14.0</p>
<p class="p2"><br></p>
<p class="p5">./configure --enable-shared=NO</p>
<p class="p8"><br></p>
<p class="p4">If you are building under OS 10.4, set the CPPFlags and LDFlags environment variables <b>after</b> the configure but <b>before</b> the make:</p>
<p class="p5">export CPPFLAGS="-isysroot /Developer/SDKs/MacOSX10.3.9.sdk"</p>
<p class="p5">export LDFLAGS="-isysroot /Developer/SDKs/MacOSX10.3.9.sdk -Wl,-syslibroot,/Developer/SDKs/MacOSX10.3.9.sdk"</p>
<p class="p8"><br></p>
<p class="p5">make</p>
<p class="p2"><br></p>
<p class="p4">This will create the static library at [boincparent]/curl-7.14.0/lib/.libs/libcurl.a.<span class="Apple-converted-space">  </span>The Finder hides file and directory names which begin with a period, so you must use the Terminal tool to see or manipulate this file.</p>
<p class="p2"><br></p>
<p class="p4">(3) Building the BOINC graphics library libboinc_graphics.a uses jpeglib.h.<span class="Apple-converted-space">  </span>If you aren't building this library, you can skip this step.</p>
<p class="p2"><br></p>
<p class="p4">Download jpeg-6b from www.ijg.org into your [boincparent] directory.<span class="Apple-converted-space">  </span>You don't need to configure or build this library; BOINC only uses the jpeglib.h header file, and expects it to be at the path [boincparent]/ jpeg-6b/jpeglib.h.</p>
<p class="p2"><br></p>
<p class="p3"><b>Building the BOINC Manager with embedded Core Client, plus<span class="Apple-converted-space"> </span></b></p>
<p class="p3"><b>BOINC libraries, screensaver and helper applications</b></p>
<p class="p2"><br></p>
<p class="p4">(1) Double-click on [boincpath]/mac_build/boinc.pbproj to launch the XCode development IDE with the BOINC project.</p>
<p class="p2"><br></p>
<p class="p4">(2) Select the appropriate cross-development sdk as follows:</p>
<p class="p4"><span class="Apple-converted-space"> </span>- select the boinc project icon at the top of the Groups &amp; Files column</p>
<p class="p4"><span class="Apple-converted-space"> </span>- press command-i to open the Project "boinc" info window.</p>
<p class="p4"><span class="Apple-converted-space"> </span>- In the "General" tab, set the popup menu "Cross-Develop Using Target SDK." <span class="Apple-converted-space">  </span>For OS 10.4, select "MacOSX10.3.9.sdk"; for OS 10.3 select "current Mac OS".</p>
<p class="p2"><br></p>
<p class="p4">(3) In the Active Target popup, select mgr_boinc or Build_All.<span class="Apple-converted-space">  </span>Build_All also builds the three libraries libboinc_api.a, libboinc_graphics_api.a and libboinc.a, which are used to build science applications such as SETI@home.<span class="Apple-converted-space">  </span>These libraries are not needed by the BOINC Manager or Core Client.<span class="Apple-converted-space">  </span>In addition, Build_All builds the screensaver BOINCSaver.saver and the installer helper application Postinstall.app.</p>
<p class="p2"><br></p>
<p class="p4">If you wish to build only the libraries, then just build the 3 targets libboinc, gfxlibboinc and api_libboinc.</p>
<p class="p2"><br></p>
<p class="p4">(4) In the Active Build Style popup, choose Development (for debugging) or Deployment (for release builds.)</p>
<p class="p2"><br></p>
<p class="p4">(5) If you have switched Build Style, be sure to do a "Clean All Targets" from the Build menu; otherwise object files from the old build style will not be rebuilt in the new build style.</p>
<p class="p2"><br></p>
<p class="p4">(6) If you are building the screensaver, be sure to unstuff the file:<span class="Apple-converted-space"> </span></p>
<p class="p4">[boincpath]/clientgui/mac/BOINCSaver.nib.sit</p>
<p class="p2"><br></p>
<p class="p4">(7) Select Build from the Build menu.<span class="Apple-converted-space">  </span>I suggest you also open the Detailed Build Results window from the Build menu.<span class="Apple-converted-space">  </span>Wait a long<span class="Apple-converted-space">  </span>time while it compiles.</p>
<p class="p2"><br></p>
<p class="p4">(8) In addition to the BOINC Manager BOINC.app and Core Client boinc, the mgr_boinc target will also build the SystemMenu.bundle framework and a small helper utility SetVersion. <span class="Apple-converted-space"> </span></p>
<p class="p2"><br></p>
<p class="p4">(9) SetVersion is run automatically as part of the build process to update the following Mac version information files using the contents of version.h:</p>
<p class="p4"><span class="Apple-converted-space">  </span>InfoPlist.strings,<span class="Apple-converted-space"> </span></p>
<p class="p4"><span class="Apple-converted-space">  </span>Info.plist (under the resources group)</p>
<p class="p4"><span class="Apple-converted-space">  </span>SystemMenu-Info.plist</p>
<p class="p4"><span class="Apple-converted-space">  </span>ScreenSaver-Info.plist</p>
<p class="p4"><span class="Apple-converted-space">  </span>Installer-Info.plist</p>
<p class="p2"><br></p>
<p class="p4">(10) The boinc-client, SystemMenu.bundle and InfoPlist.strings will all be embedded automatically inside the BOINC.app application bundle as part of the build process.</p>
<p class="p2"><br></p>
<p class="p4">(11) If you wish to run the Core Client under the debugger, you will need to set up the command-line arguments.<span class="Apple-converted-space">  </span>In the Groups &amp; Files column of the XCode project window, select "BOINC_Client" under Executables.<span class="Apple-converted-space">  </span>Then click on the round blue "info" button at the top of the project window to open the info window.<span class="Apple-converted-space">  </span>In the info window's Arguments tab, add the following line to the Argument list:</p>
<p class="p2"><br></p>
<p class="p5">-dir /Library/Application\ Support/BOINC\ Data/</p>
<p class="p8"><br></p>
<p class="p4">Normally, stdio and stderr output will be sent to XCode's console.<span class="Apple-converted-space">  </span>If you want stdio and stderr to be redirected to files as BOINC normally does, add a second line to the Argument list:</p>
<p class="p2"><br></p>
<p class="p5">-redirectio</p>
<p class="p2"><br></p>
<p class="p4">These arguments will be used only when running the BOINC Core Client from XCode using XCode's Run or Debug commands.</p>
<p class="p2"><br></p>
<p class="p2"><br></p>
<p class="p3"><b>Building the installer and packaging it for disribution</b></p>
<p class="p2"><br></p>
<p class="p4">After creating the <b>deployment</b> build of all targets using Build_All, do the following in Terminal. <span class="Apple-converted-space"> </span></p>
<p class="p2"><br></p>
<p class="p4">Set root permission:</p>
<p class="p2"><br></p>
<p class="p4">sudo sh</p>
<p class="p2"><br></p>
<p class="p4">Set the current directory to the root directory of the boinc tree:</p>
<p class="p2"><br></p>
<p class="p5">cd [boincpath]</p>
<p class="p8"><br></p>
<p class="p4">Invoke the release_boinc.sh script with the three parts of version number as arguments.<span class="Apple-converted-space">  </span>For example, if the version is 3.2.1:</p>
<p class="p8"><br></p>
<p class="p5">source mac_installer/release_boinc.sh 3 2 1</p>
<p class="p2"><br></p>
<p class="p4">(This will create a director "BOINC_Installer" in the parent directory of the current directory.<span class="Apple-converted-space">  </span>Inside that will be three directories and two zip files. <span class="Apple-converted-space"> </span></p>
<p class="p2"><br></p>
<p class="p4">If the version is 3.2.1, the zip files will be boinc_3.2.1_macOSX.zip and boinc_3.2.1_powerpc-apple-darwin.zip, and the directories will have the same names as their zipped counterparts.<span class="Apple-converted-space"> </span></p>
<p class="p2"><br></p>
<p class="p4">An additional directory named SymbolTables contains the executables with full debugging symbols; these are useful when interpreting stack dumps in error reports.</p>
<p class="p2"><br></p>
<p class="p2"><br></p>
<p class="p1"><b>BOINC SETI client application</b></p>
<p class="p2"><br></p>
<p class="p3"><b>ONE_TIME SETUP for BOINC SETI client application</b></p>
<p class="p2"><br></p>
<p class="p4"><i>Please see the discussion about versions<span class="Apple-converted-space">  </span>of autconf and automake in the section "ONE_TIME SETUP for BOINC Manager and embedded Core Client" above.<span class="Apple-converted-space">  </span>If you install upgrades for these in /usr/local/bin/, type the following at the start of your terminal session:</i></p>
<p class="p2"><i></i><br></p>
<p class="p5">export PATH=/usr/local/bin:$PATH</p>
<p class="p2"><br></p>
<p class="p4">(1) Open a new terminal window to reset your session environment variables and set the working directory:</p>
<p class="p2"><br></p>
<p class="p5">cd [setipath]<span class="Apple-converted-space"> </span></p>
<p class="p2"><br></p>
<p class="p4">(2) You will need to set some environment variables as described below.<span class="Apple-converted-space">  </span>These commands are for the bash shell; use the equivalent commands if you are running a different UNIX shell. <span class="Apple-converted-space"> </span></p>
<p class="p8"><br></p>
<p class="p5">export PROJECTDIR=[setipath]</p>
<p class="p8"><br></p>
<p class="p5">export BOINCDIR=[boincpath]</p>
<p class="p2"><br></p>
<p class="p4">If your autoconf and automake are in /usr/local/bin/:</p>
<p class="p2"><br></p>
<p class="p5">export PATH=/usr/local/bin:$PATH</p>
<p class="p2"><br></p>
<p class="p4">(2) Run Configure to create the correct config.h file:</p>
<p class="p2"><br></p>
<p class="p4">./_autosetup</p>
<p class="p2"><br></p>
<p class="p5">./configure --disable-server --with-apple-opengl-framework --disable-dynamic-graphics</p>
<p class="p2"><br></p>
<p class="p4">(3) Copy the correct libjpeg.a into [path]/seti_boinc/jpeglib/</p>
<p class="p2"><br></p>
<p class="p4">(4) Create a<span class="Apple-converted-space">  </span>symbolic link [setipath]/boinc pointing to the boinc directory</p>
<p class="p2"><br></p>
<p class="p5">cd [setipath]<span class="Apple-converted-space"> </span></p>
<p class="p5">ln -s [boincpath] ./boinc</p>
<p class="p2"><br></p>
<p class="p3"><b>Building the BOINC SETI client application</b></p>
<p class="p2"><br></p>
<p class="p4">The XCODE project for building the BOINC SETI@home client application is<span class="Apple-converted-space"> </span></p>
<p class="p4">[setipath]/mac_build/seti_boinc.xcode.</p>
<p class="p2"><br></p>
<p class="p4">There is an optional api setMacIcon() in the libboinc_api.a library.<span class="Apple-converted-space">  </span>This allows science applications to display an application icon in the Dock) and in the Finder. <span class="Apple-converted-space">  </span>(The icon does not appear in the Dock until the application displays graphics.)<span class="Apple-converted-space">  </span>To implement this, do the following:</p>
<p class="p2"><br></p>
<p class="p4">(1)Use "/Developer/Applications/utilities/Icon Composer.app" to create a xxx.icns file.<span class="Apple-converted-space">  </span>(Use any name you wish instead of xxx.)</p>
<p class="p2"><br></p>
<p class="p4">(2) Convert the xxx.icns file to an app_icon.h file as follows: in Terminal, run:<span class="Apple-converted-space"> </span></p>
<p class="p5">MakeAppIcon_h &lt;source_file&gt; &lt;dest_file&gt;<span class="Apple-converted-space"> </span></p>
<p class="p4">(The MakeAppIcon_h command-line utility is built by the Mac boinc XCode project iin the "boinc/mac_build/build/" directory.)<span class="Apple-converted-space">  </span>Add the app_icon.h file to your science application's project.</p>
<p class="p2"><br></p>
<p class="p4">(3) In the science application's main(), add<span class="Apple-converted-space"> </span></p>
<p class="p5">#include "app_icon.h"<span class="Apple-converted-space"> </span></p>
<p class="p4">and call:</p>
<p class="p5"><span class="Apple-converted-space">  </span>setMacIcon(argv[0], MacAppIconData, sizeof(MacAppIconData));</p>
<p class="p2"><br></p>
<p class="p4">(4) The science application must link with Carbon.framework to use setMacIcon().</p>
<p class="p2"><br></p>
</body>
</html>
Reference in New Issue View Git Blame Copy Permalink