NAME

XML::API::WIX2 - WIX source file generation through an object API

SYNOPSIS

As a simple example the following perl code:

  use XML::API;
  my $m_wxs = new XML::API('doctype' => 'WIX2', 'encoding' => 'UTF-8');

  $m_wxs->Product_open({
    Id => '12345678-1234-1234-1234-123456789012',
    Name => 'Test Package',
    Language => '1033',
    Version => '1.0.0.0',
    Manufacturer => 'Microsoft Corporation',
    });
  $m_wxs->Package({
    Id => '12345678-1234-1234-1234-123456789012',
    Description => 'My first Windows Installer package',
    Comments => 'This is my first attempt at creating a Windows Installer database',
    Manufacturer => 'Microsoft Corporation',
    InstallerVersion => '200',
    Compressed => 'yes',
    });
  $m_wxs->Media({ Id =>'1', Cabinet => 'product.cab', EmbedCab => 'yes'});
  $m_wxs->Directory_open({ Id => 'TARGETDIR', Name => 'SourceDir'});
  $m_wxs->Directory_open({ Id => "ProgramFilesFolder", Name => "PFiles"});
  $m_wxs->Directory_open({ Id => "TESTFILEPRODUCTDIR", Name => "TFolder", LongName => "TestFolder"});
  $m_wxs->Component_open({ Id => 'License', Guid => '12345678-1234-1234-1234-123456789012'});
  $m_wxs->File({ Id => "License", Name => "License.rtf", DiskId => "1", Source => "License.rtf"});
  $m_wxs->Component_close();
  $m_wxs->Directory_close();
  $m_wxs->Directory_close();
  $m_wxs->Directory_close();
  $m_wxs->Feature_open({ Id => 'License', Title => 'License files', Level => '1'});
  $m_wxs->ComponentRef({ Id => 'License' });
  $m_wxs->Feature_close();
  $m_wxs->Property({Id => "WIXUI_INSTALLDIR", Value => "TESTFILEPRODUCTDIR"});
  $m_wxs->UIRef({Id => "WixUI_Mondo"});
  $m_wxs->Product_close();
  $m_wxs->_print;

will produce the following nicely rendered output:

  <?xml version="1.0" encoding="UTF-8" ?>
  
  <Wix xmlns="http://schemas.microsoft.com/wix/2003/01/wi">
    <Product Id="12345678-1234-1234-1234-123456789012" Language="1033" Manufacturer="Microsoft Corporation" Name="Test Package" Version="1.0.0.0">
      <Package Comments="This is my first attempt at creating a Windows Installer database" Compressed="yes" Description="My first Windows Installer package" Id="12345678-1234-1234-1234-123456789012" InstallerVersion="200" Manufacturer="Microsoft Corporation" />
      <Media Cabinet="product.cab" EmbedCab="yes" Id="1" />
      <Directory Id="TARGETDIR" Name="SourceDir">
        <Directory Id="ProgramFilesFolder" Name="PFiles">
          <Directory Id="TESTFILEPRODUCTDIR" LongName="TestFolder" Name="TFolder">
            <Component Guid="12345678-1234-1234-1234-123456789012" Id="License">
              <File DiskId="1" Id="License" Name="License.rtf" Source="License.rtf" />
            </Component> <!-- Guid="12345678-1234-1234-1234-123456789012" Id="License"-->
          </Directory> <!-- Id="TESTFILEPRODUCTDIR" LongName="TestFolder" Name="TFolder"-->
        </Directory> <!-- Id="ProgramFilesFolder" Name="PFiles"-->
      </Directory> <!-- Id="TARGETDIR" Name="SourceDir"-->
      <Feature Id="License" Level="1" Title="License files">
        <ComponentRef Id="License" />
      </Feature> <!-- Id="License" Level="1" Title="License files"-->
      <Property Id="WIXUI_INSTALLDIR" Value="TESTFILEPRODUCTDIR" />
      <UIRef Id="WixUI_Mondo" />
    </Product> <!-- Id="12345678-1234-1234-1234-123456789012" Language="1033" Manufacturer="Microsoft Corporation" Name="Test Package" Version="1.0.0.0"-->
  </Wix> <!-- xmlns="http://schemas.microsoft.com/wix/2003/01/wi"-->

DESCRIPTION

XML::API::WIX2 is a perl object class for creating WIX version 2 source files. The methods of a XML::API::WIX2 object are derived directly from the wix.xsd specification.

At the time of writing the XML valiadation is not implemented in XML::API. So make sure you follow the Wix specifications or the source won't compile.

SEE ALSO

 XML::API and XML::API::XHTML

AUTHOR

R Bernard Davison <rbdavison@cpan.org>

COPYRIGHT AND LICENSE

Copyright (C) 2006 R Bernard Davison <rbdavison@cpan.org>

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.