perldist_strawberry - Build strawberry-perl-like distribution for MS Windows
This script is used by Strawberry Perl [http://strawberryperl.com] project for building release packages (MSI, MSM, ZIP, portable/ZIP).
To build strawberry-perl-like distribution you will need to prepare a build environment:
Install any version of Strawberry Perl 5.12.x (or higher)
We recommend using portable edition. BEWARE You'll need to install Strawberry Perl to a directory OTHER THAN C:\strawberry.
Install Perl::Dist::Strawberry module
Take this module either from CPAN or the latest version from SVN [http://svn.ali.as/cpan/trunk/Perl-Dist-Strawberry/]
Install Windows Installer XML (WiX) toolset
We recommend using version 3.5. Download WiX from [http://wix.sourceforge.net]. No need to install WiX via MSI installer, you can only download/unpack ZIPped WiX binaries and use option -wixbin_dir=(dirname).
-wixbin_dir=(dirname)
The build process can be launched by:
c:\> perldist_strawberry -job "<dist_sharedir>/32bit-5.14.2.1.pp" or c:\> perldist_strawberry -job "<dist_sharedir>/64bit-5.14.2.1.pp"
The whole build process uses only 2 directories:
c:\strawberry c:\strawberry_build
Check options -image_dir and -working_dir to change the defaults.
-image_dir
-working_dir
The results of the build process (*.MSI, *.MSM, *.ZIP) can be found in:
c:\strawberry_build\output
If you are about to try to build your own distribution you probably want to create a new job desription file (e.g. by cloning any of share/*.pp files distributed with this module).
Then you will run:
c:\> perldist_strawberry -job c:\buildperl\myperl-32bit.pp
When debugging your own build you should investigate some of the additional options e.g. -restorepoints, -verbosity etc.
-restorepoints
-verbosity
filename sould contain build job description, you can use placeholder '<dist_sharedir>' to choose predefined jobs which are distributed with this module (check 'share' folder in this module tarball)
default: c:\strawberry (BEWARE: dir will be destroyed during build!!)
default: c:\strawberry_build
default: autodetect WiX toolkit install directory
default: http://cpan.strawberryperl.com (or use local mirror e.g. file://C|/cpanmirror/)
default: http://strawberryperl.com/package/ (or use local mirror e.g. file://C|/pkgmirror/)
flag - default: 1 (0 = skip tests when installing perl modules)
flag - default: 0 (0 = skip tests when installing perl core)
level - default: 3 (you can use values 1/silent to 5/verbose)
flag - default: 1 (0 = no interactive questions)
flag - default: 0 (1 = create restorepoint after each finished step, in the next run you will be offered to continue from any of the saved restorepoints)
flag - default: 0 (1 = internet connection unavailable during build)
flag - default: 0 (1 = build perl core with debug enabled)
Show this usage info.
2011+ KMX, <kmx@cpan.org>
2009-2011 Curtis Jewell, <csjewell@cpan.org>
2007-2009 Adam Kennedy, <adamk@cpan.org>
This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
To install Perl::Dist::Strawberry, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Perl::Dist::Strawberry
CPAN shell
perl -MCPAN -e shell install Perl::Dist::Strawberry
For more information on module installation, please visit the detailed CPAN module installation guide.