Bryan,
I have a new how-to topic out for review that covers launching an application
based on a checkbox at the end of setup. I've included the text of it below.
Assuming your installer has UI, you can wire up the action in the same way (to
the Finish button), but simply omit the piece that turns on the checkbox and
the condition for verifying the checkbox.
I hope this helps,
Neil
How To: Run the Installed Application After Setup
Often when completing the installation of an application it is desirable to
offer the user the option of immediately launching the installed program when
setup is complete. This how to describes customizing the default WiX UI
experience to include a checkbox and a WiX custom action to launch the
application if the checkbox is checked.
This how to assumes you have already created a basic WiX project using the
steps outlined in How To: Add a file to your installer.
Step 1: Add the extension libraries to your project
This walkthrough requires WiX extensions for UI components and custom actions.
These extension libraries must must be added to your project prior to use. If
you are using WiX on the command-line you need to add the following to your
candle and light command lines:
-ext WixUIExtension -ext WixUtilExtension
If you are using Votive you can add the extensions using the Add Reference
dialog:
Right click on your project in Solution Explorer and select Add Reference...
Select the WixUIExtension.dll assembly from the list and click Add
Select the WixUtilExtension.dll assembly from the list and click Add
Close the Add Reference dialog
Step 2: Add UI to your installer
The WiX Minimal UI sequence includes a basic set of dialogs that includes a
finished dialog with optional checkbox. To include the sequence in your project
add the following snippet anywhere inside the <Product> element.
<UI>
<UIRef Id="WixUI_Minimal" />
</UI>
To display the checkbox on the last screen of the installer include the
following snippet anywhere inside the <Product> element:
<Property Id="WIXUI_EXITDIALOGOPTIONALCHECKBOXTEXT" Value="Launch My
Application Name" />
The WIXUI_EXITDIALOGOPTIONALCHECKBOXTEXT property is provided by the standard
UI sequence that, when set, displays the checkbox and uses the specified value
as the checkbox label.
Step 3: Include the custom action
Custom actions are included in a WiX project using the <CustomAction> element.
Running an application is accomplished with the WixShellExecTarget custom
action. To tell Windows Installer about the custom action, and to set its
properties, include the following in your project anywhere inside the <Product>
element:
<Property Id="WixShellExecTarget" Value="[#myapplication.exe]" />
<CustomAction Id="LaunchApplication" BinaryKey="WixCA" DllEntry="WixShellExec"
Impersonate="yes" />
The Property element sets the WixShellExecTarget to the location of the
installed application. WixShellExecTarget is the property Id the WixShellExec
custom action expects will be set to the location of the file to run. The Value
property uses the special # character to tell WiX to look up the full installed
path of the keyfile for the component with the id myapplication.exe.
The CustomAction element includes the action in the installer. It is given a
unique Id, and the BinaryKey and DllEntry properties indicate the assembly and
entry point for the custom action. The Impersonate property tells Windows
Installer to run the custom action as the installing user.
Step 4: Trigger the custom action
Simply including the custom action, as in Step 3, isn't sufficient to cause it
to run. Windows Installer must also be told when the custom action should be
triggered. This is done by using the <Publish> element to add it to the actions
run when the user clicks the Finished button on the final page of the UI
dialogs. The Publish element should be included inside the <UI> element from
Step 2, and looks like this:
<Publish Dialog="ExitDialog"
Control="Finish"
Event="DoAction"
Value="LaunchApplication">WIXUI_EXITDIALOGOPTIONALCHECKBOX = 1 and NOT
Installed</Publish>
The Dialog property specifies the dialog the Custom Action will be attached to,
in this case the ExitDialog. The Control property specifies that the Finish
button on the dialog triggers the custom action. The Event property indicates
that a custom action should be run when the button is clicked, and the Value
property specifies the custom action that was included in Step 3. The condition
on the element prevents the action from running unless the checkbox from Step 2
was checked and the application was actually installed (as opposed to being
removed or repaired).
-----Original Message-----
From: [EMAIL PROTECTED] [mailto:[EMAIL PROTECTED] On Behalf Of bryan rasmussen
Sent: Thursday, June 26, 2008 1:12 AM
To: [email protected]
Subject: Re: [WiX-users] how do I start an application after install, not
conditionally and not based on clicking on dialog
Specifically I am trying to do this:
<CustomAction Id="CA1" Property="CA1_PROP"
Value="[AUTOPILOT]AutoPilot.exe" />
<InstallExecuteSequence>
<InstallFinalize/>
<Custom Action="CA1" After="InstallFinalize" />
</InstallExecuteSequence>
How should that be restructured to work?
Thanks,
Bryan Rasmussen
On Thu, Jun 26, 2008 at 9:47 AM, bryan rasmussen
<[EMAIL PROTECTED]> wrote:
> As per the subject line, it's just supposed to install and run. The
> user doesn't have to click on the dialog to say that they want it to
> run.
>
> Thanks,
> Bryan Rasmussen
>
-------------------------------------------------------------------------
Check out the new SourceForge.net Marketplace.
It's the best place to buy or sell services for
just about anything Open Source.
http://sourceforge.net/services/buy/index.php
_______________________________________________
WiX-users mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/wix-users
-------------------------------------------------------------------------
Check out the new SourceForge.net Marketplace.
It's the best place to buy or sell services for
just about anything Open Source.
http://sourceforge.net/services/buy/index.php
_______________________________________________
WiX-users mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/wix-users
