How to do a custom validation of a selected installation target folder with WiX? - wix

Using WixUI_InstallDir I'm allowing the user to select a target directory for installing an add-in. After the user enters the directory, I would like to check if the chosen installation folder has a parent directory matching a certain name.
The folder of on the of the parents of the installation directory must be SPECIFIED_NAME:
C:/SPECIFIED_NAME/target --> okay
C:/SPECIFIED_NAME/foo/bar/target --> okay
C:/foo/bar/SPECIFIED_NAME/target --> okay
C:/Temp/target --> not okay
Is this possible using WiX 3.x?

You can't do this with pure WixUI_InstallDir, you need to add extra validation of WIXUI_INSTALLDIR property using custom action.
Declare in your code new property FOLDER_IS_OK. It will take values okay/not okay from your example.
Write custom action, which will validate WixUI_InstallDir and write the result to FOLDER_IS_OK. Some information about this: change installer properties in C# custom action
Something like that:
[CustomAction]
public static ActionResult MyPathValidation(Session session)
{
string installDir = session["WIXUI_INSTALLDIR"];
session["FOLDER_IS_OK"] = ValidateInstallDir(installDir);
return ActionResult.Success;
}
public string ValidateInstallDir(string dirName)
{
//TODO
}
Add this custom action to your code, like in Step 1 here: https://wixtoolset.org/documentation/manual/v3/wixdev/extensions/authoring_custom_actions.html
In Wix source code find file WixUI_InstallDir.wxs. Copy whole element <UI Id="WixUI_InstallDir">...</UI> to your code. Change Id value to MyWixUI_InstallDir and link that one in UIRef element in your project.
Edit original block of your MyWixUI_InstallDir
<Publish Dialog="InstallDirDlg" Control="Back" Event="NewDialog" Value="LicenseAgreementDlg">1</Publish>
<Publish Dialog="InstallDirDlg" Control="Next" Event="SetTargetPath" Value="[WIXUI_INSTALLDIR]" Order="1">1</Publish>
<Publish Dialog="InstallDirDlg" Control="Next" Event="DoAction" Value="WixUIValidatePath" Order="2">NOT WIXUI_DONTVALIDATEPATH</Publish>
<Publish Dialog="InstallDirDlg" Control="Next" Event="SpawnDialog" Value="InvalidDirDlg" Order="3"><![CDATA[NOT WIXUI_DONTVALIDATEPATH AND WIXUI_INSTALLDIR_VALID<>"1"]]></Publish>
<Publish Dialog="InstallDirDlg" Control="Next" Event="NewDialog" Value="VerifyReadyDlg" Order="4">WIXUI_DONTVALIDATEPATH OR WIXUI_INSTALLDIR_VALID="1"</Publish>
<Publish Dialog="InstallDirDlg" Control="ChangeFolder" Property="_BrowseProperty" Value="[WIXUI_INSTALLDIR]" Order="1">1</Publish>
<Publish Dialog="InstallDirDlg" Control="ChangeFolder" Event="SpawnDialog" Value="BrowseDlg" Order="2">1</Publish>
To something like that:
<Publish Dialog="InstallDirDlg" Control="Back" Event="NewDialog" Value="LicenseAgreementDlg">1</Publish>
<Publish Dialog="InstallDirDlg" Control="Next" Event="SetTargetPath" Value="[WIXUI_INSTALLDIR]" Order="1">1</Publish>
<Publish Dialog="InstallDirDlg" Control="Next" Event="DoAction" Value="WixUIValidatePath" Order="2">NOT WIXUI_DONTVALIDATEPATH</Publish>
<Publish Dialog="InstallDirDlg" Control="Next" Event="DoAction" Value="MyPathValidation" Order="3">NOT WIXUI_DONTVALIDATEPATH</Publish>
<Publish Dialog="InstallDirDlg" Control="Next" Event="SpawnDialog" Value="InvalidDirDlg" Order="4"><![CDATA[NOT WIXUI_DONTVALIDATEPATH AND WIXUI_INSTALLDIR_VALID<>"1"]]></Publish>
<Publish Dialog="InstallDirDlg" Control="Next" Event="SpawnDialog" Value="InvalidDirDlg" Order="5">FOLDER_IS_OK<>"okay"</Publish>
<Publish Dialog="InstallDirDlg" Control="Next" Event="NewDialog" Value="VerifyReadyDlg" Order="6">WIXUI_DONTVALIDATEPATH OR WIXUI_INSTALLDIR_VALID="1"</Publish>
<Publish Dialog="InstallDirDlg" Control="ChangeFolder" Property="_BrowseProperty" Value="[WIXUI_INSTALLDIR]" Order="1">1</Publish>
<Publish Dialog="InstallDirDlg" Control="ChangeFolder" Event="SpawnDialog" Value="BrowseDlg" Order="2">1</Publish>

