User Tools

Site Tools


guides:setup

Installation & Activation

Documentation | Installation & Activation

IMPORTANT TROUBLESHOOTING UPDATE
If you are having issues with the Activation Wizard not displaying on the first debug app run, try the following potential fixes:
* Make sure that GisLicense is NOT referenced in your project before the first app run (e.g., through the “uses GisLicense” import).
* Remove older registry entries from Computer\HKEY_CURRENT_USER\Software\TatukGIS and reinstall DK.

Setup

This page provides setup information for versions 100 and later. Please refer to the Installation & Activation (Version 99 and earlier) page for installation instructions for legacy versions.

All versions of the Developer Kernel share the same setup logic:

  1. Download the software
  2. Upon downloading, an email with a subject similar to “TatukGIS: Serial Number for TatukGIS DK” is sent to the licensed user's registration email address.
  3. Enter the received serial number when prompted upon running the product setup.
  4. When asked for Create desktop item, we suggest leaving this box checked. The setup will then create a shortcut on the desktop, providing easy access to the Developer Kernel folders.

Activation

Overview

The Developer Kernel requires activation before it can be used.

The Activation Wizard will appear automatically the first time any code using Developer Kernel is executed with a debugger attached.

This process validates your license and generates a GisLicense file necessary for running applications without a debugger.

Activation with Debugger

Open your development environment (e.g., Visual Studio, Rad Studio) and run the application that integrates Developer Kernel with the debugger attached.

The Activation Wizard will launch automatically on the first run. Enter your License Code when prompted. Once validated, a GisLicense file will be generated and saved within your user directory.

After activation, Developer Kernel will be fully functional for development purposes. Developer Kernel stores a run-time license in a registry so the product can be used out of the box without any special treatment.

Running Without Debugger and Deployment

To run an application that uses Developer Kernel without a debugger or deploy it on another machine, a valid license code must be embedded within the application's code.

A GisLicense file, used for license embedding, is automatically created during the activation process when the application is run with the debugger attached.

For platform-specific instructions, please refer to the relevant sections: Delphi Specific, .NET Specific, ActiveX Specific, and Java Specific.

Delphi Specific

Setup

The setup creates all required paths within IDE. So, starting to use the Developer Kernel should be effortless.

Users of the source code compile runtime packages on-demand and set environment paths using Developer Kernel Source Code Manager for Delphi

