Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 3 Current »

To create applications that run outside Oasis montaj, you can choose to depend on an installed "Geosoft Desktop" environment, or you can provide a set of Geosoft redistributable files with your application distribution.  The following provide details for either case.

Applications that depend on a "Geosoft Desktop" installation

If your application targets Geosoft users, which is the most common case, we recommend that your application be dependent on a properly installed version of the Geosoft Desktop, which is available to both subscribed Geosoft users and un-subscribed users who use the Geosoft viewer. In either case, you and your users can obtain the latest version of Geosoft Desktop from the Geosoft download page (https://my.geosoft.com/downloads).

To establish the dependency on Geosoft Desktopgeosoft.key file needs to be present next to your application files.  The geosoft.key contains a single text line with the text "Core" (or "Core - Testing" if you have a testing version of Geosoft installed). When your program runs we use the name in the geosoft.key file to identify the installation from the registry section HKEY_LOCAL_MACHINE\SOFTWARE\Geosoft.

If you or your user experience an error "Geosoft: Error loading Geodist.dll.", this means that the geosoft.key file does not point to the correct registry key.

Applications that distribute the Geosoft redistributables

Should you application not require any licenced capabilities from the GX API, you may also distribute your application as a completely independent application.  In this case your application must install all the files from <Program Files>\Geosoft\GX Developer\apps\redist\bin right next to the binaries that would be making use of the API externally.  Your application will also need to install and/or check for the following 3rd party redistributables.

 

Redistributable

Description

Microsoft Visual Studio 2013 Redistributable Package

DLL’s that provides the C Runtime functions, MFC and STL functionality on which the Geosoft dll’s rely. Available from here.

Both the x86 and x64 redistributions are needed to support 64-bit Python development.

Microsoft .Net 4.5.2 Framework

Found here.

Note that the “app” methods in the GX API are a special group that are normally dependent on running Geosoft Desktop.  If your application requires any of these functions you should install dependent on an properly installed Geosoft Desktop application.

Registry for stand-alone installations

If no registry settings are used the folder where the files are installed should be writeable to the Windows user as temporary files and a user folder will be created in this folder.  

You may also use registry settings to register specific directories where temporary files and user directories will be located. With your application you can include a file named geosoft.key, which will contain a single text line that with your application name, say "{MyApp}".  In the Windows registry, under HKEY_LOCAL_MACHINE\SOFTWARE\Geosoft\{MyApp}, create a key "Environment".  This registry key can be used to identify the location of various files for your application:

GEOSOFT     Where the contents of the GeosoftFiles directory is (which can be omitted if next to the application).

GEOSOFT2    Where all user files will be placed.

GEOTEMP     Where all temp files will be placed.

Should you run into DLL dependency challenges we recommend the depends.exe utility for debugging any dll dependency problems (see http://www.dependencywalker.com/ ).

 

  • No labels