Related

How to fix my msi VerifyReadyDlg install button

My msi "install" button in the VerifyReadyDlg returns WelcomeDlg.
Wix toolset 3.11
I made a msi installer which contains several customized UI windows based on WixUI_FeatureTree for customizing WelcomeDlg (including reading registry and showing its status in next dialog).
CustomizedWelcomeDlg
CheckLicenseKeyAndWebsiteDlg
CustomizedLicenseAgreementDlg
VerifyReadyDlg
When I push "install" button on VerifyReadyDlg(not customized), not starting ExecuteSequence but WelcomeDlg (not customized) appears.
How to fix this? Or should I customize VerifyReadyDlg, too?
Perhaps Orca can be used for such "broken" msi UI sequence problem, would you teach me how to troubleshoot seeking its cause?
UI sequence is below.
1
<!--<Publish Dialog="CustomizedWelcomeDlg" Control="Next" Event="NewDialog" Value="CheckLicenseKeyAndWebsiteDlg">
NOT Installed
</Publish>
<Publish Dialog="CustomizedWelcomeDlg" Control="Next" Event="NewDialog" Value="CheckLicenseKeyAndWebsiteDlg">
Installed AND PATCH
</Publish>-->
<Publish Dialog="CheckLicenseKeyAndWebsiteDlg" Control="Next" Event="NewDialog" Value="SetPhysicalPathDlg">
EVALUATIONFLG = 0
</Publish>
<Publish Dialog="CheckLicenseKeyAndWebsiteDlg" Control="Next" Event="NewDialog" Value="CustomizedLicenseAgreementDlg">
EVALUATIONFLG = 1
</Publish>
<Publish Dialog="CustomizedLicenseAgreementDlg" Control="Next" Event="NewDialog" Value="SetPhysicalPathDlg">
CUSTOMIZEDLICENSEACCEPTED = 1
</Publish>
<Publish Dialog="SetPhysicalPathDlg" Control="Next" Event="NewDialog" Value="VerifyReadyDlg">
1
</Publish>
<Publish Dialog="VerifyReadyDlg" Control="Back" Event="NewDialog" Value="SetPhysicalPathDlg" Order="2">
1
</Publish>
<Publish Dialog="SetPhysicalPathDlg" Control="Back" Event="NewDialog" Value="CheckLicenseKeyAndWebsiteDlg" Order="2">
1
</Publish>
<Publish Dialog="CustomizedLicenseAgreementDlg" Control="Back" Event="NewDialog" Value="CheckLicenseKeyAndWebsiteDlg">
1
</Publish>
<Publish Dialog="CheckLicenseKeyAndWebsiteDlg" Control="Back" Event="NewDialog" Value="CustomizedWelcomeDlg" />
<Publish Dialog="CustomizeDlg" Control="Back" Event="NewDialog" Value="CheckLicenseKeyAndWebsiteDlg" Order="2">NOT Installed</Publish>
<Publish Dialog="VerifyReadyDlg" Control="Back" Event="NewDialog" Value="CustomizedWelcomeDlg" Order="3">Installed AND PATCH</Publish>
<UIRef Id="WixUI_FeatureTree" />
<DialogRef Id="CheckLicenseKeyAndWebsiteDlg" />
<DialogRef Id="SetPhysicalPathDlg" />
Below is /l*vx switch log excerpt.
Action 0:58:03: VerifyReadyDlg。Dialog created
MSI (c) (44:B4) [00:58:03:744]: Note: 1: 2727 2:
Action ending. 0:58:04: CustomizedWelcomeDlg。 return value 1。
MSI (c) (44:7C) [00:58:04:137]: Skipping action: MaintenanceWelcomeDlg (condition is false)
MSI (c) (44:7C) [00:58:04:137]: Skipping action: ResumeDlg (condition is false)
MSI (c) (44:7C) [00:58:04:137]: Doing action: WelcomeDlg
After I read Denis Peshkov's Notes: Replacing a standard WelcomeDlg with a custom one.http://www.peshkov.biz/2015/03/replacing-standard-welcomedlg-with.html I added the InstallUISequence section below. Then pushing "install" button works properly to execute sequence. But I still have not understood enough why this turning off the original Welcome Dlg fixed the problem. May I ask you to explain why does it fix?
<InstallUISequence>
<Show Dialog="WelcomeDlg" Before="ProgressDlg" Overridable="no">0</Show>
<Show Dialog="CustomizedWelcomeDlg" Before="ProgressDlg" >NOT Installed OR PATCH</Show>
</InstallUISequence>

