Using the Wrapper

<< Click to Display Table of Contents >>

RayPack > 7.3 u6 > User Guide > PackWrapper 

Using the Wrapper

Deployment

Once a setup is wrapped, copy all generated files to the chosen deployment tool. Callouts for installation and uninstallation are standardized for all products, regardless of their underlying installation technique.

 

Unattended Installation

To install wrapped applications silently, use the following command line:

 

Deploy-Application.exe Deploy-Application.ps1 

-DeploymentType Install -DeployMode Silent

 

Unattended Uninstallation

To uninstall wrapped applications silently, use the following command line:

 

Deploy-Application.exe Deploy-Application.ps1 

-DeploymentType Uninstall -DeployMode Silent

 

Default Mode (Basic UI)

It is also possible to run Deploy-Application.exe directly. This will by default install the product with a basic GUI that informs the user about the progress:

 

packwrapper-toolkit

 

Customizing the Toolkit

In order to customize install and / or uinstall routines, open Deploy-Application.ps1 within the Advanced View of the PackWrapper or with a text editor (preferably PowerShell editor or any editor with syntax highlighting).

Relevant parts are located around line 152, and they may look like the following:

 

If ($deploymentType -ine 'Uninstall') {

 ##*===============================================

 ##* PRE-INSTALLATION

 ##*===============================================

 [string]$installPhase = 'Pre-Installation'

 

 ## Show Welcome Message

 Show-InstallationWelcome -CheckDiskSpace -PersistPrompt

                 

 ## Show Progress Message

 Show-InstallationProgress

 

 ## <Perform Pre-Installation tasks here>        

 

 ##*===============================================

 ##* INSTALLATION 

 ##*===============================================

 [string]$installPhase = 'Installation'

 

 <YOUR INSTALL SCRIPT>

 

 ##*===============================================

 ##* POST-INSTALLATION

 ##*===============================================

 [string]$installPhase = 'Post-Installation'

 

 ## <Perform Post-Installation tasks here>

 

 ## Display a message at the end of the install

 Show-InstallationPrompt -Message "$appName $appVersion has been successfully installed." -ButtonRightText 'Close' -Icon Information -NoWait 

}

ElseIf ($deploymentType -ieq 'Uninstall')

{

 ##*===============================================

 ##* PRE-UNINSTALLATION

 ##*===============================================

 [string]$installPhase = 'Pre-Uninstallation'

 

 ## Show Welcome Message

 Show-InstallationWelcome 

                 

 ## Show Progress Message

 Show-InstallationProgress

 

 ## <Perform Pre-Uninstallation tasks here>        

 

 ##*===============================================

 ##* UNINSTALLATION

 ##*===============================================

 [string]$installPhase = 'Uninstallation'

 

 <YOUR UNINSTALL SCRIPT>

 

 ##*===============================================

 ##* POST-UNINSTALLATION

 ##*===============================================

 [string]$installPhase = 'Post-Uninstallation'

 

 ## <Perform Post-Uninstallation tasks here>        

}

 

Standard PowerShell functionalities and modules are supported. It is also possible to use the dedicated PowerShell AppDeploymentToolkit module. The module itself is included by default, so there is no need to do any extra action other than calling the required methods. A comprehensive documentation of available methods and examples can be found under the following address:

 

http://psappdeploytoolkit.com