Directory element
Directory layout for the product. Also specifies the mappings between source and target directories.
Attributes
ComponentGuidGenerationSeed
GuidThe Component Guid Generation Seed is a guid that must be used when a Component with the generate guid directive (”*”) is not rooted in a standard Windows Installer directory (for example, ProgramFilesFolder or CommonFilesFolder). It is recommended that this attribute be avoided and that developers install their Components under standard directories with unique names instead (for example, “ProgramFilesFolder\Company Name Product Name Version”). It is important to note that once a directory is assigned a Component Guid Generation Seed the value must not change until (and must be changed when) the path to that directory, including itself and all parent directories, changes.
DiskId
DiskIdTypeSets the default disk identifier for the files contained in this directory. This attribute’s value may be overridden by a child Component, Directory, Merge or File element. See the File or Merge elements’ DiskId attribute for more information.
FileSource
stringUsed to set the file system source for this directory’s child elements. For more information, see Specifying source files.
Id
stringAn optional identifier for the directory. If one is not specified, a private identifier will be generated.
LoaderSearchPathEntry, from extension namespace http://www.firegiant.com/schemas/v4/wxs/heatwave/buildtools/msix
Allows you to add the directory to the loader search path for the package.
Name
stringThe name of the directory.
Do not specify this attribute if this directory represents the same directory as the parent (see the Windows Installer SDK’s Directory table topic for more information about the ”.” operator).
This attribute’s value may either a short or long directory name. If a short directory name is specified, the ShortName attribute may not be specified. If this value is a long directory name, the ShortName attribute may be omitted to allow WiX to attempt to generate a unique short directory name. However, if this name collides with another directory or you wish to manually specify the short directory name, then the ShortName attribute may be specified.
ShortName
ShortFileNameTypeThe short name of the directory in 8.3 format. This attribute should only be set if there is a conflict between generated short directory names or the user wants to manually specify the short directory name.
ShortSourceName
ShortFileNameTypeThe short name of the directory on the source media in 8.3 format. This attribute should only be set if there is a conflict between generated short directory names or the user wants to manually specify the short source directory name.
SourceName
LongFileNameTypeThe name of the directory on the source media. If this attribute is not specified, Windows Installer will default to the Name attribute.
In prior versions of the WiX toolset, this attribute specified the short source directory name. This attribute’s value may now be either a short or long directory name. If a short directory name is specified, the ShortSourceName attribute may not be specified. If a long directory name is specified, the LongSource attribute may not be specified. Also, if this value is a long directory name, the ShortSourceName attribute may be omitted to allow WiX to attempt to generate a unique short directory name. However, if this name collides with another directory or you wish to manually specify the short directory name, then the ShortSourceName attribute may be specified.