Using the Extended BA

Add a reference to WixBalExtensionExt.dll in your Visual Studio project and add the namespace reference xmlns:bal="http://schemas.microsoft.com/wix/BalExtension". Note: if you have downloaded the zip file on Windows 7 you may find the assembly is blocked and must be unblock before referencing it.

Add a reference to the new code in your bundle, e.g.:

    <BootstrapperApplicationRef Id="WixExtendedBootstrapperApplication.HyperlinkLicense" />

The three BA are called:

  • HyperlinkLicense
  • Hyperlink2License
  • RtfLicense

The WiX variables that override the default behaviours are:

  • WixExtbaThemeXml
  • WixExtbaThemeWxl
  • WixExtbaLogo
  • WixExtbaLogoSide
  • WixExtbaLicenseUrl
  • WixExtbaLicenseRtfName

Using Auto Versioning

Version="$(bal.Version(1.0))"

This will create a new version number on each build e.g. 1.0.4663.15110, the build number will be days since 1/1/2000 and the revision seconds since midnight divided by two. (Note: the times are based on UTC).

The Examples

Bundle1.wxs
This example demonstrates the HyperlinkLicense UI built in to WixBalExtensionExt.

Bundle2.wxs
This example demonstrates the of an external theme file to create the same UI as Hyperlink2License built in to WixBalExtensionExt.
It also shows the use of two folder selections and radio buttons on the options page.

Bundle3.wxs
This example demonstrates the of an external theme file to create the same UI as Hyperlink2License built in to WixBalExtensionExt.
It also shows the use of radio buttons install page and a textbox on the options page.

Bundle4.wxs
This example demonstrates the of an external theme file to create the same UI as Hyperlink2License built in to WixBalExtensionExt.
It also shows the use of checkboxes on the install and option pages.

Bundle5.wxs
This example demonstrates the RtfLicense UI built in to WixBalExtensionExt.
It also shows how to replace the standard logo with your own.

Bundle6.wxs
This example demonstrates the Hyperlink2License UI built in to WixBalExtensionExt.

Bundle7.wxs
This example demonstrates the HyperlinkLicense UI built in to WixBalExtensionExt.
It also shows how to disable the options page and license link.

Bundle8.wxs
This example demonstrates the HyperlinkLicense UI built in to WixBalExtensionExt.
It also shows how to override the default logo.

Building the Examples

Download the examples and extract to a local folder, run the batch file build.bat in the root folder. These build using the native WiX toolset rather than Visual Studio.

Rebuilding the Source Code

The code should build on any machine with Visual Studio 2010/2012 and WiX 3.7 installed. The extended BA has been renamed to use Ext or Extended in place of Std or Standard but has kept many of the filenames the same so it is easier to merge changes from the WiX standard BA. To build the code either use Visual Studio or run the batch file “build.bat” in the root of the project (this is the preferred method).

Last edited Jan 27, 2013 at 2:11 PM by nsleightholm, version 17

Comments

AlasdairKing Mar 14 at 12:09 PM 
I needed to edit "Build.bat" in the Examples folder to change ..\builds\WixBalExtensionExt.dll to ..\WixBalExtensionExt.dll or I got a light.exe build error. Then it compiled all the examples.

Beekeeper2020 Aug 13, 2013 at 1:51 AM 
The download using the .zip does not download all of the files.
What I did was go to this link: https://wixextba.codeplex.com/SourceControl/latest and then click on the "Source Code" on the left pane, then on the third tab "Download", click on it, it will download the latest source code. For example, in my case, it gives you the option to download the latest wixextba-25382.zip file. After that, do "extract-all" to your folder, then open a Administrator Command Prompt, and cd to that directory. You should be able to run build.bat to build it on command line. See the Web page for the Documentation, it describes exactly how to build it.

Thanks!