Designer Designer forfor Visual Visual Studio Studio WiX WiX Setup Setup Projects Projects Designer for Visual Studio WiX Setup Projects Designer for Visual Studio WiX Setup Projects Designer for Visual Studio WiX Setup Projects Revised on 5-Apr-16 Copyright © Add-in Express Ltd. All rights reserved. Add-in Express, ADX Extensions, ADX Toolbar Controls, Afalina, AfalinaSoft and Afalina Software are trademarks or registered trademarks of Add-in Express Ltd. in the United States and/or other countries. THIS SOFTWARE IS PROVIDED "AS IS" AND ADD-IN EXPRESS LTD. MAKES NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR IMPLIED. BY WAY OF EXAMPLE, BUT NOT LIMITATION, ADD-IN EXPRESS LTD. MAKES NO REPRESENTATIONS OR WARRANTIES OF MERCHANTABILITY OR FITNESS FOR ANY PARTICULAR PURPOSE OR THAT THE USE OF THE LICENSED SOFTWARE, DATABASE OR DOCUMENTATION WILL NOT INFRINGE ANY THIRD PARTY PATENTS, COPYRIGHTS, TRADEMARKS OR OTHER RIGHTS Add-in Express™ 2 www.add-in-express.com Designer for Visual Studio WiX Setup Projects Table of Contents Table of Contents Designer for Visual Studio WiX Setup Projects .................................. 2 Introduction ......................................................................................... 5 Why WiX Designer? ........................................................................................................................................ 6 System Requirements .................................................................................................................................... 6 Technical Support ........................................................................................................................................... 6 Installing and Activating................................................................................................................................. 6 Activation Basics ......................................................................................................................................................... 6 Setup Package Contents............................................................................................................................................. 7 Solving Installation Problems ...................................................................................................................................... 8 Add-in Express Products ............................................................................................................................... 8 Getting Started .................................................................................... 9 Your First Standard Setup Project .............................................................................................................. 10 Step #1 – Adding a WiX Setup Project ...................................................................................................................... 10 Step #2 – Setup Project File ...................................................................................................................................... 11 Step #3 – Specifying the Target Folder ..................................................................................................................... 12 Step #4 – Application Project Outputs ....................................................................................................................... 13 Step #5 – Creating a Folder Hierarchy and Deploying Files...................................................................................... 14 Step #6 – Creating Registry Entries .......................................................................................................................... 15 Step #7 – Creating the Installer UI ............................................................................................................................ 16 Step #8 – Specifying Custom Actions ....................................................................................................................... 18 Your First Web Setup Project ...................................................................................................................... 20 Step #1 – Adding a WiX Setup Project ...................................................................................................................... 20 Step #2 – Setup Project file ....................................................................................................................................... 21 Step #3 – Specifying the Target Folder ..................................................................................................................... 22 Step #4 – Web Application Project Outputs .............................................................................................................. 24 Step #5 – Creating a Folder Hierarchy and Deploying Files...................................................................................... 24 Step #6 – Creating Registry Entries .......................................................................................................................... 25 Step #7 – Creating the Installer UI ............................................................................................................................ 26 Step #8 – Specifying Custom Actions ....................................................................................................................... 28 How To ............................................................................................. 30 How to add merge module reference to merge module project............................................................... 30 How to add merge module to setup project ............................................................................................... 33 How to make the setup project localizable? .............................................................................................. 35 Localizing the setup project: quick start..................................................................................................................... 35 Behind the scenes ..................................................................................................................................................... 37 Supported and non-supported languages ................................................................................................................. 38 Editing language-specific files ................................................................................................................................... 38 Testing multiple-language installer ............................................................................................................................ 39 Language-specific prerequisites ................................................................................................................................ 40 Add-in Express™ 3 www.add-in-express.com Designer for Visual Studio WiX Setup Projects Table of Contents How to prevent running Install and Uninstall custom actions during upgrade ..................................... 41 Tips and Notes .................................................................................. 42 Web Setup ...................................................................................................................................................... 42 Configuring IIS .......................................................................................................................................................... 42 Prerequisites ................................................................................................................................................. 42 Custom Prerequisites ................................................................................................................................... 45 Bootstrapper folders .................................................................................................................................................. 45 My Prerequisites Dialog ............................................................................................................................................ 45 Bootstrapper package ............................................................................................................................................... 46 Install File .................................................................................................................................................................. 48 System checks .......................................................................................................................................................... 51 Related packages ..................................................................................................................................................... 56 Custom schedules ..................................................................................................................................................... 57 Install Conditions ....................................................................................................................................................... 58 Exit Codes ................................................................................................................................................................. 59 Security ....................................................................................................................................................................