Navigation:  »No topics above this level« Deployment

To distribute your DPLOTLIB-enabled application to others, you will as a minimum need the following files (in addition, of course, to your own program):

DPLOTLIB.DLL: Install to your application folder.

With DPlot Jr

All of these files are located in the folder where you initially installed DPlot Jr. These five unmodified files must be included in your distribution; DPlot Jr will not work correctly without them. Each of these files should be installed to the same folder on the end user's system. It is not necessary to install these files to your application's folder. Generally a subfolder below your application folder is best.

Your application's installation procedure should make a change to the end user's registry that tells DPLOTLIB.DLL (and possibly your own application) where to find DPlot Jr:

HKEY_CURRENT_USER\Software\DPLOTJR\shell\open\command

Data Type=REG_SZ

Value = path to DPlot Jr, including the filename

For example, the following is the section of the setup script for Inno Setup that modifies the end user's registry:

[Registry]

Root: HKCU; Subkey: "Software\DPLOTJR\shell\open\command"; ValueType: string; ValueData: "{app}\DPLOTJR.EXE"; _

 Flags: uninsdeletekey

DPlot Jr will itself update the registry with its own location every time it runs. The above change ensures that your application and/or DPLOTLIB can find DPlot Jr before it ever runs on the end user's system. Note that the path should be surrounded by double quotation marks (handled automatically by Inno Setup). Otherwise if the path contains a space (as in c:\Program Files), your program's attempts to launch DPLOTJR.EXE will likely fail.

When testing your setup program you should ensure that the correct path was written to the registry. Using regedit after running your setup program you should now have HKEY_CURRENT_USER\Software\DPLOTJR\shell\open\command with the Name left at (Default), the Type set to REG_SZ, and the path to DPLOTJR.EXE, surrounded by double quotation marks, under Data.

For multiple-account systems

Note that this registry change does not require administrative privileges on any version of Windows, so a user with a limited account can run your setup program (assuming no other features of your setup require admin privileges) and DPLOTLIB.DLL will successfully find DPLOTJR.EXE. However, if your program is installed to a system with multiple users, then DPLOTLIB.DLL will only find a non-running DPLOTJR.EXE when running under the account of the user who installed the application. If it is important that all users be able to run your application, substitute HKEY_LOCAL_MACHINE for HKEY_CURRENT_USER in the notes above (or add both keys). Of course this will mean that a user with an administrative account must install your application. Also, DPLOTJR.EXE does not write to the HKEY_LOCAL_MACHINE hive, so you cannot depend on the end user to run DPLOTJR.EXE in order to set the appropriate registry key - this step must be performed by your install program.

With the full version of DPlot

Detailed instructions are provided with a developer license. Contact HydeSoft Computing at support@dplot.com for details.

 

 

 

---

Page url: http://www.dplot.com/lib/index.htm?deployment.htm