Missing documentation on how to get the Wix Standard Bootstrapper application WixStandardBootstrapperApplication.Foundation to work

[wixbot]

When a bootstrapper application is built using WixStandardBootstrapperApplication.Foundation, the resulting ba fails to start unless some extra steps are taken. It would be nice if these were properly documented.

I needed to do the following steps in order to make it start:

First, add an extra .wxs file with the following contents:

<?xml version="1.0" encoding="UTF-8"?>
<Wix xmlns="http://schemas.microsoft.com/wix/2006/wi">
    <Fragment>
    <!-- the theme file and localization file need to be added manually -->
    <PayloadGroup Id='CustomTheme'>
      <Payload Name='thm.xml' Compressed='yes' SourceFile='res\theme.xml' />
      <Payload Name='thm.wxl' Compressed='yes' SourceFile='res\1033.wxl' />
    </PayloadGroup>
    <!-- This information appears to be placed in the generated BootstrapperApplicationData.xml file and
    the ba fails if it is not present. -->
    <CustomTable Id='WixStdbaInformation'>
      <Row>
        <Data Column='LicenseUrl'>!(wix.WixStdbaLicenseUrl)</Data>
      </Row>
    </CustomTable>
  </Fragment>
</Wix>

Next, add a reference to the payloadgroup in the main bundle file:

<BootstrapperApplicationRef Id="WixStandardBootstrapperApplication.Foundation">
  <bal:WixStandardBootstrapperApplication
              LicenseUrl=""
              ShowVersion="yes"
              ThemeFile="res\theme.xml"
              LocalizationFile="res\1033.wxl"
              LogoFile="..\Bitmaps\dlgbmp.bmp"
        />
  <PayloadGroupRef Id="CustomTheme" />
</BootstrapperApplicationRef>

It would be desirable to place information about this somewhere in the http://wixtoolset.org/documentation/manual/v3/bundle/wixstdba/ area.

Originally opened by villintehaspam

[wixbot]

*Foundation is internal and used by the other types. It's not necessary to use it when you have a custom theme. We'll update the doc and make sure custom themes are covered.

Release changed from v3.10 to v3.11