'Change' mode of Maintenance Dlg in Wix is disabled

After the installation of the setup, when the user again launches the setup in Maintenance mode, the 'Change' button appears to be disabled. There is a line below this button saying MyTempService has no independently selectable features.
How do I enable it?
My WixUI_Temp.wxs
<Publish Dialog="MaintenanceTypeDlg" Control="ChangeButton" Event="NewDialog" Value="MyInstallDirDlg">1</Publish>
<Publish Dialog="MaintenanceTypeDlg" Control="RepairButton" Event="NewDialog" Value="VerifyReadyDlg">1</Publish>
<Publish Dialog="MaintenanceTypeDlg" Control="RemoveButton" Event="NewDialog" Value="VerifyReadyDlg">1</Publish>
<Publish Dialog="MaintenanceTypeDlg" Control="Back" Event="NewDialog" Value="MaintenanceWelcomeDlg">1</Publish>
Check my answer here to see if you can include a default Wix GUI: https://stackoverflow.com/a/22799031/129130 . I can't test this using this machine, but worth a shot.

How to prevent installation exit dialog from showing when the user has uninstalled? [WiX]

I have made a custom exit dialog for my installer. The problem is that it is shown when the user uninstalls the program, when I would like the default uninstall exit dialog to be shown instead.
My installer code is viewable at Github. I think the relevant code is:
<Publish Dialog="KerkerkruipExitDialog" Control="Finish" Event="EndDialog" Value="Return" Order="999">1</Publish>
<Publish Dialog="VerifyReadyDlg" Control="Back" Event="NewDialog" Value="MaintenanceTypeDlg">1</Publish>
<Publish Dialog="MaintenanceWelcomeDlg" Control="Next" Event="NewDialog" Value="MaintenanceTypeDlg">1</Publish>
<Publish Dialog="MaintenanceTypeDlg" Control="RepairButton" Event="NewDialog" Value="VerifyReadyDlg">1</Publish>
<Publish Dialog="MaintenanceTypeDlg" Control="RemoveButton" Event="NewDialog" Value="VerifyReadyDlg">1</Publish>
<Publish Dialog="MaintenanceTypeDlg" Control="Back" Event="NewDialog" Value="MaintenanceWelcomeDlg">1</Publish>
<Publish Dialog="WelcomeDlg" Control="Next" Event="NewDialog" Value="VerifyReadyDlg">Installed AND PATCH</Publish>
<Publish Dialog="VerifyReadyDlg" Control="Back" Event="NewDialog" Value="WelcomeDlg" Order="2">Installed AND PATCH</Publish>
<InstallUISequence>
<Show Dialog="WelcomeDlg" Before="KerkerkruipWelcomeEulaDlg">Installed AND PATCH</Show>
<Show Dialog="KerkerkruipWelcomeEulaDlg" Before="ProgressDlg">NOT Installed</Show>
<Show Dialog="KerkerkruipExitDialog" OnExit="success" Overridable="yes" />
</InstallUISequence>
<AdminUISequence>
<Show Dialog="KerkerkruipExitDialog" OnExit="success" Overridable="yes" />
</AdminUISequence>
You can have only one exit dialog for success. MSI doesn't let you have different success exit dialogs for different operations like install or uninstall. From the MSI SDK:
Each termination flag (negative value) can be used with no more than one action. Multiple actions can have termination flags, but they must be different flags.

