After you add code to handle all the tasks you want your program to perform, you are ready to test and deploy your program. Here are some things you must keep in mind when building your installation program.
When you distribute your software program that you created using ScanTools
Plus Link SDK, you must publish the following statements regarding Scantron
ScanToolsâ Plus Link SDK
Copyright ã 200
ScanToolsâPlus
Copyright ã 200
ImageGear © 1996-2004. All Rights Reserved.
Each personal computer that uses the scanning services or data services
of ScanTools Plus Link must have the ScanTools Plus Link Runtime files
installed on it, and the component of your solution program that communicates
with it must also reside on the PC. In order to install ScanTools Plus
Link Runtime files, you must use
ScanToolsPlusLinkRuntime
When you install and remove your program, you must call ScanToolsPlusLinkRuntimeInstaller.exe from your installation to properly install or remove the ScanTools Plus Link Runtime files. This is required, and is the only way to properly manage the ScanTools Plus Link Runtime files needed by your solution program.
ScanToolsPlusLinkRuntimeInstaller.exe automatically registers ScanTools Plus Link COM components on the local PC.
ScanTools Plus Link Runtime files are shared by all ScanTools Plus Link solution programs installed on the same personal computer.
ScanToolsPlusLinkRuntimeInstaller requires
the user to have Administrator rights.
New versions of the ScanTools Link SDK and ScanTools Link Runtime was created for version 7.2. The Runtime installer is decoupled from the SDK installer, allowing you to remove the program directly from Add/Remove programs without going through the C++ wrapper program used in previous versions. Reference counting has also been removed. Removing the reference counts eliminates the problems with reference counts getting out of sync that prevented installing or removing the Runtime files without a registry tweak. However, if you explicitly choose to remove the Runtime files, any remaining applications on the PC that use the Runtime files will no longer work. A warning message will be displayed at removal, but will be suppressed if the uninstallation is run silently.
The ScanToolsPlus Link Runtime files can be removed with Add/Remove Programs or through the command-line. It can be run with the full user-interface displayed or silently. Removal of the Runtime files from the PC will cause any other ScanTools Plus Link SDK applications to no longer work.
Beginning with version 8.0, the installation will automatically upgrade older versions of the Runtime files to the current version and prevent older versions from installing over a newer version. This does not apply to version 7.2.
If version 7.2 of the Runtime files are being used, the existing version should be checked by querying the DisplayVersion registry value in HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\{D9E2A31D-01DB-4BC4-A5CF-9B03F14BA8A7} to ensure that newer files are not being overwritten.
You can still install and uninstall the Runtime files silently, however the installer now uses standard InstallShield switches. The Runtime installer will behave as if it is a first-time installation every time, unless the user specifically initiates the uninstall through Add/Remove Programs or a command-line call to the uninstaller. The specific parameters are detailed below. The 2 .iss files are included with the SDK installation and install to the /redist folder.
You can install and uninstall the Runtime files silently using standard InstallShield and MSI switches. The install will upgrade a version 7.2 installation of the Runtime files automatically. The examples below apply only to ScanTools Plus Link Runtime version 8.0 or later. These examples will not work with earlier versions.
Install:
<DRIVE>:\PATH\ScanToolsPlusLinkRuntime.exe /v/qb! – runs the installation, using /v (no space after) to pass the /qb! switch to the internal MSI installation. The /qb! switch runs the installation silently and suppresses all user-interface with the exception of errors encountered during the install.
<DRIVE:\PATH\ScanToolsPlusLinkRuntime.exe /s /f1”<Path to Install.iss file>”
Uninstall:
<DRIVE:>\PATH\ ScanToolsPlusLinkRuntime.exe /x – uninstalls the current installation associated with ScanToolsPlusLinkRuntime.exe
<DRIVE:\PATH\Controls.exe /a /s /x /f1”<Path to Uninstall.iss file>”
Switches:
Any standard MSI switch combination can be used.
/s run silently
/a run in administrator mode
/x uninstall
/f1 specifies the .iss file used to make silent install/uninstall possible
NOTE: In the examples above, there is no space between the /f1 and the path to the .iss files. The silent install/uninstall will fail if a space is entered.
If your solution program is a .NET solution, the .NET framework must be installed on the system before installing ScanTools Plus Link Runtime and your program.
The text file for ScanFlex use is no longer handled by installation and is now handled within the code.
Runtime Files Installed with Your Program
ScanTools Plus - Multiple Copies Running
|
See Help on Help for additional information on using this help file. See Scantron Technical Support for additional information on technical support and training options. See the ScanTools Suite System Requirements for further details on hardware and software requirements. ScanTools is a suite of products; the specific information you want may appear in the help for a different module. If you don't find what you're looking for here, try one of the following:
|
Scantron Corporation
Customer Service (forms, products, and services): 1-800-SCANTRON (722-6876) Technical Support: 1-800-445-3141 |
|
|
Copyright © 1998-2012 Scantron Corporation. All rights reserved. Use permitted only under license. www.scantron.com. No part of the Help or user guides may be reproduced in any form, or by any means, without express permission from Scantron Corporation. LINKS TO THIRD PARTY SITES This help system may contain links to third party websites ("Linked Sites"). The Linked Sites are not under the control of Scantron and Scantron is not responsible for the content of any Linked Site, including without limitation any link contained in a Linked Site or any changes or modifications to a Linked Site. Scantron is not responsible for web casting or any other form of transmission received from any Linked Site. Scantron provides Users with the ability to link the Assessment System to the Linked Sites as a convenience to you, and the inclusion of any link does not imply endorsement by Scantron of the Linked Site or any association with its operators. |
||