MAKEMSI quickly and reliably creates MSI files in a non-programmatic way\Source CodeCommandsDirectoryTree

---

The "DirectoryTree" Command

This command takes a directory specification in a fairly user friendly format and defines and possibly creates this directory entry in the MSI "Directory" table.

The macro takes these parameters:

• Key (required)
  This allows you to specify what the name of the very last component of the directory is called (e.g. what the key for "CCC" in the directory "C:\AAA\BBB\CCC" would be).

• DIR (required)
  This is the directory tree you wish to define or create (when the MSI is installed). Please see the "Directory Tree Specification" section for more details.

• Make (optional)
  To add this directory to the MSI "CreateFolder" table you should pass "Y", anything else means that you do not wish to create a blank or empty folder (the default). You do not need to create folders which contain files as folders are automatically created so that the files can be installed.

• Remove (optional)
  To add this directory to the MSI "RemoveFile" table table (with empty "FileName) you should pass "Y". You will generally use this parameter to remove "ICE64" validation errors. If you used the "MAKE" parameter it will use the same component otherwise it works the same as the "MAKE" parameter except that a component will never be created for you.

• Component (optional)
  This parameter is ignored unless "MAKE=Y". If not supplied then the "current" component information (see "Component" command) is used. Either way if the component information is blank then a component will be created for you.

• Change (optional)
  If a non-blank parameter is passed then this is the name of an existing feature that should be associated with this directory. The final install directory will be able to be updated by the user at install time ("Browse" button). The value "\" is replaced with the value of the current "root" feature while "." is replaced with the value of the "current" feature. Of course an error message is created if there is no "current" feature.

• PrimaryFolder (optional)
  You should pass "Y" for this parameter if the directory represents the "primary folder". The MSI properties "ARPINSTALLLOCATION" and "PRIMARYFOLDER" will be set.

• Access (optional)
  You can use this parameter to indicate that the entry requires one or more (space separated) special user permissions which have previously been defined using an "Access" command.

  Note that the directory key must be specified in the "CreateFolder" table table otherwise you should get validation errors and it won't work. You can use the "MAKE" parameter to add the info to the table.

• Any others (optional)
  Any other parameters are ignored unless "MAKE=Y" and we are creating the component, otherwise it should be a valid parameter for the "Component" command.

If you find that varying one directory effects another's location then you should read the "Altering one Directory also effects Others" section.

EXAMPLES - Create Empty Folder

Note that in the following example an empty folder is not removed on uninstallation, use the "REMOVE" parameter if this is required:

<$Component "CreateEmptyFolder" Create="Y" Directory_="EMPTYDIR">
    <$DirectoryTree Key="EMPTYDIR" Dir="c:\EmptyDirectory" MAKE="Y">
<$/Component>

EXAMPLES - Other

<$DirectoryTree Key="INSTALLDIR1" DIR="C:\A\B\C\D\E\F\G\InstallationDirectory"> ;;C: forced! (BY DEFAULT) - can be overriden from install command line though...
<$DirectoryTree Key="INSTALLDIR2" DIR="[ProgramFilesFolder]\x\y\z\InstDir2">    ;;Tree starts at "ProgramFilesFolder"
<$DirectoryTree Key="INSTALLDIR3" DIR="C:\Program Files\InstDir3">              ;;Because of preconfigured mapping will convert to use "ProgramFilesFolder"!
<$DirectoryTree Key="INSTALLDIR4" DIR="C:\Program Files\AN83NAME.1|ALongDirectoryNameForWhichIHaveSuppliedASpecific_8.3_Name">  ;;Specify a specific 8.3 name

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 March 20 2013 at 3:07pm Visit MAKEMSI's Home Page