Bookmark and Share

Award AutoUpdate - Builder

Builder - Application Information
 
After you create a new Award AutoUpdate project file, You need set the base information for your application firstly.


Define the location of the application directory

Application directory
In general, the application directory is relative to the update.exe directory. E.g. your software product is installed into the directory
    C:\Program files\MyApp
and you will place the update.exe into the directory 
    C:\Program files\MyApp\Update
then the "Application directory = Update.EXE directory\..\". If you will place the update.exe into the directory same as the application base directory
    C:\Program files\MyApp
you should set the "Application directory = Update.EXE directory\". 


Application Information
  
Application name

What's the name of your software product?

Version

The latest version number of your product.


Official Website

Provide your website here, if the update failed, your customer will get the information.
  
Support Email

Provide your support email address here, if the update failed, your customer will get the information. 
 

Builder - File List

 

In this screen, You can manage your application files. Click '+' to add one or more files or click '-' to remove the selected files from list.
 

At the top-right side of the window, you can see the files list. In this list, you can create more virtual directories and add the files in to the relevant directory. The update.exe is pre-defined in the list. It means the update.exe will update itself if we release the new version.

Select a directory which you want to add files to. Then click the "+" tool button on top side of the Files list view.
 
Set the properties for all files. Select a file in the list, you can see its properties.
 
Properties:
 
Description:
Specify the description of the selected file here. Then the description will be shown in the update list instead of the original file name when updating. If leave it blank, the updater tool will show the file name in the list.
 
Action when update/overwrite failed:
When updating, some files of your product may can't be updated, e.g. the exe file is running. You should set the action when the file can't be updated. There are three options:
 
Update after reboot system
This is the default option. If the file can't be updated, Update.EXE will prompt to reboot the system after update. Then the file will be updated after reboot automatically.
  
Ask user to close all related programs
If the selected file can't be updated, Update.EXE will show a message box to notify the user to close all related programs then try to update the file again. If the file still can't be updated, Update.EXE will prompt to reboot the system after update.
 

Terminate the related progress by running a command line
Maybe the running exe file can be terminated by running a command line, e.g.

Ignore
Update.exe will update it when next system reboot, but the updater will not reboot the system immediately. 
 
Update options:

There are some other options for update.
 
Download and update only if file exists
If this option is checked, update.exe will check if the file exists on the local computer. If the file doesn't exist, update.exe will not download and update the file from web server.
  
Download only if file doesn't exist
If this option is checked, update.exe will check if the file exists on the local computer. If the file exists, update.exe will not download and update the file from web server. If the file doesn't exist, then update.exe will download it to the local computer.
  
Cancel all updates if download/update this file failed
This option is for the important files. If this file is so important that it must be updated first of all, check this option. If it is checked, update.exe will not apply all updates when the file download or update failed.

Force to reboot the system if this file updated
If this option is checked, update.exe will prompt the user to reboot the system if the file is updated. 

Reboot the application if this file updated
If this option is checked, update.exe will prompt the user to reboot the application if the file is updated.
 
Builder - Update Information
 
In this screen, you can set the update description information for your new version. this information will be displayed in the users' Update Wizard program

Builder - Servers Information
 
In this screen, you can set the update servers information.

 
 
 Location of update script file

The URL of the script file (also called index file) is unique for one project. The updater always downloads the index file firstly to get all information about update. in this part, you can set the mode for accessing index file. the updater will use the settings to read index file from your server.
 
HTTP Protocol
Updater will use HTTP protocol for downloading index file.

FTP Protocol
Updater will use FTP protocol for downloading index file. (Please note: if you also check the HTTP protocol option, the updater will use the default HTTP protocal instead of FTP protocol, the FTP settings will be ignored.)
 
Server List
 
In this part, you can configure your update servers list. the server list will be displayed in the 'Select Server' screen of the updater.
 

Builder - Actions List

 
In this screen, You can define the actions list for being performed before and/or after update.
 
 

 

  • Run command lines before update

    If you want to run some programs before update, add them here. Updater tool will execute them before update but after download. Please note, updater tool will execute them synchronously, it means that updater tool will not continue until the program all terminated.
     
  • Run command lines after update

    If you want to run some programs after update, add them here. Updater tool will execute them after update but before show report. Please note, updater tool will execute them asynchronously. It means that updater tool will not wait for them.
     
  • Run command lines always when exit

    If you want to run some programs when updater tool exit, no matter updated or not, add them here. Updater tool will execute them when exiting and doesn't wait for them.
     
  • Registered libraries after update

    If there are some new ActiveX library files (.OCX, .DLL, etc) in your application and you need register them(with RegSvr32.EXE in system) after update, just add them here. They will be registered after update.
     
  • Create shortcuts after update

    If you want to add some shortcuts after update, add them here. award AutoUpdate supports to create shortcuts on Desktop, Quick Launch and Start Menu\Programs. You need to define the location of the item, the name of the shortcut. The shortcuts will be created after update.
     
  • Delete files after update

    If you want the updater to delete some files after update, add them here. The files specified will be removed after all actions above.

Builder - User Interface
 

Set the option for user interface of the updater tool
 

Builder - Build Project
 
At the end, you can select this screen and then click 'Build Now' button to generate the target files.
 
Build client files (the updater) to
 
award AutoUpdate Builder will build the updater tool (update.exe and resource files) into this directory. So you can pack the updater tool into your release package.
 
Build server files to
 
award AutoUpdate Builder will build server files into this directory. Then you can upload these files to the web server.
  
Upload server files after building
 
If you have set the FTP settings for all servers correctly, you can check this option. After building, award AutoUpdate Builder will FTP upload the server files onto the servers automatically. 
 
   
   

 

 
Copyright © 2019 Award Software. All Rights Reserved.