Embedding license

  1. Files with license code can be found in a program group and are typically located at
    %LOCALAPPDATA%\TatukGIS\DK for Delphi.xyz\License

    . The path to this folder is automatically added to the search path of the IDE.

  2. If you are a Delphi developer, then add a GisLicense.pas to your Delphi uses (preferably on your application's main form)
  3. If you are a C++Builder developer, add GisLicense.hpp as one of the first included headers on your main form code.

Skia rendering

To enable optional SKIA rendering, right-click and choose “Enable Skia”. If used RAD Studio does not contain Skia support - install it from GetIt or directly from skia4delphi.org.

.NET Specific

Installation

There are three ways to download and install the TatukGIS Developer Kernel for .NET. Choose the method that best fits your needs:

Method 1: Using NuGet Manager in Visual Studio (Standard NuGet Feed)

Use this method for fast and easy installation without additional features.

  • Open your project in Visual Studio.
  • Right-click on the Solution in the Solution Explorer and choose Manage NuGet Packages.
  • In the Browse tab, search for TatukGIS.
  • Select the appropriate package and click Install.
  • The package will be downloaded from the public NuGet Gallery and referenced in your project automatically.
  • Note:
    • Always save your project as a solution (.sln). Otherwise, the NuGet Package Manager will not open correctly.
Method 2: Using the TatukGIS NuGet Server

Use this method to easily download unstable and daily versions of the SDK.

  • Open Visual Studio or use the NuGet CLI (Command Line Interface).
  • Add the TatukGIS NuGet source:
  • Provide your TatukGIS credentials when prompted.
  • If you need to change stored credentials later, run:
    nuget sources Update -Name "TatukGIS" -Source "https://nuget.tatukgis.com/nuget" -UserName "your login email" -Password "your new password"
  • Note:
    • Unstable versions are automatically removed after a retail version is released.
    • Daily builds are removed after an unstable or retail version is released.
    • Always save your project as a solution (.sln). Otherwise, the NuGet Package Manager will not open correctly.
Method 3: Downloading Full Installer from TatukGIS Website

Use this method for a full installation including all deployment files, samples, documentation, and setup options.

  • Download the setup installer (includes all deployment packages and grid-shift files) from official website: https://www.tatukgis.com/Downloads/DKforNET.
  • Run the installer and follow the instructions to complete the installation.
  • In your Visual Studio project, add a reference to freshly installed TatukGIS_DK11 dll. It is installed into following location by default:
    %LOCALAPPDATA%\TatukGIS\DK for .NET\Lib\net45

Setup

TatukGIS components should be visible in Visual Studio as soon as the assembly is referenced (a proper NuGet package added). If you do not use NuGet then:

  1. Run Visual Studio.
  2. Right click on a Toolbox, then choose Select Items …
  3. Click Browse in .NET Framework Components tab.
  4. Select TatukGIS_DK11.dll, which may be located in the installation folder (use the desktop icon to find it!), but may also be located in:
    c:\Program Files (x86)\TatukGIS\DK for .NET\Lib
  5. Click OK. Now the components should be visible in the Toolbox.

Embedding license

  1. Files with the license code can be found in the program group and are typically located at:
    %LOCALAPPDATA%\TatukGIS\DK for .NET\License
  2. Add GisLicense.cs or GisLicense.vb to your project.
  3. Before first use/initialization of the Developer Kernel (before calling InitializeComponents()), call:
    //C#
    static void Main()
    {
      TatukGIS.NDK.GisLicense.Initialize(); // <--- ADD THIS LINE
     
      Application.EnableVisualStyles();
      Application.SetCompatibleTextRenderingDefault(false);
      Application.Run(new WinForm());
    }
    'VisualBasic
    Shared Sub Main()
      TatukGIS.NDK.GisLicense.Initialize() '<--- ADD THIS LINE
     
      Application.EnableVisualStyles()
      Application.SetCompatibleTextRenderingDefault(false)
      Application.Run(New WinForm())
    End Sub
     
    'or create a New() procedure on the main form
    Public Sub New()
      TatukGIS.NDK.GisLicense.Initialize() '<--- ADD THIS LINE
     
      ' This call is required by the designer.
      InitializeComponent()
      ' Add any initialization after the InitializeComponent() call.
    End Sub
    // for other .NET languages run the code like this somewhere in the early 
    // stage of application initialization (before use of any GIS functionality)
    
    TatukGIS.NDK.TGIS_Utils.SetLicense(
      "content of the License - for example, copied for GisLicense.cs"
    )

Skia rendering

To enable optional SKIA rendering, the project must include the NuGet package SkiaSharp (NuGet Gallery | SkiaSharp).

ASP.NET Specific

Deploying

  • Typical deployment is just copying the app to the server.
  • Upon deploying the application remember to activate the application for a specific web address (eg. test.mydomain.com) and use aliases using Activate Deployment app, which is usually aceessible from the program icon on the desktop.
  • The created .license file must be copied to a bin folder (or app folder, in case it is on .NET Core).

Skia rendering

To enable optional SKIA rendering, the project must include the NuGet package SkiaSharp (NuGet Gallery | SkiaSharp).

ASP.NET Core Specific

NuGet

ASP.NET Core packages are available only via NuGet. To use them, a setup must first be used: activation, samples, and deployment packages (including grid-shift files), which are available only in regular setup files.

To access a NuGet repository with debug and unstable versions follow same steps as descriped for DK.NET.

Java Specific

Installation directory

Every file connected with the Developer Kernel software for Java is installed in the path:

  • Windows:
    %LOCALAPPDATA%\TatukGIS\DK for Java\
  • Linux/MacOS:
    ~/TatukGIS.DK for Java/

Setup

To add our Controls to NetBeans IDE, you need to:

  1. Open NetBeans designer
  2. Right-Click on the palette
  3. Select “Palette Manager…”
  4. Add “New category…”
  5. Name it, for example, “TatukGIS”
  6. Click “Add from Jar…”
  7. Select DK jar file located in catalog lib in the installation path
  8. Select “Show Marked JavaBeans”
  9. Select all controls
  10. Click next
  11. Select a category in which you want the controls to appear.
  12. Finish process

Embedding license

  1. Files with the license code can be found in the program group and are typically located at:
    • Windows:
      %LOCALAPPDATA%\TatukGIS\DK for Java\License\GisLicense.txt

      or

      %LOCALAPPDATA%\TatukGIS\DK.Java\License\GisLicense.txt
    • Linux/MaxcOS:
      $/TatukGIS/DK for Java/License/GisLicense.txt

      or

      $/TatukGIS/DK.Java/License/GisLicense.txt
  2. At application startup call:
    public static void main(String args[]) {
      // call it before calling and other TatukGIS code
      TGIS_Utils.SetLicense( "content of the License file" );
     
      // rest of the code 
      ...
    }

Running samples

Samples can be opened and run using NetBeans, Eclipse, or IntelliJ IDEA. Do not change the folder organization!

  • NetBeans:
    open the project and go to the samples directory.
  • Eclipse:
    Set workspace to samples directory, then select “Open Projects from File System”.
  • IntelliJ IDEA:
    Select “Import Project” at the startup window, and leave defaults options in the wizard dialog. Go to “Project Structure” in the File menu and, in the “Libraries” section, add tatukgis.jdk.jar from <installation-folder>\Lib\

ActiveX Specific

Embedding license

  1. Files with license code can be found in the program group and are typically located at:
    %LOCALAPPDATA%\TatukGIS\DK for .ActiveX\License\GisLicense.txt
  2. Before first use/initialization of the Developer Kernel (preferably just in your app main() procedure), execute code similar to:
    (new TGIS_Utils()).SetLicense(license_activation_code);

Python Specific

PyPi

  • Retail distribution packages:
    • availably free of charge on PyPu use:
      pip install tatukgis_pdk
  • Unstable distribution packages:
  • Daily distribution packages:
  • Unstable versions are removed from the archive after releasing a Retail version;
  • Daily versions are removed from the archive after releasing a Unstable or Retail version.

When using UNSTABLE or DAILY builds in the PyCharmelect Basic Authentication and carefully provide credentials. Improper credentials can cause a ban for several minutes because PyCharm frequently uses them.

Activation

The product is available free of charge - activation is not required.

2025/04/25 14:32

Page Tools