User's Guide - Introduction

Introduction

Setup Factory has been raising the bar for over a decade, and we're proud to present Setup Factory 8.0—the most important release in years. It's compatible with all versions of Windows from 95 through Windows 7. We've improved the development environment to streamline your work-flow and introduced unprecedented flexibility with the new customizable Screen Manager, Project Themes, Action Editor and Scripting Engine. Of course, we're true to our roots; we still make the easiest to use installer builder available anywhere. But now, it's one of the most powerful solutions as well.

What is Setup Factory?

Setup Factory is a sophisticated tool that gives you complete control over the installation process. Full-featured, fast, and easy to use, Setup Factory's intuitive design maximizes your ability to deploy software products, data files, graphic images, or anything else that you want to distribute.

Creates Compact and Reliable Software Installers

Setup Factory 8.0 creates single-file, compact, and bulletproof professional software installations. Its visual design environment makes it a snap to assemble your files, customize the wizard interface, add runtime support modules, and package your software for deployment via diskette, CD-ROM, LAN, email or Web.

A Proud Heritage

Since its first release, Setup Factory has defined innovation in Windows based setup and installation tools. Over the years, the product line has been the recipient of numerous awards, accolades and glowing reviews.

Trusted by Professionals

Thousands of software developers trust Setup Factory to distribute their software to millions of customers and clients around the world.

While others have tried to imitate it, only Setup Factory 8.0 offers such a perfect combination of ease, flexibility and control.

 

Key Features in Setup Factory 8.0

Install Any File – Anywhere!

Setup Factory 8.0 features an unbeatable development environment that puts you in control of your files. Simply drag and drop your files and folders onto the project window and you’re ready to build. Setup Factory is smart enough to maintain your folder structure, automatically query version resource information, create shortcut icons and ensure 100% data integrity with reliable CRC-32 checking. Of course, everything can be customized and overridden if you wish, but for most projects the improved Project Wizard can handle it all with just a few clicks.

Compact Single-File Setups

Smaller and faster means a better experience for your customers and Setup Factory 8.0 delivers. Compare our tiny ~655 KB runtime overhead (including uninstall) to the competition and see for yourself. Additionally, with no "unpacking" step required, Setup Factory 8.0 installers are also much faster to initialize and install than those created by competitive tools. What’s more, our Publishing Wizard walks you through the build process with a few easy steps. The single-file setup.exe is ready for distribution by web, email, LAN, CD, DVD and even floppy disk.

Project Quick-Start

Spend five minutes with Setup Factory's easy to use Project Wizard and come away with a complete, ready to build installation project. You'll be walked through each option so you can get your project started as quickly as possible.

Customizable Install Wizard Screens

With a library of more than twenty different screen templates to choose from and a pre-built wizard sequence suitable for the majority of installation tasks, Setup Factory 8.0 is miles ahead of both previous versions and the competition. There are pre-built layouts to handle just about any task your installer could want, and it’s easy to adjust them to fit your needs exactly. There's everything from check boxes, radio buttons and edit fields to popular screens like license agreements, serial number verification, shortcut folder selection and other advanced options. The Screen Manager allows you to add and remove screens at will and adjust the sequence with a simple drag-and-drop motion. Each screen features a real-time preview so you can see the result of your changes as you work.

Themes and Skins

Choose from dozens of pre-made themes (skins) for your screens or even make your own. It's as easy as viewing a live dialog preview and picking your favorite style. You can configure everything from fonts (face, color, size, style) and banner images to body/background graphics, control colors (buttons, check boxes, radio buttons) and more. Whether your installer needs a corporate feel or a hip attitude, you can do it with Setup Factory 8.0!

Background Window Options

Choose between the traditional setup-wizard style or the modern Windows Installer style interface. You can customize the background window with gradients, images, color washes, headlines and footer text with 3D effects. Now you can also select a custom taskbar icon, force the setup window to remain on top of other windows or even hide the taskbar icon completely for totally silent installs.

Extensive Action Library

