About Windows Installer, the .NET Framework, and Visual Studio.
Now that WiX v3.6 has been released, I introduce the managed bootstrapper application (MBA) interoperability layer. It’s been available for a while actually, and if you’ve installed any builds of WiX v3.6, or the Microsoft Visual Studio 11.0 Developer Preview you’ve seen it in action.
While Burn – the WiX bootstrapper engine – and the core bootstrapper application interfaces are native and allow you to develop completely native bootstrapper applications, MBA allows managed code developers to utilize their skills to develop rich interactive setups. WPF designers can also utilize their skills to make the setup UI look great. In fact, both of the setup applications mentioned above are written for WPF and running atop the MBA interop layer.
The MBA interop layer leverages COM interoperability features of the CLR, but without requiring previous registration of the assemblies as COM servers as in previous examples. The MBA interop layer is composed of both a native CLR host and the managed framework. It’s in this native CLR host that the managed framework assembly is loaded and COM interfaces marshaled as in-process pointers. Message passing is not required since the Burn engine is written as a free-threaded component. Once the managed framework assembly is loaded, a class factory will create the actual managed bootstrapper application authored in the configuration file and pass its IBootstrapperApplication interface pointers back to the engine.
Because MBA is managed, the .NET Framework is of course required. A simple native bootstrapper application (BA) written atop wixstdba is used to bootstrap the .NET Framework. When you use the WixBalExtension to author your MBA you define the WixMbaPrereqPackageId WixVariable to reference the package ID of the .NET Framework you want to install.
In the following example the .NET Framework 4.0 will be installed if required.
Key="SOFTWARE\Microsoft\Net Framework Setup\NDP\v4\Full"
Key="SOFTWARE\Microsoft\Net Framework Setup\NDP\v4\Full"
DetectCondition="Netfx4FullVersion AND (NOT VersionNT64 OR Netfx4x64FullVersion)" />
You can customize this behavior even more. For example, since WPF was introduced in .NET 3.0, WiX supports a syntax similar to <supportedRuntime> in its own <wix.bootstrapper> section group: <supportedFramework>. This allows you to specify which Framework you require, inferring the CLR version.
type="Microsoft.Tools.WindowsInstallerXml.Bootstrapper.HostSection, BootstrapperCore" />
<supportedFramework version="v4\Client" />
<supportedFramework version="v3.5" />
<supportedFramework version="v3.0" />
<!-- Example only. Replace the host/@assemblyName attribute with
an assembly that implements BootstrapperApplication. -->
<host assemblyName="AssemblyWithClassThatInheritsFromBootstrapperApplication" />
Developers building atop MBA need to only reference the BootstrapperCore.dll assembly in the WiX binaries. We’re working on better documentation, but currently only IntelliSense is included. You can also look at the WiX v3.6 setup UI for an example.
I’ll be talking about the MBA interop layer and MBAs in general over the next few weeks.
$(var.TestUX.TargetDir) is undefined. Where is supposed to come from?
@Ken, the sample authoring is not buildable by itself. It's merely an example of what the authoring looks like, and would require the complete solution to be buildable.
I recommend installing WiX 3.6 and take a look at the src\Setup for a complete example (in the form of the WiX bundle itself).
Unfortunately src\Setup does not exist in my wix 3.6 install. I need a complete example.
You suggested to @Patel that http://wixtoolset.org contains samples of bootstrapper applications. I have looked but not found it there either. Could you please provide a more specific link.
@Ken, installing WiX is necessary to build. You can download the sources from the same site which will have the src\Setup directory.
do i compile that stuff with candle?
Please FTLOG release some tutorials for wpf user interface installers... I have been searching for days wasted only to find 2 random mvvm based incomplete examples and the source code in wix source files not easy to follow so complex... can we get a straight forward basic example that can be made complicated by people that implement it not the training and documentation? Please :)
Seriously though this is not a rant... Wix is very great I am just tired of wasting tmy time trying to make a simple interface to improve our installation experience :) I would think this would be one of your latest greatest wants from the project.
@alex, yes. You build a bundle like you'd build an MSI package. Run candle.exe to get the .wixobj, then pass the .wixobj (and any other .wixobj or .wixlib files you want to link in) to light.exe.
In Wix 3.6, the following bootstrapper.wxs used to display "Our Product Patch 2" in the bootstrapper dialog title:
<Bundle Version="1.1.1" >
<Variable Name='BundleName' Value='Our Product Patch 2' />
<WixVariable Id="WixStdbaLicenseRtf" Value="eula.rtf" />
<WixVariable Id="WixStdbaLogo" Value="Logo.bmp" />
<BootstrapperApplicationRef Id="WixStandardBootstrapperApplication.RtfLicense" />
<MspPackage PerMachine="yes" SourceFile="media\Patch2.msp" />
As of Wix 3.7, it doesn't show up in the title. Instead, it only shows "Setup".
If I add to "Bundle" element, such as,
<Bundle Name='Our Product Patch 2' ...
then it appears not only in the title but also in Add/Remove Program (ARP). We don't want it to appear in ARP.
Is this regression or something I miss?
Thank you in advance.
@Klee, for WiX support please see http://wixtoolset.org.
I am newbie for bootStrapper. i went through your tutorial it looks more simpler so i tried it with my own simple project. but i stuck when generated exe file doesn't started. i have posted this issue in detail on stackover flow too. here is the link.
please help me out.
@Ramesh, support for WiX can be found appropriately on http://wixtoolset.org.