Perl::Dist::WiX::DirectoryTree2 - Base directory tree for Perl::Dist::WiX.
This document describes Perl::Dist::WiX::DirectoryTree2 version 1.250.
$tree = Perl::Dist::WiX::DirectoryTree2->instance(); # See each method for examples.
This is an object that represents the main directory tree for the installer. This tree contains all directories being created that are referenced in more than one fragment, and all directories that need to have specific IDs.
my $tree = Perl::Dist::WiX::DirectoryTree2->new( app_dir => 'C:\strawberry', app_name => 'Strawberry Perl' );
Creates new directory tree object and creates the 'root' of the tree.
Note that this object is a MooseX::Singleton object, so that you can retrieve the object at any time using the instance() method.
instance()
This is set to the distribution's image_dir (where the distribution is going to be installed by default.)
This is set to the name of the distribution, and is used to set the name of the Start Menu directory containing the distribution's icons.
my $tree = Perl::Dist::WiX::DirectoryTree2->instance();
Returns the previously created directory tree.
my $directory_object = $tree->get_root();
Gets the Perl::Dist::WiX::Tag::Directory object at the root of the tree.
my $string = $tree->as_string();
This method returns an XML representation of the directory tree.
$tree->initialize_tree($perl_version, $bits, $gcc_version);
Adds a basic directory structure to the directory tree object.
$tree->initialize_short_tree();
This is used when including a merge module that already contains a Perl::Dist::WiX-based perl distribution.
$tree->add_directory($directory);
Adds a directory to the tree, including all directories required along the way.
$self->add_root_directory('Id', 'directory');
Adds a directory entry with the ID and directory name given immediately under the main installation directory.
$tree->add_merge_module('C:\strawberry', $mergemodule_object);
This method inserts a merge module (referred to by a Perl::Dist::WiX::Tag::MergeModule object) into the directory tree at the specified directory.
Calls Perl::Dist::WiX::Directory's search_dir routine on the root directory with the parameters given.
Checks a cache of successful searches if descend and exact are both 1.
See Perl::Dist::WiX's DIAGNOSTICS section for details, as all diagnostics from this module are listed there.
Bugs should be reported via:
1) The CPAN bug tracker at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Perl-Dist-WiX if you have an account there.
2) Email to <bug-Perl-Dist-WiX@rt.cpan.org> if you do not.
For other issues, contact the topmost author.
Curtis Jewell <csjewell@cpan.org>
Perl::Dist, http://ali.as/, http://csjewell.comyr.com/perl/
Copyright 2009 - 2010 Curtis Jewell.
This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
The full text of the license can be found in the LICENSE file included with this module.
To install Perl::Dist::WiX, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Perl::Dist::WiX
CPAN shell
perl -MCPAN -e shell install Perl::Dist::WiX
For more information on module installation, please visit the detailed CPAN module installation guide.