Previous versions of Setup Factory have included a handful of system actions for doing routine tasks such as running programs and creating shortcut icons. Setup Factory 8.0 takes it to another level and gives you full control over your installer. You get a built-in library of more than 360 easy to use actions, so you can do whatever you need without having to be an advanced programmer. There are actions to handle everything from text file editing to system registry changes. You can execute programs, call DLL functions, query drive information, manipulate strings, copy files, enumerate processes, start and stop services, interact with web scripts, display dialog boxes and much more.

Easy to Use Action Wizard

You don't have to be a wizard to create powerful installers with Setup Factory 8.0. We've built the wizard into the software! Simply choose the action you want from a categorized list (complete with on-screen interactive help), fill in the requested information fields and the wizard does the rest. You don't have to know anything about scripting or programming – just fill in the blanks and you're done. Making changes is just as easy. Click on the line you want to change and press the "edit" button to go back to the original form. It's really that easy.

Powerful Scripting Engine

We've taken the classic Setup Factory action engine and replaced it with an all-new and incredibly powerful free-form scripting engine. Based on the popular LUA language, this easy to understand scripting language features everything from "for, repeat and while" loops, to "if/else" conditions, functions, variables and tables (associative arrays). Paired with the built-in action library, full mathematical evaluation and Boolean expressions, there's simply nothing you can't achieve. Of course, we've also built in an "Action Wizard" and "Code Wizard" so even complete novices can create powerful installers that handle even the most demanding installation tasks.

Color Syntax Highlighting Action Editor

If you've outgrown the Action Wizard interface or simply want to unleash the power of the fast and efficient scripting engine, we've got you covered. The Setup Factory 8.0 freeform action editor features all of the professional features you'd expect. There's color syntax highlighting, code completion, function highlighting, as-you-type action prototypes, Ctrl+Space function listings and even context-sensitive help. If you're used to programming in MicrosoftÒ Visual Basic, MicrosoftÒ Visual C++ or any other modern development language, you'll be right at home.

Expandable with Action Plugins

Setup Factory 8.0 can be easily expanded with Action Plugins. These plugin modules can extend the product in infinitely powerful ways, such as adding support for databases and FTP file transfers. Tight integration with the design environment – including IntelliSense style code completion and syntax highlighting – makes them just as easy to use as built-in actions. Plugins are available through Indigo Rose as well as third-party developers thanks to Indigo Rose's freely available plugin development kit.

Dependency Modules & Runtime Support

Instantly add runtime support for many popular third-party technologies, including Visual Basic 5.0, Visual Basic 6.0, DCOM, JET, MDAC, Visual C++, .NET 3.0, .NET 3.5, SQL Express 2005, Visual C++ 2008, Windows Installer 3.1 v2., and more. Additional dependency modules are easy to create and integrate seamlessly into the development environment. Setup Factory 8.0 gives you complete control over the detection and installation of each module, so you can easily adjust the behavior to suite your particular requirements.

Flexible Uninstaller

Setup Factory 8.0 features a new and improved uninstall feature. Simply turn it on and let Setup Factory worry about removing your files. Anything that is installed during the setup will be marked for removal by the uninstaller. However, if you want to go in and tinker with the settings, you'll find that the uninstaller is now fully customizable. You can take full control of what files are removed, what shortcut icons are deleted, what registry changes are made and anything else you require. Even the dialog screens and sequence can be adjusted to suit your needs!

System Requirements Checking

You can easily enforce system requirements just by clicking a few boxes. Built-in checks include operating system, memory, screen resolution, color depth and administrator privileges. If the user's system does not meet the minimum requirements you have chosen, the installer can either warn the user or abort the setup entirely.

Serial Numbers, Security and Access Features

Setup Factory includes a variety of features designed to help you manage access to your software, including serial number lists and date-based expiration. With its powerful serial number generator you can quickly create thousands of unique serial numbers, which are stored internally as secure MD5 hashes. Hidden from prying eyes, your installer data is compressed using proprietary algorithms and only accessible to those users who supply a valid serial number. Of course, if you'd rather do it yourself, Setup Factory 8.0 is flexible enough to support your own custom validation and authorization schemes.

Packages, Categories and Install Types

Creating installers for complex and multi-part products is now easier than ever. With dramatically improved support for grouping files into packages, it's a snap to group products and features into a single installer. There's even support for categories so you can group your packages into logical components. It's the ultimate in flexibility for those large projects that need to support different installation types like typical, minimum, complete and custom.

International Language Support

Setup Factory 8.0 offers unsurpassed support for multilingual installations right out of the box. While some products charge you extra for this essential feature (or don't offer it at all), Setup Factory 8.0 gives you everything you need to support your customers and clients around the world. Installers created with Setup Factory can automatically determine the language of the client operating system and adjust the display of screens and messages appropriately. Whether you need to support English, French, German, Spanish, Italian or any other language recognized by Windows, with Setup Factory 8.0 you simply provide the text and your installer takes care of the rest!

Built-in Spelling Checker

Now it's easier than ever to make sure that typos don't creep into your projects. Basically anywhere you can type, you can perform a spell check to ensure error-free text. Dictionaries are available for over a dozen languages including English, French, German, Italian, Spanish, Dutch, Swedish, Danish, Croatian, Czech, Polish and Slovenian.

Reports and Logs

Keeping track of the essential details of your installation project is now just a couple of clicks away. With improved HTML-based project reports (featuring CSS formatting) and text-based install-time log files, you'll have an accurate record of everything you need. New options let you control the level of detail being logged, including options for recording errors and script actions.

Silent Installs

Create silent installations that operate without displaying user interface dialogs, prompts, messages or errors. Easily read command defaults from a response file and control the installation automatically. Silent installs let you maintain control over hundreds or thousands of workstations while enforcing corporate standards. New options let you enable silent installs with a command line switch, or even force the installer to always run in unattended mode. Setup Factory 8.0 installers automatically return command line status codes and can be easily called from batch files and automatic build processes.

Visual Basic Project Scanner

If you're creating installers for your Visual Basic projects, then look no further! Setup Factory can analyze your VB project and automatically add the necessary runtime files and dependencies for you. There's even an advanced executable scanner that can assist you in determining required DLLs and libraries for those difficult to manage multi-team projects.

Unattended Builds

Setup Factory 8.0 fits seamlessly into your daily build process. Creating your product installer every time you build your source code makes it easy to test early and often. Simply include your Setup Factory project in your build process to run automatically and output a finished setup.exe.

Works with Windows 95 and Up

While other installer tools are dropping support for older operating systems such as Windows 95 and 98, we believe that your choice of installation builder shouldn't limit your potential market. Setups created with Setup Factory 8.0 work just fine on every Windows operating system from Windows 95 to Windows Vista and beyond.

About this Guide

This user's guide is intended to teach you the basic concepts you need to know in order to build a working installer. You'll learn the ins and outs of the program interface and how to perform many common tasks.

The guide is organized into 11 chapters:

Chapter 1: Getting Started
Chapter 2
: Working with Files
Chapter 3:
Creating the User Interface
Chapter 4:
Actions, Scripts and Plugins
Chapter 5:
Session Variables
Chapter 6:
Packages
Chapter 7:
Languages
Chapter 8:
Security and Expiration
Chapter 9:
Dependencies
Chapter 10:
Uninstall
Chapter 11:
Building and Distributing

Each chapter begins with a brief overview and a list of the things you will learn in that chapter.

Document Conventions

This user's guide follows some simple rules for presenting information such as keyboard shortcuts and menu commands.

Keyboard Shortcuts

Keyboard shortcuts are described like this: press Ctrl+V. The "+" means to hold the Ctrl key down while you press the V key.

Menu Commands

Menu commands are described like this: choose File > Open. This means to click on the File menu at the top of the Setup Factory program window, and then click on the Open command in the list that appears.

                       

             Click on the File menu...                          ...and click on the Open command

Typed-In Text

When you're meant to type something into a text field, it will be presented in italics, like this: type "Setup Factory makes me happy" into the Message setting. This means to type in "Setup Factory makes me happy", including the quotes.