Main Site Contents Up Previous Next

Quick Start

You can follow these Quick Start instructions to begin packaging your first script in the shortest time. You should then take the time to browse the documentation, in particular the Project Tree section so that you get a basic idea of the options available in Cava Packager.

Cava Packager currently supports the following flavours of Perl.

Operating System Architectures Versions Threaded Non-Threaded Shared Libperl Static
Mac OS X
Versions 10.4, 10.5, 10.6
Yes No Yes Yes*
glibc 2.5 or greater
Business subscribers
have access to a glibc 2.3
edition providing support
for RHEL3 and RHEL4
Yes Yes Yes Yes*
Microsoft Windows
XP, Vista, 7
amd64 / x64
Yes No Yes No

Mac OS X - Xcode

If you are using Cava Packager on Mac OS X, you will need to have Xcode installed. Cava Packager calls some of the Xcode utilities during packaging.

Starting Cava Packager

The Cava Installer should have installed Menu shortcuts and a desktop icon for your operating system. On Mac OS X you will have dragged the Cava application from the download DMG to your desired location. You can start the Cava Packager GUI using any of these shortcuts or icons.

You can also start the Cava Packager GUI from the command line and optionally pass a path to a project directory to have Cava open the project on startup. This is useful if you wish to create shortcuts that will start Cava Packager with specific projects.


"C:\path to cava\Cava Packager 2.0\bin\cavapackager.exe" --project="C:\Path To Project\Directory"


/path/to/cava/CavaPackager/bin/cavapackager --project=/path/to/project/directory

Mac OS X

"/path/to/cava/Cava" --project="/path/to/my project/directory"

Set Global Preferences

Set your global preferences that will be used as defaults for new Cava Packager Projects by opening the preferences dialog:

File -> Preferences

You should at least set your Perl Options to include a valid supported Perl Executable.

If a Perl was found on your path when Cava Packager first started, this will have been selected as your default perl. You should check that this Perl is compatible with Cava Packager by displaying its properties:

Display properties of selected Perl

The Perl Information Dialog will display details of the Perl. If the Perl cannot be used to build Cava Packager executables, Cava Packager will display warnings.

Create A New Project

Cava Packager requires that you create a project for each script or collection of scripts that you wish to package. To create a new project you can:

File -> Create Project
Use the Create Project toolbar button.

The New Project dialog prompts you to select a type of project

The types of project available will differ depending on your operating system:

Project Type Operating Systems Notes
Windows Application Windows The standard application type for Windows.
Linux Application Linux The standard application type for Linux.
MacOSX App Bundle MacOSX This will build your project as a MacOSX app bundle and is generally used for MacOSX gui applications.
Darwin Executables MacOSX This will build your project with a standard 'unix' like layout and is generally used for non-gui applications.
Import Exported Project Linux
Create a project using a Cava Packager exported project file. You can export an exiting project at any time using the Project Menu -> Export Project option. You may then use the exported file to create a new project. Exported project files are portable across machines and operating systems.
Version 1.3 Project Conversion Windows Allows Windows users to import Cava Packager v1.3 projects.

Cava Packager will request the minimum information needed to create a basic project:

Project Name

The Project Name is used to identify your project and is initially used as the 'Product Name' for your executables. You can change the Product Name that is embedded in the executables later if required.

Project Path

Cava Packager requires an empty directory in which to create your project. Cava Packager will not clear a directory for you - it must already be empty.

First Script

Every standard project packages at least one script as an executable. Select the first script you wish to package.

Scan & Build Project

You can now Scan and Build your project. The Scan will determine which files and libraries to package:

Project -> Scan & Build Project
The Scan & Build Button found on the toolbar and the Build project tree node will start a scan and build of your project.

Project Release

Once a successful build has been completed, distributable files and logs are available in the Project Release tree node.

Depending on your platform, the project files can be dragged to a new location or copied to the clipboard or both. On Windows and Linux a self extracting executable is produced whilst on MacOSX the default distributable is a DMG file. The project release directory can also be copied for use by your own packaging method. Text Scan and Build logs are provided to assist in tracking scan and build issues.

Contents Up Previous Next

Cava Packager Copyright © 2006-2012 Mark Dootson