13.3.1 The configuration file

First create a file my-configuration.lisp containing the settings you want in your saved image. You may want to change some of the pre-configured settings shown in config/configure.lisp, add customizations from the rest of this chapter, or load your application code.

13.3.2 The save-image script

Now create a save-image script which is a file save-image.lisp containing something like:

(in-package "CL-USER")

(load-all-patches)

(load #-mswindows "/tmp/my-configuration.lisp"

      #+mswindows "C:/temp/my-configuration.lisp")

#+:cocoa

(compile-file-if-needed

 (sys:example-file

  "configuration/macos-application-bundle")

 :load t)

(save-image #+:cocoa

            (write-macos-application-bundle

             "/Applications/LispWorks 7.0/My LispWorks.app")

            #-:cocoa "my-lispworks")

The script shown loads my-configuration.lisp from a temporary directory. You may need to modify this.

13.3.3 Save your new image

The simplest way to save your new image is to use the Application Builder tool in the LispWorks IDE. Start the Application Builder as described in the LispWorks IDE User Guide , enter the path of your save-image script in the Build script: pane, and press the Build the application using the script button.

Alternatively you can run LispWorks in a command interpreter and pass your save-image script in the command line as shown below.

• On Macintosh, run in Terminal.app:

mymac$ "/Applications/LispWorks 7.0/LispWorks.app/Contents/MacOS/lispworks-7-0-0-macos-universal" -build save-image.lisp

Your new application bundle is saved in /Applications/LispWorks 7.0/My LispWorks.app

• On Microsoft Windows, run in a MS-DOS window:

C:\temp\>"C:\Program Files\LispWorks\lispworks-7-0-0-x86-win32.exe" -build save-image.lisp

Your new LispWorks image is saved in C:\temp\my-lispworks.exe.

• On Linux, run in a shell:

linux:/tmp$ lispworks-7-0-0-x86-linux -build save-image.lisp

Your new LispWorks image is saved in /tmp/my-lispworks.

For other platforms and for 64-bit LispWorks the image name varies from that shown, but the principle is the same.

13.3.4 Use your new image

Your new LispWorks image contains the settings you specified in my-configuration.lisp pre-loaded.

You can add further customizations on start up via the initialization files mentioned in Initialization files.

Note that your newly saved image runs itself, not a saved session.

13.3.5 Saving a non-GUI image with multiprocessing enabled

To create an image which does not start the LispWorks IDE automatically, make a save-image script, for example in /tmp/resave.lisp, containing:

(in-package "CL-USER")

(load-all-patches)

(save-image "~/lw-console"

            :console t

            :multiprocessing t

            :environment nil)

Run LispWorks like this to create the new image ~/lw-console:

lispworks-7-0-0-x86-linux -build /tmp/resave.lisp

13.3.6 Code signing in saved images

This section briefly describe when and how LispWorks images are code signed.