The Files and Folders page defines the layout of your product's folders, files and shortcuts. It is organized much like Windows Explorer: on the left is a folders tree that closely resembles the actual Windows folders tree and on the right the contents of the currently selected folder are shown in a list. Below the two, the attributes of the currently selected object(s) are displayed.
When designing your installer, you create further folders as required by your product and add the product's files to the various predefined and newly created folders. Shortcuts to your product's files are also created on this page.
As of Tarma Installer 5.2, the Files and Folders page contains two separate folder trees: one for installation on Windows desktop and server systems, and one for installation on Windows Mobile devices. Most of the documentation below applies equally to both folder trees, with obvious adjustments to allow for the differences between desktop/server systems on the one hand and mobile devices on the other.
The upper tree starts with a root called Target System. This tree represents the folder tree of a typical Windows desktop or server system such as Windows 2000 or XP. Any files, folders, and shortcuts that you create in this tree will be installed on the installer's target system proper. See File attributes, Folder attributes, and Shortcut attributes for details about these installation items.
The lower tree starts with a root called Mobile Device. This tree represents the folder tree of a typical Windows Mobile system such as a Windows Mobile 6.0 PDA or SmartPhone. Any files, folders, and shortcuts that you create in this tree will be included in a Windows Mobile installation cabinet and will ultimately be installed on a mobile device that is connected to the main (desktop) system. The installation cabinet is generated from the Mobile Component that controls the files or folders in question. See Mobile File attributes, Mobile Folder attributes, and Mobile Shortcut attributes for details about mobile installation items.
The folders tree on the left defines the layout of the folders on the target system. It is modelled after the folders tree on recent Windows versions (in particular, Windows 2000, XP, and later), but with some important differences:
Generally speaking, do not change the layout of the folders tree on the Files and Folders page even if you think that it doesn't match your Windows system exactly. The folders tree was carefully designed to be compatible across all Windows versions from Windows 95 to Windows Vista/2008 and will adapt at installation time to the actual situation on the target system. It's best to consider the tree as an idealized version of the Windows folders tree and and to rely on the installer to make up any differences between the ideal and the reality of the target system.
Creating new folders is not a problem if you add them as subfolders of existing magical folders rather than using hard-coded locations that might work on your version of Windows, but not necessarily on the customer's system.
Although the layout of the Windows folders tree is fairly consistent between Windows versions, there are occasional differences. For example, the Windows folder might be called C:\Windows, C:\WINNT, or something different altogether. The Program Files\Common Files folder is usually called C:\Program Files\Common Files on English-language Windows systems, but C:\Programme\Gemeinsame Dateien in German and C:\Program Files\Fichiers communs in French (yes, part English, part French).
Magical
folders are indicated with the "starry folder" icon shown left. They
are "magical" because they adapt automatically to the situation on
the target system. For example, the Documents and Settings magical folder
maps to the C:\Documents and Settings folder on English-language Windows
2000 and later systems, but it maps to C:\Dokumente und Einstellungen on
German-language systems, to C:\Winnt\Profiles on Windows NT4 systems,
and to C:\Windows on Windows 9x.
The most important magical folders in the folder tree are shown in the following table. See Standard folders for a complete list.
| Magical folder | Purpose |
|---|---|
| Target System | Root folder on the target system. At installation time, it is set to the root folder of the disk volume with the largest amount of free space and read/write access, which may or may not be the same as the Windows Volume disk volume. |
| Documents and Settings | Root folder for the common ("All Users") and per-user profile information. Its actual location differs among Windows versions. |
| Documents and Settings\All Users | Root folder for common ("All Users") profile information, i.e., application data, shortcuts, and other information that must be maintained for the system as a whole rather than a particular user. Shortcuts that must be visible to all users should be stored in its subfolders, for example Desktop, Start Menu, and Start Menu\Programs. If your product must store system-wide application data, for example presets, templates, etc., it should do so in a product-specific subfolder of Application Data, such as Application Data\<Publisher>\<ProductName> |
| Documents and Settings\Current User | Root folder for Current User profile information, i.e., application data, shortcuts, and other information that is specific to the installing user. Shortcuts that must be visible only to the installing user should be stored in its subfolders, for example Desktop, Start Menu, and Start Menu\Programs. If your product must store user-specific application data, for example user preferences or customizations, it should do so in a product-specific subfolder of Application Data, such as Application Data\<Publisher>\<ProductName> |
| Program Files (32-bit) | Root folder for 32-bit application programs and their support files. Your product should be installed in a product-specific subfolder. If your product shares files with your other products, they should go into the Common Files subfolder; if it uses files shared with other parties (including system files), they normally go into the Windows\System32 folder elsewhere in the tree. Any files stored under Program Files (32-bit) and its subfolders should be considered to be read-only. Do not store application data or user documents that must be written or updated in this part of the folders tree. Instead, use a subfolder under one of the Application Data folders in the All Users or Current User subtrees for any application data that may be modified (and rewrite your application to access the data there), and store user documents by default into Documents and Settings\Current User\My Documents. |
| Program Files (64-bit) | Root folder for 64-bit application programs and their support files. Your product should be installed in a product-specific subfolder. If your product shares files with your other products, they should go into the Common Files subfolder; if it uses files shared with other parties (including system files), they normally go into the Windows\System64 folder elsewhere in the tree. Any files stored under Program Files (64-bit) and its subfolders should be considered to be read-only. Do not store application data or user documents that must be written or updated in this part of the folders tree. Instead, use a subfolder under one of the Application Data folders in the All Users or Current User subtrees for any application data that may be modified (and rewrite your application to access the data there), and store user documents by default into Documents and Settings\Current User\My Documents. |
| Temp | Temporary files folder, used to store scratch files during installation and removal. If you store any files here, you should not rely on them to still be present after the next system restart; on many Windows systems, utilities clean up the Temp folder each time the system starts. |
| Windows | Root folder for the Windows user files. It contains a number of subfolders for the Windows system and program files; on any actual Windows system, these subfolders may or may not be physical subfolders of the Windows folder. For example, some Windows configurations store the system files (System32 subfolder) on a shared network volume, even though the Windows folder itself is always located on a local disk. |
| Windows Volume | Root folder of the disk volume that contains the Windows folder, which may or may not be the same as the Target System disk volume. |
The folder paths shown below are typical paths for US English installation of Windows that use the default settings. They may differ for other languages or non-standard installations. The installer will automatically detect this and use the correct paths for the target system.
Note: Paths marked * are non-standard folders. They will be created by the installer as required, but may not be recognized by the target system for their intended purpose.
| Canonical folder | 95/98/Me | NT4 | 2000/XP/2003 | Vista/2008 |
|---|---|---|---|---|
| Documents and Settings | C:\Windows | C:\WinNT\Profiles | C:\Documents and Settings | C:\Users |
| Documents and Settings\All Users | C:\Windows\All Users | C:\WinNT\Profiles\All Users | C:\Documents and Settings\All Users | C:\ProgramData |
| Documents and Settings\Current User | C:\Windows | C:\WinNT\Profiles\User name | C:\Documents and Settings\User name | C:\Users\User name |
| Program Files (32-bit) | C:\Program Files | On 32-bit systems: C:\Program Files On 64-bit systems: C:\Program Files (x86) |
||
| Program Files (64-bit) | C:\Program Files (64-bit)* | On 32-bit systems: C:\Program Files (64-bit)* On 64-bit systems: C:\Program Files |
||
| Temp | C:\Windows\Temp | C:\Temp | C:\Documents and Settings\User name\Local Settings\Temp | C:\Users\User name\AppData\Local\Temp |
| Windows | C:\Windows | C:\WinNT | C:\Windows | C:\Windows |
| Windows Volume | C: | C: | C: | C: |
In addition to the visible folder names in the tree, each folder also has an alias. This alias must be unique across the entire Tarma Installer project and serves as a symbolic reference to the folder's installation path. You can use it with the same <name> syntax that you use for symbolic variables.
Folder
aliases are an extension of the symbolic path variables that Tarma Installer
2.x used, although many of the symbolic names have changed in Tarma Installer
5.x. Similar to Tarma Installer 2.x, you can use expressions such as <ProgramFilesFolder>\<ProductName> to
refer to symbolic paths that will be resolved at installation time.
To make the folder aliases visible in the folders tree, right-click on any folder in the tree, then choose Show aliases. To revert to the normal view, execute the same command again. In alias view the folder tree icons are shown ghosted, and instead of the folder names the folder aliases appear. Below are screen shots that illustrate this effect: on the left is the normal view, on the right is the same folders tree in alias view.
 |
 |
