InstallAware for Windows Installer
 

Building App-V Packages

InstallAware may build your setups as application virtualization packages targeting App-V 5, beginning with InstallAware version 17. App-V 4.x support has also been available since InstallAware 2012.

Packages built are compatible with App-V client version 5, or App-V client versions 4.x; based on your selection of which type of package to create.

To start the Build App-V Package tool, on the Design tab, in the Tools group, click Virtualization, and choose Build App-V Package.

  1. Enter the full path to the InstallAware project to build as an App-V package in the Select the InstallAware project file field.
  2. Click the Convert button to begin the build process.
  3. In the next few moments, the conversion process merges all your setup scripts and parses project content.
  4. In the Select application(s) to publish dialog, check each entry-point application for the virtualized package. Applications not selected in this dialog may not be directly launched. You must select at least one entry-point application.
  5. Click the Next button to continue.
  6. In the Set App-V package parameters dialog, choose the detailed App-V package creation settings you desire (these settings are described in detail in the following sections).
  7. Click the Browse button to select an output folder for the App-V package to build in the Save converted package to field.
  8. Click Convert to begin the build process.
  9. The tool builds an App-V application virtualization package out of your InstallAware setup project.

The following considerations apply for the build process:

  • All files and registry keys you are installing as part of your existing setup will be built.
  • Since they are supported by App-V technology, shortcuts, environment variables, file types, and services will also be built.
  • The tool will intelligently parse file system and registry paths and attempt to replicate the exact structure found within your installation.
  • Where possible, script variables will be replaced with their literal values, and intelligently resolved to meaningful values.
  • Compiler variables will be substituted with their literal values as found in your InstallAware project file.
  • Conditional compilation (excluding parts of your scripts based on compiler variable values) is not supported.
  • All of your include scripts will be processed.
  • Any conditions on script execution will be ignored.

App-V Package Generation Parameters

Make App-V package compressed

Check this box to compress your App-V package using standard App-V compression.

Enhance virtual application's interaction with local applications

Check this box to improve the virtualization success rates of applications that may depend on existing COM objects on the physical system.

To completely isolate your application from the physical system, ensure this box is not checked. Some applications may require complete isolation for successful virtualization.

Create App-V package deployment MSI file in addition to other package files

Check this box to automatically create an MSI file which will create Start Menu shortcuts for the entry point applications contained inside your App-V package.

Relocate $TARGETDIR$ (full path) to App-V package virtual drive

Check this box to move the main application folder to the App-V package virtual drive, instead of a merged physical-virtual file system folder.

Checking this box may improve the virtualization success rates of applications that need to be completely isolated from the underlying physical system.

App-V Package Publishing Parameters

App-V package name

Indicates the name of your App-V package.

Streaming source to use

Provides the streaming source for your App-V package.

Save converted package to

Indicates the folder where the your App-V package will be built.

App-V Version

Choose whether to target App-V 5 or App-V 4.x clients for your package.

Building App-V Packages from the Command Line

You may also run the Build App-V Package tool from the command line. Every field of the tool has corresponding command line parameters.

The first command line parameter must always be the full path to the InstallAware project file to build (with .MPR file extension). If any of your command line parameters include spaces, remember to enclose them within double quote signs on the command line.

The remainder command line parameters may be provided in any order and are described below.

Parameter Meaning
relocate Relocates $TARGETDIR$ to App-V's virtual Q:\ drive.
compress Compresses the App-V SFT package file.
createmsi Builds an MSI deployment file along with other App-V package files.
localinteraction Relaxes isolation of virtual environment for enhanced COM interop support.
name: Indicates the name of the App-V package.
streamingsource: Provides the streaming source of the App-V package.
publishapp: Comma delimited list of executable file names (without paths) for entry-point applications. Required.
output: App-V package build folder. The specified folder must already exist. Required.
appv5 Target App-V client version 5. If not specified, App-V client versions 4.x are targeted.

If any parameters other than the first command line parameter are specified, the build will begin immediately and non-interactively, even in the case of build errors. This enables the tool to participate in unattended builds, possibly as part of a larger automated build process, such as batch files.

Examples:

ConvertToAppV.exe "C:\my installers\my setup.mpr"  

In the above example, the tool will prepare to build the setup project at the location C:\my installers\my setup.mpr. Because no additional switches have been specified, the actual build will not begin until end-user interaction.

ConvertToAppV.exe "C:\my installers\my setup.mpr" /publishapp:mainapp.exe "/output:c:\my installers\app-v"

In the above example, the tool will immediately build the setup project at the location C:\my installers\my setup.mpr with a single entry point application mainapp.exe, and with the App-V build output placed in folder c:\my installers\app-v. Note that this folder must already exist for the build to succeed.

ConvertToAppV.exe "C:\my installers\my setup.mpr" /publishapp:mainapp.exe,toolapp.exe "/output:c:\my installers\app-v" /relocate /compress /createmsi "/name:Package Name" "/streamingsource:RTSPS://%SFT_SOFTGRIDSERVER%:322/"

In the above example, the tool will immediately build the setup project at the location C:\my installers\my setup.mpr with two published entry point applications mainapp.exe and toolapp.exe, with package name set to My Package, streaming server set to RTSPS://%SFT_SOFTGRIDSERVER%:322/, $TARGETDIR$ relocation for maximum compatibility, an additional MSI file for deployment, and with the compressed App-V build output placed in folder c:\my installers\app-v. Note that this folder must already exist for the build to succeed.

The tool returns the following codes to indicate success/failure:

  • 0: Process completed successfully
  • 1: Invalid or missing command line parameter(s)
  • 2: Error during process