Two PathEdit dialogs in one MSI (error 2343 - Specified path is empty)

I am creating a WiX installer, and I want to allow the user to select the path of the installation directory as well as a data directory. I added two InstallDirDlg's to my code and named one Custom_Dir and the other Custom_DirData.
In Custom_DirData, instead of using the WIXUI_INSTALLDIR property, I use a DATALOCATION property, which is set at the beginning of the installation in an appsearch.
When I run the msi, the Custom_Dir works fine. However, when I get to the Custom_DirData dialog, as soon as I press browse or next, a 2343 error message pops up.
This is what it says in the log:
DEBUG: Error 2343: Specified path is empty.
I can see these properties being set earlier on in the log file:
PROPERTY CHANGE: Adding DATALOCATION property. Its value is 'C:\Remindex Local Data\'.
PROPERTY CHANGE: Adding _BrowseProperty property. Its value is 'C:\Remindex Local Data\'.
So I'm not quite sure what path it's talking about. Just in case you need some extra information, here are three relevant dialogs in the UI code:
<Publish Dialog="Custom_Dir" Control="Back" Event="NewDialog" Value="Custom_Setup">1</Publish>
<Publish Dialog="Custom_Dir" Control="Next" Event="SetTargetPath" Value="[WIXUI_INSTALLDIR]" Order="1">1</Publish>
<Publish Dialog="Custom_Dir" Control="Next" Event="DoAction" Value="WixUIValidatePath" Order="2">NOT WIXUI_DONTVALIDATEPATH</Publish>
<Publish Dialog="Custom_Dir" Control="Next" Event="SpawnDialog" Value="InvalidDirDlg" Order="3"><![CDATA[NOT WIXUI_DONTVALIDATEPATH AND WIXUI_INSTALLDIR_VALID<>"1"]]></Publish>
<Publish Dialog="Custom_Dir" Control="Next" Event="NewDialog" Value="VerifyReadyDlg" Order="4"><![CDATA[(WIXUI_DONTVALIDATEPATH OR WIXUI_INSTALLDIR_VALID="1") AND WixUI_InstallMode = "InstallRemote"]]></Publish>
<Publish Dialog="Custom_Dir" Control="Next" Event="NewDialog" Value="Custom_DirData" Order="5"><![CDATA[(WIXUI_DONTVALIDATEPATH OR WIXUI_INSTALLDIR_VALID="1") AND WixUI_InstallMode = "InstallServer"]]></Publish>
<Publish Dialog="Custom_Dir" Control="ChangeFolder" Property="_BrowseProperty" Value="[WIXUI_INSTALLDIR]" Order="1">1</Publish>
<Publish Dialog="Custom_Dir" Control="ChangeFolder" Event="SpawnDialog" Value="BrowseDlg" Order="2">1</Publish>
<Publish Dialog="Custom_DirData" Control="Back" Event="NewDialog" Value="Custom_Dir">1</Publish>
<Publish Dialog="Custom_DirData" Control="Next" Event="SetTargetPath" Value="[DATALOCATION]" Order="1">1</Publish>
<Publish Dialog="Custom_DirData" Control="Next" Event="DoAction" Value="WixUIValidatePath" Order="2">NOT WIXUI_DONTVALIDATEPATH</Publish>
<Publish Dialog="Custom_DirData" Control="Next" Event="SpawnDialog" Value="InvalidDirDlg" Order="3"><![CDATA[NOT WIXUI_DONTVALIDATEPATH AND WIXUI_INSTALLDIR_VALID<>"1"]]></Publish>
<Publish Dialog="Custom_DirData" Control="Next" Event="NewDialog" Value="VerifyReadyDlg" Order="4">WIXUI_DONTVALIDATEPATH OR WIXUI_INSTALLDIR_VALID="1"</Publish>
<Publish Dialog="Custom_DirData" Control="ChangeFolder" Property="_BrowseProperty" Value="[DATALOCATION]" Order="1">1</Publish>
<Publish Dialog="Custom_DirData" Control="ChangeFolder" Event="SpawnDialog" Value="BrowseDlg" Order="2">1</Publish>
<Publish Dialog="BrowseDlg" Control="OK" Event="DoAction" Value="WixUIValidatePath" Order="3">1</Publish>
<Publish Dialog="BrowseDlg" Control="OK" Event="SpawnDialog" Value="InvalidDirDlg" Order="4"><![CDATA[WIXUI_INSTALLDIR_VALID<>"1"]]></Publish>
Any suggestions would be greatly appreciated.
My problem was the brackets around my [DATALOCATION] property. This is what it should look like:
<Publish Dialog="Custom_DirData" Control="Back" Event="NewDialog" Value="Custom_Dir">1</Publish>
<Publish Dialog="Custom_DirData" Control="Next" Event="SetTargetPath" Value="DATALOCATION" Order="1">1</Publish>
<Publish Dialog="Custom_DirData" Control="Next" Event="DoAction" Value="WixUIValidatePath" Order="2">NOT WIXUI_DONTVALIDATEPATH</Publish>
<Publish Dialog="Custom_DirData" Control="Next" Event="SpawnDialog" Value="InvalidDirDlg" Order="3"><![CDATA[NOT WIXUI_DONTVALIDATEPATH AND WIXUI_INSTALLDIR_VALID<>"1"]]></Publish>
<Publish Dialog="Custom_DirData" Control="Next" Event="NewDialog" Value="VerifyReadyDlg" Order="4">WIXUI_DONTVALIDATEPATH OR WIXUI_INSTALLDIR_VALID="1"</Publish>
<Publish Dialog="Custom_DirData" Control="ChangeFolder" Property="_BrowseProperty" Value="DATALOCATION" Order="1">1</Publish>
<Publish Dialog="Custom_DirData" Control="ChangeFolder" Event="SpawnDialog" Value="BrowseDlg" Order="2">1</Publish>

