User Tools

Site Tools


guides:deploy

Deploying an application

Documentation | Deploying

Standard application

By default, TatukGIS contains all general purpose layers and functionality built-in. It means that is not required to deploy any other library and DK built an application is self-contained.

  • Delphi
    just deploy the executable file. If the application is built with runtime packages, then required .bpl file must also be deployed,
    • iOS & Android
      just compile an application,
  • .NET
    just deploy the executable file and TatukGIS library assembly (usually TatukGIS_DK11.dll),
    • ASP.NET
      just deploy the application and the TatukGIS library into bin/ folder,
  • JAVA
    just deploy the executable file and TatukGIS library .jar (usually TatukGIS_DK11.jar),
  • ActiveX
    just deploy the executable file and register the TatukGIS library .ocx (usually TatukGIS_DK11.ocx); a side-by-side ocx is possible in Visual Studio.

3rd party libraries

It is sometimes required to deliver 3rd party libraries like ECWE, MrSID. SQLITE etc.

On Windows operating system libraries can exist in 32bit and 64bit version. As long as the application will run only in 32- or in 64- bits mode libraries can be simply deployed to the same folder as an application.

  • iOS
    SQLite library provided for iOS is a universal (both 32- and 64- bit) library and should be deployed to the same folder as an application.
  • JAVA
    Use TGIS_Utils.SetLibrariesSearchPath method to define the search path for the library other than standard.
  • ActiveX
    Deployment must be relative to the folder with the TatukGIS .ocx file.

Things are a bit more complicated if the application is deployed as 32-bit and 64-bit enabled (e.g. .NET app). Then libraries should be placed in an x86/ and x64/ subfolders. An application uses a proper version of library depending on a mode of execution. Those folders can also be used in Delphi apps. For example, our Editor/Viewer has two executables: one for 32-bit and one 64-bit application. Both are deployed to a single folder with x86/ and x64/ subfolders for 3rd party libraries.

Be aware that some 3rd party libraries require a specific version of Microsoft Visual C++ Redistributable Package and application setup procedure should ensure that a proper version is installed.

Grid shift files

Generally, all datums projections etc., are included in a library. However, sometimes local grids shift files are required. Due to size, those files must be deployed individually.

Grid shift files, if required. should all be deployed to Datums subfolder (see also Grid Shifts Files).

Folders layout

Final application folder structure can be simillar to:

+--app
    |
    +-- x86
    |
    +-- x64
    |
    +-- Datums

Where:

  • app
    application folder
    • for Delphi and .NET, and Java application is is a folder with an application executable file;
    • for ASP.NET it is bin/ folder;
    • for ActiveX application it is a location of TatukGIS ocx. file;
    • third party libraries can be placed here as long as they use same target architecure (double-check your .NET application to use specific “Platform target” ).
  • x86
    folder with 32-bit specific libraries
    optional
    not applicable on iOS or Android,
  • x64
    folder with 64-bit specific libraries
    optional
    not applicable on iOS or Android,
  • Datums
    folder with grid shift files
    optional.
2019/01/23 13:44