Changes between Version 17 and Version 18 of BuildMacApp

Timestamp:

Apr 3, 2008, 8:28:08 PM (17 years ago)

Author:

charlief

Comment:

--

BuildMacApp

@@ -1 +1 @@
 = Building BOINC Project Applications for Macintosh OS X =
-'''Last updated 4/2/08'''
+'''Last updated 4/3/08'''
 
 This document applies to BOINC libraries 6.1.12 and later.  It has instructions for building science project applications to run under BOINC on Macintosh OSX.  Information for building the BOINC Client and Manager for Macintosh OSX can be found [MacBuild here].
@@ -192 +192 @@
 The elements of our custom Makefile correspond to those described in our script, with one important exception.  Instead of setting the environment variable `MACOSX_DEPLOYMENT_TARGET`, we include in the `CXXFLAGS` one of the following: `-DMAC_OS_X_VERSION_MIN_REQUIRED=1030` (to build a PowerPC application using GCC-3.3), `-mmacosx-version-min=10.4` (to build a 32-bit Intel application using GCC-4.0) or `-mmacosx-version-min=10.5` (to build a 64-bit Intel application using GCC-4.0).
 
+== Upgrading applications for version 6 graphics ==
+
+One of the major changes in BOINC for version 6 is that applications are now expected to generate graphics in a separate executable. The graphics application typically communicates with the worker application using shared memory.
+
+For additional information, please see [milestone:6.0 the 6.0 roadmap] and the [GraphicsApi Graphics API] page.
+
+== Adding a Finder icon to your graphics application ==
+
+There is an optional API `setMacIcon()` in the `libboinc_api.a` library. This allows science graphics applications to display an application icon in the Dock and in the Finder. (The icon does not appear in the Dock until the application displays graphics.) To implement this, do the following:
+
+    * Use '/Developer/Applications/utilities/Icon Composer.app' to create a xxx.icns file. (Use any name you wish instead of xxx.)
+    * Convert the xxx.icns file to an app_icon.h file as follows: in Terminal, run:
+{{{
+{path}/MakeAppIcon_h {source_file_path}/xxx.icns {dest_file_path}/app_icon.h
+}}}
+      (The !MakeAppIcon_h command-line utility is built by the Mac boinc XCode project in the 'boinc/mac_build/build/' directory.) Add the app_icon.h file to your graphics application's project.
+    * In the graphics application's main(), add
+{{{
+#include "app_icon.h" 
+}}}
+      and call:
+{{{
+setMacIcon(argv[0], MacAppIconData, sizeof(MacAppIconData));
+}}}
+    * The graphics application must link with Carbon.framework to use setMacIcon().
+
 == Additional References ==