Creating an App-V Package

ImportantThe following article uses options that are available starting with the Architect edition and project type.

This tutorial will guide you step by step through the creation and customization of an Advanced Installer Architect project that produces an App-V 4 or App-V 5 package types.

Let's suppose you want to create a package for a text editor you have created. For this purpose we will use a sample editor applicatio made by us. This editor has some characteristics:

  • For the editor to function properly, some registry keys must be present on the target system.
  • It has a specific file type associated, called EDI.

1. Create project

Start Advanced Installer by selecting it from the “Start” menu. Launching Advanced Installer automatically starts a new installation project. Choose “Installer” > “Architect” as the project type.

Start Page

Save A good idea is to save and name the project at this point. Use the “Save” menu item under the “File” menu or the Ctrl+S keyboard shortcut and let's name it appv.aip.

2. Enter Product Details

Product Details

Please note that these details are completely fictive.

3. Add files and folders to your project

The next step is to add the files and/or folders that compose your application to the project. You will need an EDI file to test the editor's file associations. Since it is a custom type of file, you will have to create it. Use any text editor to create a "foo.txt". Then rename it "foo.edi".

Files and Folders Select “Files and Folders” from the “Resources” menu on the left pane.

Add filesClick on the [ Add Files ] toolbar button and select your application's files, use our Sample Application. Repeat this step to include the Foo.edi file you have created. This way you can add as many files as you want.

Files, Folders and Shortcuts

Once the files are added, their name will appear in the right-side pane. Now let's make a shortcut to the Sample.exe file you just added. Right click on this file and choose “New Shortcut...”. In the newly appeared dialog, choose a name for your shortcut and a location - like in the following screen-shot. Press the OK button and the shortcut will appear listed in the application shortcut folder.

New Shortcut

NoteFor more information please see the Files and Folders page.

4. Add registry keys and values to your package

Let's suppose your application needs two registry entries. These are located in the "Software\[Manufacturer]\[ProductName]\Settings" key.

  • One registry value is named "AppPath" and stores the path where your application is installed.
  • The other one is named "AppSettings" and contains a value that shows your application's current settings. On install, it has the value "0x36".

Registry PageSelect the “Registry” page.

In the tree, select the "Software\[Manufacturer]\[ProductName]" key.

New KeyClick on the [ New Key ] toolbar button to create a key. Edit the key name to "Settings".

New ValueAdd a value for it using the [ New Value ] toolbar button.

In the "Name" text field enter the name of your first key: "AppPath". Use the [ Folder... ] button and select "Application Folder". Since "Data" is a Formatted Type text field, the value that it contains will be expanded at install time into the full path to your application's location.

Use the same steps to create the "AppSettings" value. This time just type in the "Data" field the text "0x36" and select the "Binary" type.

Edit Registry Entry

Once the registry keys and values are added, you can see them in the view's right-side pane.

Registry

NoteFor more information please see the Registry page.

5. Create new file extensions and make file associations

Your application uses files with a particular extension (in our example that is "edi"). You may want to associate that type of files to be opened or edited with your application. Advanced Installer helps you do this in a very simple way.

File AssociationChoose “File Association” from the “Project Details” options group.

New ExtensionUse the [ New Extension ] toolbar button to create a new extension: "edi". In the appropriate field in the right-side pane, enter a description for this extension. You may choose an icon to be displayed for all the files with the extension you created.

File Associations

For every extension contained in your application, you need to add at least one verb. The name of the verb will be seen in the context menu that appears when you right click on a file of "edi" type in Windows Explorer. For this example, you should leave the default settings. The effect is when you double click a file or you choose the "Open" action from a context menu of an "edi" file, the application is automatically launched with the command line argument specifying the absolute path of the chosen file.

Extensions and Verbs

You can add as many verbs as you want for an extension.

NoteFor more information please see the File Associations page.

6. Create an App-V build

Now that you have added resources to your project, it is time to configure your project to create an App-V package containing these resources.

BuildChoose “Build” from the “Package Definition” options group.

Use the [ New App-V 4.x Build ] toolbar button to create a new build of type App-V 4.x. For this tutorial you can leave the default values.

NoteStarting with Advanced Installer 10 you can also create a new [ App-V 5.x Build ].

7. Build and Install

You are now ready to test your program. Right-click the AppV build in left tree and select [ Build ] from context menu. This will only build the AppV package and not the MSI for normal install.

Now open the build's output folder. You will see the following files generated for App-V 4.x builds: One .sprj file, one .sft file, one.osd file, one .xml file and one .msi file. Copy the .msi file on a system that has App-V Client installed and run it. This will install the files of App-V package on that system, register the App-V application with the App-V client and make it ready to run in virtual mode. After the MSI has finished a shortcut to Sample.exe will appear on desktop. Double-click this shortcut in order to launch the virtual Sample.exe. For testing file associations, create a file with .edi extension and double-click it. It should be opened with Sample.exe from the App-V package.

The End

This concludes our tutorial.