How to perform validation on Wix UI Edit control

How can i do validation on a wix Edit control and make the Next button be available only if user entered some string (cannot be empty)
<Property Id="BASEKITPATH" Value=" " />
<Control Id="Next" Type="PushButton" X="236" Y="243" Width="56" Height="17" Default="yes" Text="!(loc.WixUINext)">
<Condition Action="disable"><![CDATA[BASEKITPATH = " "]]></Condition>
<Condition Action="enable"><![CDATA[BASEKITPATH <> " "]]></Condition>
</Control>
With the above code, the Next button is becoming ReadOnly when the installer starts, but when i change the text the Next button nothing changes and the Next stays ReadOnly
What seems to be the problem
It's a known limitation of the underlying Windows Installer. It has scenarios like this where the ControlConditions won't work because they don't validate propreties that have changed while the UI is shown.
The typical work around is to use mutually exclusive ControlEvents. One to call SpawnDialog to display a validation error message and one to go to the next applicable dialog.
If somebody looks for example he can find it in the source code of Wix.
Open "WixUI_InstallDir.wxs" and check "InstallDirDlg" Dialog.
Sample from code:
<Publish Dialog="InstallDirDlg" Control="Back" Event="NewDialog" Value="LicenseAgreementDlg">1</Publish>
<Publish Dialog="InstallDirDlg" Control="Next" Event="SetTargetPath" Value="[WIXUI_INSTALLDIR]" Order="1">1</Publish>
<Publish Dialog="InstallDirDlg" Control="Next" Event="DoAction" Value="WixUIValidatePath" Order="2">NOT WIXUI_DONTVALIDATEPATH</Publish>
<Publish Dialog="InstallDirDlg" Control="Next" Event="SpawnDialog" Value="InvalidDirDlg" Order="3"><![CDATA[NOT WIXUI_DONTVALIDATEPATH AND WIXUI_INSTALLDIR_VALID<>"1"]]></Publish>
<Publish Dialog="InstallDirDlg" Control="Next" Event="NewDialog" Value="VerifyReadyDlg" Order="4">WIXUI_DONTVALIDATEPATH OR WIXUI_INSTALLDIR_VALID="1"</Publish>
<Publish Dialog="InstallDirDlg" Control="ChangeFolder" Property="_BrowseProperty" Value="[WIXUI_INSTALLDIR]" Order="1">1</Publish>
<Publish Dialog="InstallDirDlg" Control="ChangeFolder" Event="SpawnDialog" Value="BrowseDlg" Order="2">1</Publish>
Check the "SpawnDialog" event.