Site Map Contact Us Home
E-mail Newsletter
Subscribe to get informed about
Clever Components news.

Your Name:
Your Email:
 
SUBSCRIBE
 
Previous Newsletters
 




Products Articles Downloads Order Support
Customer Portal      

Web Update Description

Features | Detailed Description

Available in VCL and ActiveX editions.

The Web Update component retrieves version information from the website and if there is a newer version available it will download update files and install the update.

Currently the following features have been implemented:

  • Using the Configuration File you can associate the command batch statements (such as copy, unzip, del...) with each update archive separatedly. This Configuration File is placed on the web server and available via the UpdateURL property.
  • Updating of the main application executables using the command batch file (e.g 'starter.cmd').
  • The downloading resuming feature: if you download updates and decide to interrupt the downloading process and close the application, next time you start the Web Update component the downloading of the interrupted update will start at the point where it was stopped.

How it works: when the Web Update component processes the downloaded updates, all updates are applied immediately except for ones which contain the main application executable. The command batch scripts (from p.1) for such updates are stored into the 'starter.cmd' file. The last statement of the starter.cmd file always contains the line which runs the main application executable - 'start YourApplication.exe'.

What the Web Update does:

  • Connects to UpdateURL and downloads the Configuration File containing the updates information.
  • Downloads all necessary updates are listed in Configuration File. The updates which are downloaded in the previous session of work, are skipped.
  • Copies, unpacks and performs all necessary instructions from Configuration File for each received update.
  • If there is update file which requires the main application to be restarted, the OnTerminating event occurs.
  • Next time you run your application (for sure using the starter.cmd file), all previously locked files will be replaced with new ones and finally the main application will be started.

See the Updating your application via the Internet article for more details.

You can modify the Configuration File by using the program we provide together with the Clever Internet Suite installation. See the 'UpdateMgr' Demo program.

Please see the Demos code (WebUpdate, WebUpdateTimeStamp, UpdateMgr) and also the indexed Help documentation provided with the Clever Internet Suite installation for more details about using this component.

The most common members of the Web Update component can be seen below:

Property List

   Name    Description
 ActualInfo Gets information about the updates currently downloaded and installed.
 Author Represents an optional information about the author of the program.
 BatchSize Specifies the size of the transferred batch.
 Email Represents an optional information about the author's e-mail.
 NeedShowInfo Specifies whether the WebUpdate should display the pop-up dialog box with the information about the available updates.
 Password Specifies the password that allows the WebUpdate to log on to the server.
 ProductName Represents an optional information about the product name.
 ProductURL Represents an optional information about the product WebSite URL.
 UpdateDir Specifies the destination folder to which the updates will be downloaded.
 UpdateInfo Gets the information about the updates available on the server.
 UpdateURL Specifies the URL path to the XML document which contains information about the updates available on the server.
 UserName Specifies the user name that allows the WebUpdate to log on to the server.
 VersionFormat Specifies the update version format.

Method List

   Name    Description
 Start Starts the updating process.
 Stop Stops the retrieving and installing the Web updates.

Event List

   Name    Description
 OnAfterDownload Occurs when the next update file has been downloaded from the server.
 OnDownloadProgress Occurs when a batch of update file content is received.
 OnError Occurs when an error is encountered when any action is performed.
 OnNoUpdatesFound Occurs when the WebUpdate component has detected that there are no new updates available on the server.
 OnRunUpdate Occurs when the component needs to run the downloaded update in order to install files available in this update.
 OnShowInfo Occurs when the WebUpdate component is about to display information about the available updates.
 OnTerminating Occurs when one of the update items needs to close the main application in order the update installation to be completed.

    Copyright © 2000-2021