System Folder Definition Placeholders
Different Windows systems may have different locations of standard Windows folders. For example, the location of the Program Files, ProgramData and other system folders may be different and depends on a particular system. You need to take that into account when you create an MSI, you cannot use absolute paths to the standard system folders. An MSI fails to deploy if it uses absolute path to system folders and these folders are missing on the system. Instead, you can use so-called system folders placeholders that represent well-known system locations and are automatically converted to correct file system paths when a package is deployed.
When you use Repackage Installation Wizard to monitor an installation, the program automatically converts captured absolute paths to system folders. In the File System editor you can select a system folder to add a file into it when adding a file manually. You can automatically covert absolute paths to system folders by executing the Roll All System Folders action from the context menu of the project.
System folders placeholders are represented in the project with a set of predefined names to well-known system paths. In the project they are represented with special names started with ${ and ended with }$, for example ${ProgramFilesFolder}$.
System folders are replaced with the file system locations actual for the system where the package is deployed, so file system resources are created in correct locations.
System folder placeholders can be used in different places within the project and in the program settings. In the File System section of the project system folders are used to configure paths to the files and folders to be deployed. System folders can be used in Custom Actions to specify a path to the deployed script or executable to be invoked after deployment. System folder definition placeholders can be used to configure filters in the program Preferences.
Below is a list of the available placeholders for system folder definitions.
Placeholder |
Replacement |
|---|---|
AdminToolsFolder |
The file system directory that is used to store administrative tools for the current user. |
AppDataFolder |
The Application Data folder for the current user. |
CommonAdminToolsFolder |
The file system directory that contains administrative tools for all users of the computer. |
CommonAppDataFolder |
The Application Data folder that is common for all users. |
CommonDesktopFolder |
The folder for the Desktop content that is common for all users. |
CommonDocumentsFolder |
The file system directory that contains documents that are common to all users. |
CommonFiles64Folder |
The Common Files folder for 64-bit applications. |
CommonFilesFolder |
The Common Files folder for 32-bit applications. |
CommonProgramMenuFolder |
The folder for the All Programs menu content that is common for all users. |
CommonStartMenuFolder |
The folder for the Start menu content that is common for all users. |
CommonStartupFolder |
The folder for the programs executed on startup for all users. |
CurrentUserProfileFolder |
The current user's profile folder. |
DesktopFolder |
The current user's Desktop content folder. |
FavoritesFolder |
The Favorites folder for the current user. |
FontsFolder |
The folder used to install fonts to. |
LocalAppDataFolder |
The folder that serves as a data repository for local (nonroaming) applications for the current user. |
MyPicturesFolder |
The Pictures folder for the current user. |
NetHoodFolder |
The file system directory that contains the link objects that may exist in the My Network Places virtual folder. |
PersonalFolder |
The Documents folder for the current user. |
PrintHoodFolder |
The file system directory that contains the link objects that can exist in the Printers virtual folder. |
ProgramFiles64Folder |
The Program Files folder for 64-bit applications. |
ProgramFilesFolder |
The Program Files folder for 32-bit applications. |
ProgramMenuFolder |
The folder for the All Programs menu content for the current user. |
RecentFolder |
The file system directory that contains shortcuts to the user's most recently used documents. |
SendToFolder |
The folder tor the Send To menu content for the current user. |
StartMenuFolder |
The folder for the Start menu content for the current user. |
StartupFolder |
The folder for the programs executed on startup for the current users. |
System16Folder |
The System folder for 16-bit libraries. |
System64Folder |
The System folder for 64-bit libraries. |
SystemFolder |
The System folder for 32-bit libraries. |
TempFolder |
The file system directory that is designated for temporary files. |
TemplateFolder |
The Templates folder for the current user. |
UserProfilesFolder |
The system user profiles folder. |
WindowsFolder |
The folder the operating system is installed to. |
WindowsVolume |
The volume the operating system is installed on. |
Please note that specific system folders can be indefinite on specific operating systems, so you should make sure that the operating systems you have defined as target during a deployment package creation process support the folders you have defined.