|
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:
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. |
|
Name
|
Description
|
|
Start |
Starts the updating process. |
|
Stop |
Stops the retrieving and installing the Web updates. |
|
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. |
| 
