BitRock InstallBuilder User Guide 8
BitRock InstallBuilder User Guide 8
8.0.2,
2012-02-02
<
support@bitrock.com
>
Table of Contents
1. Introduction to InstallBuilder
1.1. What Sets InstallBuilder Apart
1.2. What’s New In InstallBuilder 8
1.3. Features
1.4. Supported Platforms
1.5. Requirements
1.6. Editions
1.7. The GUI
1.8. The XML
2. Installation and Getting Started
2.1. Installation
2.2. Registering your Copy of InstallBuilder
2.3. Directory Structure
2.4. Building Your First Installer
2.5. Sample installers bundled with InstallBuilder
2.6. Additional Support Resources
3. Architecture
3.1. Installer basics
4. Variables
4.1. Basic Syntax
4.2. Modifier Suffixes
4.3. Accessing Environment Variables
4.4. Advanced syntax
4.5. Accessing Language Strings
4.6. Escaping Variables
4.7. Nested Variables
4.8. Built-in variables
5. Components
5.1. Enabling and disabling components
5.2. Component Action Lists
5.3. Adding files and directories
5.4. Adding shortcuts to the components
5.5. Adding components from external files
5.6. Excluding components at build time
5.7. Component Groups
5.8. Downloadable components
5.9. Adding or removing components to existing installations
6. Working with Files and Folders
6.1. Conditionally Packing a Folder
6.2. Conditionally Unpacking a Folder
6.3. Filters
6.4. Unix Permissions
6.5. Symbolic Links
6.6. Unpacking Before Installation Time
7. User Input
7.1. Parameters
8. Actions
8.1. What are Actions?
8.2. Action Lists
8.3. Running External Programs
8.4. Displaying Progress While Executing Long Running Actions
8.5. Creating Custom Actions
8.6. Error Handling
8.7. List of Available Actions
9. Rules
9.1. What is a Rule?
9.2. Rule List
9.3. Should Pack Rule List
9.4. Rule Groups
9.5. Additional Rule Lists
9.6. List of Available Rules
10. User Interface
10.1. Installation Modes
10.2. Pages
10.3. Dialogs
11. Menus and Shortcuts
11.1. Defining Shortcuts at Build Time
11.2. Shortcut Folder Structure
11.3. Creating Shortcuts on Demand at Runtime
11.4. Shortcuts/Aliases on OS X
11.5. Shortcuts on Linux
12. Installer Customization
12.1. Languages
12.2. Changing Built-in Installer Text Strings
12.3. Images
13. Running the Installer
13.1. Requiring Administrator Privileges
13.2. Multiple Instances of the Installer
14. Uninstaller
14.1. Uninstaller Action Lists
14.2. Marking Additional Files for Deletion
14.3. Preventing Files from Being Deleted
14.4. Interacting with the End User
15. Services
15.1. Linux Services
15.2. Windows Services
15.3. OS X Services
16. File associations
16.1. Windows file associations
16.2. Linux file associations
16.3. OS X file associations
17. Java
17.1. Java Specific Actions
17.2. Bundling a JRE
17.3. Launchers
18. Regular expressions
18.1. Basics of regular expressions
18.2. Bracket expressions
18.3. Grouping
18.4. Substituting text in regular expression
19. Rollback
20. Troubleshooting
20.1. Debugger
20.2. Logs
20.3. Other Debugging Methods
21. Updates
21.1. What differentiates upgrade installers from normal installers?
21.2. Setting the installer to upgrade installation mode
21.3. Using normal mode when upgrading
22. AutoUpdate Tool
22.1. How to Use AutoUpdate in InstallBuilder
22.2. Adding the AutoUpdate to an Existing InstallBuilder project
22.3. Using AutoUpdate as a notifier
22.4. How to execute custom actions after the update installer is downloaded
22.5. AutoUpdate installers in unattended mode
22.6. Sequential updates
23. Native Packages
23.1. Generation of Native Packages
23.2. Integration with Native Package Systems
24. Builder
24.1. Build
24.2. Quickbuild
24.3. Using the Command Line Interface
24.4. Creating Custom Builds
25. Windows
25.1. Windows Registry
25.2. Windows 64bit
25.3. Managing Access Control Lists
25.4. Changing file attributes
25.5. Digitally signing Microsoft Windows installers
A. Actions
B. Rules
C. Parameters
D. Project Properties and Lists
E. Component and Folder Properties and Lists
F. Shortcuts
G. Other Child Elements
H. AutoUpdate