Note: If you edit a folder name directly in the folders tree (using Edit > Rename or the F2 key), you change the folder's installation name. However, using the same command in alias view changes the folder's alias, not its installation name.
Each folder alias appears automatically as a pseudo-variable on the Symbolic Variables page. The value of the folder alias variable is the folder's installation path, defined recursively as the alias of its parent folder plus the folder's own installation name.
For example, the Windows Volume\Windows\assembly folder in the screen shots above appears as the variable GlobalAssemblyCache on the Symbolic Variables page (because its alias is GlobalAssemblyCache) and has the value <WindowsFolder>\assembly (its parent's symbolic path plus the installation name of the folder itself). You could use the expression <GlobalAssemblyCache> in turn to define other paths.
The folder contents list pane on the right shows the contents of the folder that selected in the folders tree on the left. By default, the contents list is sorted alphabetically by file or folder name, with all folders appearing before any files. You can choose a different sort order by clicking on the corresponding column; clicking a second time on the same column reverses the sorting order for that column.
To change the width of a column, point the mouse cursor to the separator on the right of the column's heading, then drag it to the desired width. Double-click the separator to make the column wide enough to display the longest item in that column.
You can issue file- and folder-related command from both the folders tree and the the folder contents list, and also from the Files and Folders page's toolbar. Furthermore, some of the commands on the Workshop's main menu bar and its toolbar also apply.
To issue a command, select the folders, files, or shortcuts to which the command must apply, then do one of the following:
You can use drag & drop to move files and folders within the folders tree. You can also use drag & drop between Windows Explorer and the Tarma Installer folders tree to add new files and folders to the project. However, you can not drag and drop files or folders between the Target System and Mobile Device trees.
The following drag & drop actions are supported on the Files and Folders page:
| Action | Keyboard modifiers | Effect |
|---|---|---|
| Drag & drop with Left mouse button | (none) | Moves the selected objects to the drop point. |
| Ctrl | Copies the selected objects to the drop point | |
| Shift | Moves the selected objects to the drop point. | |
| Ctrl+Shift | Creates shortcuts to the selected objects at the drop point. | |
| Drag & drop with Right mouse button | (ignored) | Displays a popup menu at the drop point with the options Copy Here, Move Here, Create Shortcuts Here, and Cancel. These options allow you to choose one of the actions documented above. |
You can create shortcuts in any folder. To make them appear on the Desktop, Start menu, or Programs menu, use the folders shown in the following table.
| Menu | Folder |
|---|---|
| Desktop (common) | Target System\Documents and Settings\All Users\Desktop |
| Desktop (installing user) | Target System\Documents and Settings\Current User\Desktop |
| Start menu (common) | Target System\Documents and Settings\All Users\Start Menu |
| Start menu (installing user) | Target System\Documents and Settings\Current User\Start Menu |
| Programs menu (common) | Target System\Documents and Settings\All Users\Start Menu\Programs |
| Programs menu (installing user) | Target System\Documents and Settings\Current User\Start Menu\Programs |
| Application program group (common) | Target System\Documents and Settings\All Users\Start Menu\Programs\<ProductName> |
| Application program group (installing user) | Target System\Documents and Settings\Current User\Start Menu\Programs\<ProductName> |
| Startup menu (common) | Target System\Documents and Settings\All Users\Start Menu\Programs\Startup |
| Startup menu (installing user) | Target System\Documents and Settings\Current User\Start Menu\Programs\Startup |
| QuickLaunch toolbar (installing user) | Target System\Documents and Settings\Current User\Application Data\Microsoft\Internet Explorer |
To create shortcuts on a Windows Mobile device and make them appear on the Desktop, Start menu, or Programs menu, use the folders shown in the following table. However, be aware that not all locations are supported on all mobile devices; you should test your installer before deployment to ensure that the shortcuts end up in the desired location. Generally speaking, the Start menu and Programs menu locations are the most widely supported.
| Menu | Folder |
|---|---|
| Desktop | Mobile Device\Windows\Desktop |
| Start menu | Mobile Device\Windows\Start Menu |
| Programs menu | Mobile Device\Windows\Start Menu\Programs |
| Application program group | Mobile Device\Windows\Start Menu\Programs\<ProductName> |
| Startup menu | Mobile Device\Windows\Startup |
Tarma
Installer 2.x upgrade notesThe most important differences from the Project - Files page in Tarma Installer 2.x are:
For more information, see the topics Project - Files page and Project - Shortcuts page in the Upgrading from Tarma QuickInstall section.
File, Folder, Shortcut, Mobile File, Mobile Folder, Mobile Shortcut, Installing Files, Installing Shortcuts, Working with project pages