LispWorks User Guide and Reference Manual > 32 The HCL Package

NextPrevUpTopContentsIndex

create-macos-application-bundle

Function
Summary

Creates a Mac OS X application bundle for the running LispWorks image.

Package

hcl

Signature

create-macos-application-bundle target-path &key template-bundle bundle-name signature package-type extension application-icns identifier version build version-string help-book-folder help-book-name document-types executable-name => path

Arguments

target-path

A pathname designator.

template-bundle

A pathname designator.

bundle-name

A string.

signature

A string.

package-type

A string.

extension

A string.

application-icns

A pathname designator.

identifier

A string.

version

A string.

build

A string.

version-string

A string.

help-book-folder

A string.

help-book-name

A string.

document-types

A list or t .

executable-name

t or nil .

Values

path

A pathname.

Description

The function create-macos-application-bundle creates a Mac OS X application bundle for the running LispWorks image, and returns the pathname path in which an image is expected to be saved. If you are saving an image, it is convenient to use save-image-with-bundle.

target-path is where the new bundle is created.

By default create-macos-application-bundle uses the application bundle of the current image as a template, and modifies it according to its arguments. If you do not supply of any of the keyword arguments, the only modification is to the actual path.

template-bundle can be supplied to provide a path for an application bundle which will be used as a template. If template-bundle is not supplied, create-macos-application-bundle uses the path of the bundle of the current image. Except when specified, all the other parameters default to their values in the template-bundle .

bundle-name provides CFBundleName. The default value is the name of the last directory component in target-path .

signature is the signature in the PkgInfo file.

version is the version value, CFBundleVersion. If template-bundle is nil, version defaults to the value returned by cl:lisp-implementation-version .

executable-name is the filename of the LispWorks image executable, not including the directory. The default value of executable-name is the pathname name of the last component of target-path .

package-type is the package type, CFBundlePackageType. The default value of package-type is "APPL".

extension is the extension to add to the last component of target-path . The default value of extension is "app", as in "LispWorks.app".

The default value of document-types is t , which means copy them from template-bundle .

create-macos-application-bundle is implemented only in LispWorks for Macintosh.

See also

save-image-with-bundle


LispWorks User Guide and Reference Manual - 22 Dec 2009

NextPrevUpTopContentsIndex