Wise Package Studio

Wise Package Studio is a suite of tools that allows you to create and edit packages, transforms, patches, and more.

First Time Settings

Before we create MSI packages, we must install Wise Package Studio. Once installed, we need to make some configurations.

One of these configurations is related to merge modules. To include these files in the package, we must either populate the default directory of the Wise with merge modules, or we must redirect to a directory that contains these modules.

You can do this with the Windows Installer Editor, Tools \ Options \ Merge Modules menu, Default Merge Module Directory option:

Wise Options View
Wise Options View

It is also recommended to set Advertising options before starting any captures. Because dll registration is done through registries, it is not recommended to have it be captured, since Wise registers them automatically.

Wise Options View
Wise Options View

The “Automatically add self-registration” option must be unchecked.

How to Create a Project

After launching Wise Package Studio, you will be presented with a page where you can choose the type of project you want to create.

Wise Package Studio Main View
Wise Package Studio Main View
  1. Select Windows Installer Editor
    New Installer window in Wise Package Studio
    New Installer window in Wise Package Studio
  2. From the Predefined Templates, select Windows Application and click OK

That’s it! The project is now created and you can start adding information to your MSI package.

How to Add Files

The most important step in creating an MSI package is adding a file or folder.

  1. Navigate to the Files page by selecting it from the left-side panel.
    Wise Files Editor Page
    Wise Files Editor Page
  2. In this window, the explorer tabs located in the top show the folders, files and overall content stored in the machine. On the left you have the folders, and on the right, the contents of a specific folder.
  3. The bottom two tabs show what’s present in the Windows Installer package. Again, on the left, you can find the folders, and on the right, the folder contents.
  4. To add files, select the file you want to add, in our case story.txt, and click the Add file button.

Wise Package Studio will then create the features and components automatically..

How to Add a Registry

To add a registry to your package:

  1. Navigate to the Registry page in the left pane. As with the Files page, the page is split in 4 areas. The top two areas show registries and values that are present on your machine, and the bottom panes display what will be added from the package.
  2. Click the Add button.
  3. A Registry Details window will appear where you can specify the registry root, key, name, value and data type.
    Wise Registry Editor Page
    Wise Registry Editor Page
  4. Input the values and click OK. When finished, the registry will appear in the bottom view area.
    Wise Registry Editor Page
    Wise Registry Editor Page

How to Edit Product and Company Names

You need to specify a name and manufacturer for your MSI. To do this, navigate to the Product Details page. There, modify the Product Name and Manufacturer.

Wise Product Details Page
Wise Product Details Page

How to Create Shortcuts

We need to create shortcuts to the installed files to allow for easier access. So, let’s create a shortcut in the Start Menu.

  1. Start by navigating to the Shortcuts Page, and click the Add button from the right pane.
    Wise Shortcuts Page
    Wise Shortcuts Page
  2. Keep the default settings and click Next.
    Wise Shortcuts Page
    Wise Shortcuts Page
  3. Select the file for which the shortcut will be made. In our case it’s story.txt. Then, click Next.
    Wise Shortcuts Page
    Wise Shortcuts Page
  4. We also need to specify the directory where the shortcut will be created. In our case, we configured the shortcut to be placed in Start Menu\Programs. After you choose your directory, click Next.
    Wise Shortcuts Page
    Wise Shortcuts Page
  5. If you have any additional arguments or settings, configure them here. Otherwise click OK.
    Wise Shortcuts Page
    Wise Shortcuts Page
  6. The shortcut will now be created when the package is installed on the machine.

How to Change the Product Version

At some point, you may need to release a new version of the story -- including fixes to some issues discovered in the first release.

  1. Switch to the Product Details page by selecting it in the left-side panel. Then, edit the Version field to “2.0.0”.
    Wise Product Details Page
    Wise Product Details Page

    Note: When changing the version of an MSI package, the Product Code must also be changed.

  2. Select the Product Code and click the Change button.
    Wise Product Details Page
    Wise Product Details Page
  3. Wise Package Studio will warn you that if this is an upgrade package, you shouldn’t change the upgrade code.

    In our case, this is a newer version of the package, so we will click NO.

    Wise Product Details Page
    Wise Product Details Page
  4. Once NO is clicked, Wise Package Studio automatically generates a new Product Code. A new version of the installer is now properly configured.

How to Build and Install

  1. To build the MSI package, click navigate to File > Compile or F7.
    Compile the project in Wise Package Studio
    Compile the project in Wise Package Studio
  2. A window will appear asking where the MSI should be changed. Type the MSI name and save it to the location you wish.
    Save location dialog
    Save location dialog

Congratulations! You have created your first Wise Package Studio MSI package.

Now, if you navigate to the build location and try to install the package, all of the previous settings will be applied on the machine.

The resulted MSI installer
The resulted MSI installer