BitRock InstallBuilder User Guide 8

8.6.0, 2013-11-08


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. Code Signing
16.1. OS X
16.2. Microsoft Windows
17. File associations
17.1. Windows file associations
17.2. Linux file associations
17.3. OS X file associations
18. Java
18.1. Java Specific Actions
18.2. Bundling a JRE
18.3. Launchers
19. Regular expressions
19.1. Basics of regular expressions
19.2. Bracket expressions
19.3. Grouping
19.4. Substituting text in regular expression
20. Rollback
21. Troubleshooting
21.1. Debugger
21.2. Logs
21.3. Other Debugging Methods
22. Updates
22.1. What differentiates upgrade installers from normal installers?
22.2. Setting the installer to upgrade installation mode
22.3. Using normal mode when upgrading
23. AutoUpdate Tool
23.1. How to Use AutoUpdate in InstallBuilder
23.2. Adding the AutoUpdate to an Existing InstallBuilder project
23.3. Using AutoUpdate as a notifier
23.4. How to execute custom actions after the update installer is downloaded
23.5. AutoUpdate installers in unattended mode
23.6. Sequential updates
24. Native Packages
24.1. Generation of Native Packages
24.2. Integration with Native Package Systems
25. Builder
25.1. Build
25.2. Quickbuild
25.3. Using the Command Line Interface
25.4. Creating Custom Builds
26. Windows
26.1. Windows Registry
26.2. Windows 64bit
26.3. Managing Access Control Lists
26.4. Changing file attributes
27. OS X
27.1. Using DMGs to bundle your installers
28. Encryption and password protection
28.1. Encrypting payload of the installer
28.2. Support for platforms and build types
28.3. Manually specifying password
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