Having developed and tested the program, the next step is to attempt delivery. You will compile the file containing the program source code, and load the fasl and call
deliver in a fresh LispWorks session.
Programs are delivered with the function deliver. This function takes three mandatory arguments. There are also many optional keyword arguments to help Delivery make the smallest image possible, and also control some aspects of the behavior of the runtime that is created.
You can read more about the deliver function in Delivering your Application.
Keywords to the Delivery Function describes all the optional keyword arguments available.
In this example, we use just one of the optional keyword arguments, and of course we provide the mandatory arguments. These are:
You can deliver and run the application in two ways: either use the LispWorks IDE, or use a command shell. This means a DOS command window (on Microsoft Windows), Terminal.app (Mac OS X) or a shell (Unix/Linux etc).
You can use the Application Builder tool in the LispWorks IDE to deliver your application. This performs the same steps as described in Delivering the program using a command shell, but provides a windowing interface which is easier to use.
but you can also start with a complete delivery script such as that shown in Delivering the program using a command shell.
deliver.lisp) that compiles and loads the program, and then calls deliver:
MS-DOS> lispworks-7-1-0-x86-win32.exe -build deliver.lisp
% lispworks-7-1-0-x86-linux -build deliver.lisp
% cd "/Applications/LispWorks 7.1 (32-bit)/LispWorks (32-bit).app/Contents/MacOS"
% ./lispworks-7-1-0-x86-darwin -build deliver.lisp
hello.exeon Microsoft Windows,
Hello.appon Mac OS X, and
helloon Linux and other Unix-like platforms.
deliver.lispto specify a higher level argument in the call to deliver. Try changing it to 5 for the largest effect.
On Mac OS X, if
hcl:create-macos-application-bundle does not do what you need, please see Alternative application bundle creation code for an alternative, but also please inform Lisp Support.
There is another more detailed example later in this manual. This is in Example: Delivering CAPI Othello, and shows how to deliver a small CAPI application. The application is an implementation of the board game Othello.
Further examples with complete code for delivering small applications are supplied in the LispWorks library. See Self-contained examples.
LispWorks Delivery User Guide - 10 Aug 2017