NAME

Mac::QuickBundle - build Mac OS X bundles for Perl scripts

SYNOPSIS

Either use quickbundle.pl, or

    my $cfg = Config::IniFiles->new( -file => 'file.ini' );

    build_application( $cfg );

See "CONFIGURATION" for a description of the configuration file.

    [application]
    name=MyFilms
    dependencies=myfilms_dependencies
    main=bin/myfilms
    languages=<<EOT
    myfilms_default
    myfilms_italian
    EOT

    [myfilms_default]
    language=default
    name=MyFilms
    version=0.02

    [myfilms_italian]
    language=it
    copyright=Copyright 2011 Mattia Barbon

    [myfilms_dependencies]
    scandeps=myfilms_scandeps

    [myfilms_scandeps]
    script=bin/myfilms
    inc=lib

CONFIGURATION

application

Contains some meta-information about the bundle, and pointers to other sections.

name

The name of the application bundle.

version

Application version.

icon

Application icon (in .icns format).

main

The file name of the main script, copied to Contents/Resources/Perl-Scripts/main.pl.

script

Additional script files, copied to Contents/Resources/Perl-Scripts/<scriptname>.

dependencies

List of sections containing dependency information, see "dependencies".

languages

List of sections containing language information, see "languages".

perlwrapper

Path to PerlWrapper sources, defaults to the PerlWrapper bundled with Mac::QuickBundle.

languages

Each language section contains localized strings used when displaying information about the bundle.

language

ISO 639 language code (es. en, it, ko, ...).

As a special case the default language specifies default keys for the other languages.

name

Short localized application name.

display

Longer localized application name, used by Finder, SpotLight, ...

version

Human-readable version (es. 12.3, 0.02, ...)

copyright

Copyright string (es. Copyright 2011 Yoyodyne corp.)

dependencies

scandeps

List of sections containing configuration for Module::ScanDeps, see "scandeps".

dump

INTERNAL, DO NOT USE

List of dump files, in the format used by Module::ScanDeps and created by Module::ScanDeps::DataFeed.

    perl -MModule::ScanDeps::DataFeed=my.dump <program>

scandeps

script

Path to the script file (optional).

modules

List of additional modules to include (optional).

inc

Additional directories to scan.

cache

Module::ScanDeps cache file path.

compile

If true, run files in compile-only mode and inspects %INC to determine additional dependencies.

execute

Run the script and inspects %INC to determine additional dependencies.

SEE ALSO

Module::ScanDeps

PerlWrapper (created by Christian Renz):

http://svn.scratchcomputing.com/Module-Build-Plugins-MacBundle/trunk https://github.com/mbarbon/mac-perl-wrapper

AUTHOR

Mattia Barbon <mbarbon@cpan.org>

LICENSE

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

SOURCES

The latest sources can be found on GitHub at http://github.com/mbarbon/mac-quickbundle and http://github.com/mbarbon/mac-perl-wrapper