MAKEMSI quickly and reliably creates MSI files in a non-programmatic way\Source CodeThe .VER (version) FileThe PRODUCT Part of an MSI Version File

---

The PRODUCT Part of an MSI Version File

This section is "hidden" within the leading comments in the version file. The change history follows this section.

When a leading comment line (before first version entry) contains an "=" sign (equal sign by default) then a keyword has been found and some information is assigned to it. A keyword is case insensitive.

It is a trivial change to support more keywords if you wish to add your own (or even remove existing ones). For details on this you will need to look at the start of "VER.MMH". You can make keywords you supply mandatory or optional, if optional you could assign a default value. The "Version File Based Launch Conditions" section demonstrates the addition of a simple keyword.

The value for each keyword is placed into a "PPWIZARD" macro with a name that starts with "ProdInfo." and ends with the name of the keyword (for example "ProdInfo.Description" for the "Description" keyword).

You can reference one keyword within another using normal PPWIZARD syntax.

A keyword can continue over multiple lines if a leading '=' is used on the continued lines (a single space is used to join lines).

A line can be commented out by starting it with two semi-colon characters.

The keywords supported by default by "MAKEMSI.MMH" are:

• ProductName
  This is the product name.

• Description
  This is a freeform description of the product, use correct punctuation (end sentences with full stops etc) as this is combined with other information and used in a number of areas (for example the "tooltip" and explorer webview information in windows.

  This value can contain HTML and it can be as long as you like however you may not get to see all in explorer view (tooltips etc).

• INSTALLED
  This command supplies one or more space separated platform names.

  This information is recorded in the MSI as well as the generated doco. You can also organise your generated MSIs in what I call a "Platform Definition", which is basically a tree structure representing all the software supported on all platforms.

  No validation (launch conditions etc) are inserted in the generated MSI as a result of this keyword. See the "Version File Based Launch Conditions" section for some code which will allow you to add launch conditions with a new "OnlyOn" keyword (which it defines).

• Note
  Allows you to specify a note for the HTML documentation.

• GUID.?
  Any product keyword that begins with "GUID." is the name of a GUID. The value will be read using the "Guid" command. The MAKEMSI "GUID Generation" shortcut is probably the easiest way of obtaining a valid unique GUID.

  The most common use of this is to specify a contant GUID for your packages' Upgrade code (with "Guid.UpgradeCode"). In general every one of your MSIs must use a unique GUID for this, if you forget this installation of one package could uninstall another.

The "company.mmh" header adds the following (by default) to the ones listed above:

• Licence
  This is the absolute or relative (to current directory) filename of a license file. See the "Licence Dialog Enabling" section for more details.

• MsiName
  The default MSI filename is made up of the product name and version information, this keyword allows you to name the MSI the way you'd like.

• UpgradeCodes
  By default MAKEMSI will remove any previously installed product with the same upgrade code. This keyword allows you to specify one or more extra upgrade codes (space, comma or semicolon delimited) for other products that you'd also like removed.

  Note that I recommend that you pass GUIDs as named GUIDs (macros) to make debugging easier.

  For Example (in "MyProduct.MM"):

  ;--- In "MyProduct.MM" ------------------------------------------------------
  #define  ProductX.Version1               {11111111-1111-1111-1111-111111111111}  ;;Define UpgradeCode for product "ProductX" (major version 1)
  #define  ProductX.Version1_VERSION_MIN   1.00.0000
  #define  ProductX.Version1_VERSION_MAX   1.99.9999
  #define  ProductX.Version1_PROPERTY      MY_CONFIGURED_PROPERTY_NAME
  #define  ProductY                        {11111111-1111-1111-1111-333333333333}   ;;Define UpgradeCode for product "ProductY" (any version)
  #include "ME.MMH"

  And in "MyProduct.VER":

  ;--- In "MyProduct.VER" (define 2 GUIDS) ------------------------------------
  UpgradeCodes = ProductX.Version1 ProductY

Please email me any feedback, additional information or corrections. See this page online (look for updates) MAKEMSI© is (C)opyright Dennis Bareis 2003-2008 (All rights reserved). Wednesday June 25 2008 at 7:16pm Visit MAKEMSI's Home Page