HTML Executable allows you to add a Web Update feature to your publications and ebooks: when you release a new version, the Web Update feature can automatically download it from your web server, and safely install it. This allows your end users to always stay with the latest version and easily upgrade your publication when you release a new version.
No third-party software is required. However, you need a web server to host web update files generated by HTML Executable.
Watch our video tutorial of the Web Update feature on our ebook Web Update tutorial page.
The Web Update process happens in several steps. Step 1 is obtaining the control file (.INF file) from your web hosting server (HTTP/HTTPS based location). The next step is the processing of the .INF file by verifying new files, new versions and if necessary downloading the files. Update files that are not part of the publication running process (.EXE, .DLL’s) can be immediately extracted to the proper location. If necessary, in the last step, the publication is closed, the new EXE and/or DLL files are extracted and the publication’s new version is automatically restarted.
You can configure your publication or ebook to automatically check for updates at publication startup or add a “Check for Updates” menu command to your publication.
It is also possible to trigger a check for updates thanks to a script call: you can call the HEScript script function named
When a new version is detected, end users are informed and guided through the Web Update wizard:
They can choose to install or not the update.
The EXE Version number specified in the Icon / Version page of HTML Executable is used to determine whether an upgrade is necessary or not. So be sure to increase the Version number when you release an update of your publication / ebook.
All files necessary for the web update (control and CAB files) must be made available for download through HTTP. You must give HTML Executable the base URL to the location of all Web Update files hosted on your web server.
For instance, enter
Secure HTTPS URLs can be used.
The control file (.INF format) contains necessary instructions and data about the web update. It’s the file that the publication will download first.
Provide the path to the folder on your local disk where HTML Executable will generate web update files. The entire contents of the folder must then be uploaded to your web host (for instance, you can do it with a FTP client) and made available at the base URL specified above.
The destination folder should be empty. If it is not empty, you’ll be asked whether you want to delete its contents before generating files.
The news that you may want to display to your end users on the Web Update Wizard (see screenshot above) when a new upgrade is available.
To put a carriage-return-line-feed between “Line 1” and “Line 2”, insert
\n, such as
Allows the publication to check for updates at startup without user interaction. The Web Update Wizard is only displayed if a new version is detected.
HTML Executable will generate all files necessary for the web update (control and CAB files) in the local destination folder. You can then upload these files to your web host.
There are two types of files:
The .CAB file is a standard Microsoft Cabinet file. You can open/edit it with 7-Zip for instance if you want to add more files.
When the publication is restarted after a successful web update, you may want to show a message or a web page to your end users. HTML Executable sets the global variable
1 after a successful web update, which allows you to perform the actions you want thanks to HEScript scripting.
For instance, go to the Script Manager, double click on “UserMain” and copy/paste this script in the OnStartMainWindow event:
procedure OnStartMainWindow; begin // When the main window is going to be displayed (just before the homepage is shown). if GetGlobalVar("herestartwebupt", "0") = "1" then begin ShowMessage("Welcome to your new publication!"#13#10"What's new:"); end; end;
#13#10 characters inserts a new line.
It’s also possible to show a custom dialog box.
hecustomuwbillboard.bmpin the publication root folder.
Copyright G.D.G. Software 2016. All rights reserved