Upgrade Instructions

From HTML5 Builder
Jump to: navigation, search

You can safely install HTML5 Builder in a system where a previous version (e.g. RadPHP XE2) is already installed. The previous version of the application will remain intact after the installation of HTML5 Builder, and you will be able to work with both applications.

To install an HTML5 Builder update:

  1. Uninstall your current HTML5 Builder installation.

    Note: Your projects folder will not be removed during this step.

  2. Install new HTML5 Builder update.

    Warning: Do not reinstall the TeeChart components if they were already installed, since the HTML5 Builder uninstaller does not remove them, and you will end up with duplicated entries in the registry.

Android Tools

If you installed Android tools already, you do not need to install them and uninstall them again. They will work just fine. You can upgrade Android SDK if you want to, though.

Mobile Device Backgrounds

If your HTML5 Builder upgrade includes new mobile device backgrounds for the Designer, they will not be loaded by default. If you want to use them, restore defaults.

RPCL API Changes

5.1

  • ImageList
    • The readImage() method was renamed to retrieveImage().
    • The readImageByID() method was renamed to retrieveImageByID().
  • MSlider
    • The ReadOnly property is not available anymore, to comply with the HTML standard.
  • MDBTransaction
    • The JavaScript function to run the transaction is no longer named ComponentNameTransaction(), but ComponentNameRunTransaction(), to avoid conflits with the default event names of client applications.

Help Resources

Frequently Encountered Problems

TeeChart Issues

If you installed the TeeChart components more than once (e.g. you installed them with an HTML5 Builder update and had installed them already), you will end up with duplicated entries for their components package in the HTML5 Builder registry. You will have to edit the registry to remove one of the two entries in HKEY_CURRENT_USER\Software\Embarcadero\HTML5 Builder\6.0\packages that point to the TeeChart package file.

Warning: Edit Windows Registry at your own risk. We recommend that you use the Microsoft Regedit tool to perform the edition. Whatever tool you use, however, you should, before making any changes, make backups of your registry and thoroughly familiarize yourself with the editing tool and the registry editing process. The registry is a critical component of your operating system, and any mistakes you make while editing it can prevent your computer from working.