mirror of https://github.com/BOINC/boinc.git
260 lines
24 KiB
HTML
260 lines
24 KiB
HTML
<!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.1">
|
||
<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 Helvetica; color: #ff0000; min-height: 14.0px}
|
||
p.p6 {margin: 0.0px 0.0px 0.0px 0.0px; font: 12.0px Courier}
|
||
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 {text-decoration: underline}
|
||
span.s2 {font: 12.0px Lucida Grande}
|
||
</style>
|
||
</head>
|
||
<body>
|
||
<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="p3">Written by Charlie Fenton</p>
|
||
<p class="p3">Last updated 7/1/05</p>
|
||
<p class="p2"><br></p>
|
||
<p class="p4">NOTE: Substitute the appropriate path for [wxpath] and [boincpath] throughout this document.<span class="Apple-converted-space"> </span>Typically, [boincpath] will end in "/boinc" or /boinc_public", and [wxpath] will end in "/wxMac-2.6.0".</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="p5"><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, all BOINC software <b>must</b> be compiled using GCC version 3.3. <span class="Apple-converted-space"> </span></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="p6">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 & 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="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"><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.0 requires 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="p6">export PATH=/usr/local/bin:$PATH</p>
|
||
<p class="p2"><br></p>
|
||
<p class="p4">(1) First download wxMac-2.6.0 from www.wxwidgets.org 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="p6">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="p6">export CPPFLAGS="-DMAC_OS_X_VERSION_MAX_ALLOWED=1030"</p>
|
||
<p class="p2"><br></p>
|
||
<p class="p4">Then continue building wxMac-2.6.0:</p>
|
||
<p class="p2"><br></p>
|
||
<p class="p6">cd [wxpath]</p>
|
||
<p class="p7"><br></p>
|
||
<p class="p6">mkdir osx-build</p>
|
||
<p class="p8"><br></p>
|
||
<p class="p6">cd osx-build</p>
|
||
<p class="p8"><br></p>
|
||
<p class="p6">../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="p6">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="p6">make</p>
|
||
<p class="p2"><br></p>
|
||
<p class="p4">(2) Open a new terminal window to reset your session environment variables and set the working directory:</p>
|
||
<p class="p2"><br></p>
|
||
<p class="p6">cd [boincpath]<span class="Apple-converted-space"> </span></p>
|
||
<p class="p8"><br></p>
|
||
<p class="p4">(3) Create a<span class="Apple-converted-space"> </span>symbolic link [boincpath]/wx_lib pointing to<span class="Apple-converted-space"> </span></p>
|
||
<p class="p4">[wxpath]/osx-build/lib/</p>
|
||
<p class="p2"><br></p>
|
||
<p class="p4">(4) Create a<span class="Apple-converted-space"> </span>symbolic link<span class="Apple-converted-space"> </span>[boincpath]/wxinclude pointing to<span class="Apple-converted-space"> </span></p>
|
||
<p class="p4">[wxpath]/include</p>
|
||
<p class="p2"><br></p>
|
||
<p class="p4">(5) Create a<span class="Apple-converted-space"> </span>symbolic link<span class="Apple-converted-space"> </span>[boincpath]/jpeglib pointing to<span class="Apple-converted-space"> </span></p>
|
||
<p class="p4">your jpeg-6b directory (or whatever directory contains the jpeglib source files).<span class="Apple-converted-space"> </span></p>
|
||
<p class="p2"><br></p>
|
||
<p class="p4">For example, if the boinc, wxMac-2.6.0 directory is at [wxpath] and the jpeg-6b directory is at [jpegpath] then the commands would be:</p>
|
||
<p class="p2"><br></p>
|
||
<p class="p6">ln -s [wxpath]/osx-build/lib wx_lib</p>
|
||
<p class="p8"><br></p>
|
||
<p class="p6">ln -s [wxpath]/include wxinclude</p>
|
||
<p class="p8"><br></p>
|
||
<p class="p6">ln -s [jpegpath] jpeglib</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 & 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">(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 & 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="p6">-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="p6">-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</b></p>
|
||
<p class="p2"><br></p>
|
||
<p class="p4">After creating the <b>deployment</b> build of all targets using Build_All, use the Finder to do the following:</p>
|
||
<p class="p4">(1) In a convenient place on disk, create a directory "Installer_Resources".<span class="Apple-converted-space"> </span>Copy the following items into this directory:</p>
|
||
<p class="p4"><span class="Apple-converted-space"><span class="Apple-converted-tab"> </span></span>[boincpath]/mac_installer/License.rtf</p>
|
||
<p class="p4"><span class="Apple-converted-space"><span class="Apple-converted-tab"> </span></span>[boincpath]/mac_installer/ReadMe.rtf</p>
|
||
<p class="p4"><span class="Apple-converted-space"><span class="Apple-converted-tab"> </span></span>[boincpath]/mac_installer/postinstall</p>
|
||
<p class="p4"><span class="Apple-converted-space"><span class="Apple-converted-tab"> </span></span>[boincpath]/mac_installer/postupgrade</p>
|
||
<p class="p4"><span class="Apple-converted-space"><span class="Apple-converted-tab"> </span></span>[boincpath]/mac_build/build/Postinstall.app</p>
|
||
<p class="p2"><br></p>
|
||
<p class="p4">NOTE: the file extensions (such as .app and .saver) may be hidden by the Finder.<span class="Apple-converted-space"> </span>You can check an item's extension by selecting it in the Finder and using Get Info function from the Finder's File menu.</p>
|
||
<p class="p2"><br></p>
|
||
<p class="p4">(2) Create another directory "Pkg_Root", and inside that create two more directories "Applications" and"Library".<span class="Apple-converted-space"> </span>Create:</p>
|
||
<p class="p4"><span class="Apple-converted-space"> </span>- a "Screen Savers" directory inside your new Library directory,</p>
|
||
<p class="p4"><span class="Apple-converted-space"> </span>- an "Application Support" directory inside your new Library directory,</p>
|
||
<p class="p4"><span class="Apple-converted-space"> </span>- a "BOINC Data" directory inside your new Application Support directory,</p>
|
||
<p class="p4"><span class="Apple-converted-space"> </span>- a "locale" directory inside your new BOINC Data directory <span class="Apple-converted-space"> </span></p>
|
||
<p class="p4">Correct spelling of these names is critical.</p>
|
||
<p class="p2"><br></p>
|
||
<p class="p4">(3) Copy [boincpath]/mac_build/build/BOINCManager.app into your<span class="Apple-converted-space"> </span></p>
|
||
<p class="p4">"Pkg_Root/Applications" directory.</p>
|
||
<p class="p2"><br></p>
|
||
<p class="p4">(4) Copy [boincpath]/mac_build/build/BOINCSaver.saver into your<span class="Apple-converted-space"> </span></p>
|
||
<p class="p4">"Pkg_Root/Library/Screen Savers" directory. <span class="Apple-converted-space"> </span></p>
|
||
<p class="p2"><br></p>
|
||
<p class="p4">(5) Copy the <b>contents</b> <b>of</b> boincpath]/locale/client/ into your<span class="Apple-converted-space"> </span></p>
|
||
<p class="p4">"Pkg_Root/Library/Application Support/BOINC Data/locale" directory.<span class="Apple-converted-space"> </span>(You may optionally exclude the CVS subdirectories to save space.)</p>
|
||
<p class="p2"><br></p>
|
||
<p class="p4">You will now have the following directory structure:</p>
|
||
<p class="p4"><span class="Apple-converted-space"><span class="Apple-converted-tab"> </span></span>Pkg_Root</p>
|
||
<p class="p4"><span class="Apple-converted-space"><span class="Apple-converted-tab"> </span> </span>Applications</p>
|
||
<p class="p4"><span class="Apple-converted-space"><span class="Apple-converted-tab"> </span> </span>BOINCManager.app</p>
|
||
<p class="p4"><span class="Apple-converted-space"><span class="Apple-converted-tab"> </span> </span>Library</p>
|
||
<p class="p4"><span class="Apple-converted-space"><span class="Apple-converted-tab"> </span> </span>Application Support</p>
|
||
<p class="p4"><span class="Apple-converted-space"> </span>BOINC Data</p>
|
||
<p class="p4"><span class="Apple-converted-space"> </span>locale</p>
|
||
<p class="p4"><span class="Apple-converted-space"> </span>de</p>
|
||
<p class="p4"><span class="Apple-converted-space"> </span>en_US</p>
|
||
<p class="p4"><span class="Apple-converted-space"> </span>it</p>
|
||
<p class="p4"><span class="Apple-converted-space"> </span>etc.....</p>
|
||
<p class="p4"><span class="Apple-converted-space"><span class="Apple-converted-tab"> </span> </span>Screen Savers</p>
|
||
<p class="p4"><span class="Apple-converted-space"><span class="Apple-converted-tab"> </span> </span>BOINCSaver.saver</p>
|
||
<p class="p2"><br></p>
|
||
<p class="p4">(6) From the Finder, open [boincpath]/mac_installer/BOINC.pmproj (if running OS 10.3, use BOINC.pmsp).<span class="Apple-converted-space"> </span>it will open in the PackageMaker application.<span class="Apple-converted-space"> </span>In the Files tab, set the path to your Pkg_Root directory.<span class="Apple-converted-space"> </span>in the Resources tab, set the path to your Installer_Resources directory. <span class="Apple-converted-space"> </span>Update the<span class="Apple-converted-space"> </span>version number in multiple places in the Description and Version tabs.</p>
|
||
<p class="p2"><br></p>
|
||
<p class="p4">(7) Select "Create Package" from PackageMaker's File menu.<span class="Apple-converted-space"> </span>You can give any name you wish to the installer package when you create it, but do <b>not</b> change the package name <b>after</b> it is created.</p>
|
||
<p class="p2"><br></p>
|
||
<p class="p4">(8) Quit PackageMaker.</p>
|
||
<p class="p2"><br></p>
|
||
<p class="p3"><b>Package BOINC installer for distribution</b></p>
|
||
<p class="p2"><br></p>
|
||
<p class="p4">(1) Create a directory and name it appropriately, e.g. "boinc_4.37_macOSX".<span class="Apple-converted-space"> </span>Copy the installer package and the ReadMe file into the directory.</p>
|
||
<p class="p2"><br></p>
|
||
<p class="p4">(2)After selecting the directory you just created and populated, select <span class="s1">Create archive</span> from the Finder's File menu.<span class="Apple-converted-space"> </span>This will zip the file.<span class="Apple-converted-space"> </span>(Note: if you want to stuff the file instead of zipping it, be sure to uncheck "stuff originals instead of aliases" in DropStuff's preferences.)</p>
|
||
<p class="p2"><br></p>
|
||
<p class="p4">(3) Rename the zip file as appropriate to show the version number; for example, boinc_4.37_macOSX<span class="s2">.zip</span><span class="Apple-converted-space"> </span></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="p6">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="p6">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="p6">export PROJECTDIR=[setipath]</p>
|
||
<p class="p8"><br></p>
|
||
<p class="p6">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="p6">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="p6">./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="p6">cd [setipath]<span class="Apple-converted-space"> </span></p>
|
||
<p class="p6">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="p6">MakeAppIcon_h <source_file> <dest_file><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="p6">#include "app_icon.h"<span class="Apple-converted-space"> </span></p>
|
||
<p class="p4">and call:</p>
|
||
<p class="p6"><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>
|