1.23.2006

User Interface Localization in WiX

The latest version of the WiX toolset makes a change that could affect your current compile and link steps. The WiX user interface (WiXUI) files that come with WiX v2.0.3719.0 -- wixui_featuretree.wixlib, wixui_minimal.wixlib, and wixui_mondo.wixlib -- require a localization file to be referenced in at link time. The WiX download includes a U.S. English localization file named WiXUI_en-us.wxl. This is a standard XML file you can edit for other languages.

Using a project named wixdemo as an example, your compile and link steps prior to v2.0.3719.0 might have been:
candle wixdemo.wxs
light -out wixdemo.msi wixdemo.wixobj wixui_mondo.wixlib
Under v2.0.3719.0 the compile (candle) step remains the same but the link must incorporate the localization file using the -loc parameter, like this:
light -out wixdemo.msi wixdemo.wixobj wixui_mondo.wixlib -loc wixui_en-us.wxl
As before, you need to include the <UIRef Id="WixUI" /> element in your WiX source file (which would be wixdemo.wxs in this example) in order to incorporate the WiX user interface into your setup.

No comments: