Full Installer Specific Details for SetupBuilder Users

Previous  Top  Next

Note: This example had a "Full Installer" configured in the SetupBuilder project. When the Build Report was imported SetupCast automatically checked the box for it to generate the content for a Full Installer type. Other types of SetupBuilder projects will show you different content sections.

Since a Full Installation was selected in the Project Profile, a menu option for it appears below the Project Profile in the sidebar menu as shown here.



Clicking the Full Installer menu option expands the Full Installation menu and displays the built-in Quick Help for that part of the program as shown here:




Note: Clicking any of the menu headers will display the Quick Help for that section of the program. This is just a quick overview of the section. More help is available by pressing F1 at any screen or from the Help menu.


General Settings

Clicking the General Settings menu option shows us this screen:



You can see that our SetupBuilder automation has already filled in a lot of the information for us.

·	The Use Shared Information box is checked. In this mode the release version and date are taken from the Shared values in the Project Profile General Settings screen. If you uncheck this box then you can enter different values that will be published ONLY for this installer type.

·	The distribution file has been analyzed and the Download Size in Bytes is displayed (note that our test files are small)

·	The SetupBuilder Build Report has been selected and Synchronization has been completed.

Automatic ZIP File Creation

Some corporations or firewalls prevent downloading of EXE versions of your installer. To get around this it is common to provide a ZIP version of your installer as an option. See the regular help for detailed information.



View SB Build Report

In a SetupBuilder related project, SetupCast can display the SetupBuilder Build Report in the integrated viewer. To see the report just click the option on the side menu and the report will be displayed as shown here:




Installer Files

When you click this option on the side menu you will see the files that are associated with this installer type as shown here:



SetupBuilder Synchronization Active

For SetupBuilder related projects, the option to manually select files is hidden. SetupCast automatically analyzes the file distribution (based on info from the SetupBuilder Build Report). The files (or "file" in the case of a Full Installer) is examined and the size in bytes added to the total. There is a manual refresh button, but the process is automatic during a publish.

Publish Installer Files

As mentioned above, SetupCast has the ability to publish the actual files for your installers as well as the content that it generates. If this feature is enabled in the Project Profile General Settings, then it will be automatically checked when this installer type is added. You can uncheck this box if you do not want the installer files for this type of installer published.

Refresh - This button totals the files in the list and updates the Total Bytes.

Total Bytes

SetupCast totals all the files in the list and displays the total here in Bytes.

Note: Tokens are available in the templates that allow you to display the total in Bytes, Kilobytes, Megabytes and Gigabytes.


File Publishing

This menu option displays a screen where you control the filenames and directory names on your webserver for this installer type.


Note: if you click this menu option before the Publish Settings are configured in the Project Profile, you will see errors as shown here:



Don't worry!

Once the Publish Settings are configured (telling SetupCast about your webserver) the URLs will be automatically generated for you.

For your First Project just leave the default filenames (more on that in the section on Publishing Your First Project).


Fixed Publishing
By default SetupCast uses Dynamic Publishing to organize related files in separate directories. It automatically merges information you enter in the Publish Settings with the directory and filenames for each content type. This information is used to create the URLs needed to upload the files and download them.

If you have an existing directory structure on your website that you want to keep you can use the Fixed Publish method to tell SetupCast where to upload the files and how to link to them. This method is not quite as automated as the Dynamic Publish method, but it does make it easy to use SetupCast with your existing website layout.

An example of using Fixed Publishing is shown here:





Release Notes

As mentioned earlier, Release Notes are a way for you to enter information that the end user can read on your website before downloading the installer or running the web update.


When you click this menu option SetupCast displays a screen where you can manage release notes for this installer type as shown here:



By default the "Use Shared Release Notes" option is checked and the release notes from the Project Profile section are used.

If you want to have release notes that are specific to this installer type, uncheck the box and enter them here.


Preview Content

The last step for your test project is to preview the generated content. When you click the Preview Content sidebar option in the Full Installer menu SetupCast takes the HTML template for this installer type and merges the generated data with it as shown here:



A word about the HTML templates...

The merge template above has a token that displays a image that represents your product. If you use a template with this option and have not selected a image (in the Project Profile) then a "No Image" placeholder is inserted in its place.

There are also merge templates that do not have an image in them as shown in the screen shot below.

Several different merge templates are provided with SetupCast. You are free to copy these and modify them or create your own. The templates are just simple documents with tokens in them to represent the data gathered in SetupCast.


This is the same merge template as the one used above, but without a product image.



Note: Clicking a link in the preview mode will display a dialog box that shows you exactly what URL it is linked to as shown here:

(note that since this tutorial is publishing to www.mydomain.com we have substituted another screen shot here)




That is all there is to it!

You have created a new SetupCast project, enabled publishing of your software distribution files, added some release notes and previewed the generated content.

Your next step is to Publish Your First Project.