All Manuals > LispWorks Delivery User Guide > 13 Example: Delivering CAPI Othello


13.3 Creating a Mac OS X application bundle

The section applies only to LispWorks for Macintosh with the native Cocoa GUI.

You should not simply run a Mac OS X/Cocoa GUI application from the command line in Instead you should put the image in a suitable Application Bundle and run it using the Finder. The example delivery scripts in this manual create the Application Bundle before writing the executable.

The function hcl:create-macos-application-bundle does several things to construct a suitable Mac OS X application bundle for your delivered image. It:

Note: You must supply identifier to provide CFBundleIdentifier when creating a bundle for your own application.

13.3.1 Example application bundle delivery script

Note how this script calls deliver with the executable path returned by hcl:create-macos-application-bundle:

(in-package "CL-USER")
;; Compile and load othello example code
(compile-file (example-file "capi/applications/othello")
              :output-file :temp
              :load t)
;; Create and deliver the executable inside it
(deliver 'play-othello 
          ;; Do not copy file associations...
          :document-types nil
          ;; ...or CFBundleIdentifier from the LispWorks bundle
          :identifier "com.example.Othello"
         #-:cocoa "~/othello" 0 :interface :capi)

In the session below script.lisp is in the user's home directory. Here is the start and end of the session output in

mymac:/Applications/LispWorks 7.1 (32-bit)/LispWorks (32-bit).app/Contents/MacOS % ./lispworks-7-1-0-x86-darwin -build ~/script.lisp
; Loading text file /Applications/LispWorks 7.1 (32-bit)/Library/lib/7-1-0-0/private-patches/load.lisp
LispWorks(R): The Common Lisp Programming Environment
Copyright (C) 1987-2017 LispWorks Ltd.  All rights reserved.
Version 7.1.0
Saved by LispWorks as lispworks-7-1-0-x86-darwin, at 28 Jun 2014 15:05
User dubya on
; Loading text file /Users/dubya/script.lisp
;  Loading text file /Applications/LispWorks 7.1 (32-bit)/Library/lib/7-1-0-0/private-patches/load.lisp
;;; Compiling file /Applications/LispWorks 7.1 (32-bit)/Library/lib/7-1-0-0/examples/capi/applications/othello ...
;;; Safety = 3, Speed = 1, Space = 1, Float = 1, Interruptible = 1
[... full compilation and delivery output not shown...]
Shaking stage : Saving image
Build saving image: /Users/dubya/Desktop/
Build saved image: /Users/dubya/Desktop/
Delivery successful - /Users/dubya/Desktop/

The last line of the deliver output shows the full path to the executable, but you should run the application bundle via the Finder.

13.3.2 Alternative application bundle creation code

Your LispWorks Library contains example code which constructs a Mac OS X application bundle. It defines write-macos-application-bundle which is similar to hcl:create-macos-application-bundle.

LispWorks 5.1 and earlier versions relied on this example code to create Mac OS X application bundles and you may still wish to use it, or a modified version of it, if hcl:create-macos-application-bundle does not meet your needs. Load the example file in your delivery script, before calling deliver, like this:

 (example-file "configuration/macos-application-bundle")
 :output-file :temp
 :load t)

There is another example, which is actually a save-image script (rather than deliver), in

(example-file "configuration/save-macos-application.lisp")

13.3.3 Further Mac OS X delivery examples

These can be found in your LispWorks library directory:

(example-edit-file "delivery/macos/")

LispWorks Delivery User Guide - 10 Aug 2017