InstallerBuilder Panels - Maple Help

Online Help

All Products    Maple    MapleSim


Home : Support : Online Help : Configure Maple : Customize the Maple System : Creating Installers for Maple Toolboxes : InstallerBuilder/General/Panels

InstallerBuilder Panels

  

This help page describes the built-in panels in installers generated by the InstallerBuilder.

  

The panels are presented in order of appearance in the installer.  If a panel is disabled (either by default or by setting its 'active' option to false), then the installer proceeds to the next active panel.

General Panels

  

 

  

Welcome

  

This panel is a simple welcome window, which can contain an image or text. By default, it is active.

  

 

  

Validation

  

This panel requests that the user enter a code that is validated before installation continues. To validate the user code, you must specify a validate option (see InstallerBuilder Options).

  

In the validator procedure, you can access the user's input with the command ToolboxInstaller:-Data:-Get("validation_attempt"). For more information, see ToolboxInstaller:-Data.

  

By default, this panel is disabled.

  

 

  

License

  

This panel requests that the user accept a license agreement before continuing with installation. By default, it is disabled.

  

 

  

Is Network Installation

  

This panel asks the user whether to install the network or single-user version of the toolbox. Note: The network toolbox installation can be installed only with the network version of Maple.

  

You can access the user's selection afterwards using ToolboxInstaller:-Data:-Get("network_installation"). For more information, see ToolboxInstaller:-Data.

  

By default, this panel is disabled and the single-user version is installed.

  

 

  

Is System Installation

  

This panel asks the user to specify one of two locations on disk in which to install the toolbox: a local installation or a system installation.

  

A local installation corresponds to the directory maple/toolbox in the user's home directory, while a system installation corresponds to the directory toolbox in the Maple directory.

  

You can access the user's selection afterwards using ToolboxInstaller:-Data:-Get("system_installation"). For more information, see ToolboxInstaller:-Data.

  

By default, this panel is disabled and a local installation is performed.

  

 

  

Installation

  

This panel reports on the actual installation of the toolbox. It displays a summary of the files extracted and installed, and a status message indicating the success of the installation. By default, it is active.

  

 

  

Finish

  

This panel is a simple concluding window, which may contain an image or text.  This is frequently used to indicate a successful installation and advise users on the use of the installed toolbox. By default, it is active.

Examples

Build a toolbox installer that installs only after the secret code "My Secret Code" has been entered by the user.

withInstallerBuilder:

Build( "SampleToolbox",
    'uninstaller' = false,
    'author'      = "Some Maple User",
    'welcome'     = ['text' = "Welcome to the SampleToolbox installer"],
    'validation'  = [
         'text'     = "Enter the code below:",
         'validate' = proc()
              local code;
              code := ToolboxInstaller:-Data:-Get("validation_attempt");
              if code = "My Secret Code" then
                  true
              else
                  false
              end if;
         end proc
    ]
);

See Also

InstallerBuilder, InstallerBuilder Options


Download Help Document

Was this information helpful?



Please add your Comment (Optional)
E-mail Address (Optional)
What is ? This question helps us to combat spam