Wix Compiler Extension Tutorial?

Question

I need to create a WiX Extension to handle interacting with the HTTP API (httpapi.dll) so that I can set URLACLs and SSL bindings for a WCF service that is being installed.

As I understand it, I need to create a WiX Compiler Extension, so that I can define an XML grammar (XSD), and then implement a Compiler to turn the XML into records in tables defined in the MSI.

I have most of that up and running, but I am stumped on how to set up my project to use the XsdGen custom tool, and I am sure there are more issues lurking around the corner after that.

Can anyone point me towards a full tutorial that shows how to create a Wix Compiler Extension?

Answer 1

Expecting a full tutorial is a bit optimistic. Writing a wix extension is a very advanced use case that very few people will ever need to do. Instead, you can take a look at the source of all the official extensions in the wix source code.

Answer 2

XsdGen is defined in WixBuild.Common.targets for the WiX build itself; it's not exposed via the "normal" wix.targets. You can run xsdgen.exe in a prebuild event instead.

Answer 3

You might take a look at the extensions in the WiX contrib project. Since they aren't part of the WiX toolset they have the extra steps needed to build the extension.