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.
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:
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.
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.
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.
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
%LOCALAPPDATA%\TatukGIS\DK for Delphi.xyz\License
. The path to this folder is automatically added to the search path of the IDE.
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.
There are three ways to download and install the TatukGIS Developer Kernel for .NET. Choose the method that best fits your needs:
Use this method for fast and easy installation without additional features.
Use this method to easily download unstable and daily versions of the SDK.
nuget sources Add -Name "TatukGIS" -Source https://nuget.tatukgis.com/nuget
nuget sources Update -Name "TatukGIS" -Source "https://nuget.tatukgis.com/nuget" -UserName "your login email" -Password "your new password"
Use this method for a full installation including all deployment files, samples, documentation, and setup options.
%LOCALAPPDATA%\TatukGIS\DK for .NET\Lib\net45
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:
c:\Program Files (x86)\TatukGIS\DK for .NET\Lib
%LOCALAPPDATA%\TatukGIS\DK for .NET\License
//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" )
To enable optional SKIA rendering, the project must include the NuGet package SkiaSharp (NuGet Gallery | SkiaSharp).
To enable optional SKIA rendering, the project must include the NuGet package SkiaSharp (NuGet Gallery | SkiaSharp).
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.
Every file connected with the Developer Kernel software for Java is installed in the path:
%LOCALAPPDATA%\TatukGIS\DK for Java\
~/TatukGIS.DK for Java/
To add our Controls to NetBeans IDE, you need to:
%LOCALAPPDATA%\TatukGIS\DK for Java\License\GisLicense.txt
or
%LOCALAPPDATA%\TatukGIS\DK.Java\License\GisLicense.txt
$/TatukGIS/DK for Java/License/GisLicense.txt
or
$/TatukGIS/DK.Java/License/GisLicense.txt
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 ... }
Samples can be opened and run using NetBeans, Eclipse, or IntelliJ IDEA. Do not change the folder organization!
%LOCALAPPDATA%\TatukGIS\DK for .ActiveX\License\GisLicense.txt
(new TGIS_Utils()).SetLicense(license_activation_code);
pip install tatukgis_pdk
https://pypi.tatukgis.com/packages/unstable/simple/
https://pypi.tatukgis.com/packages/daily/simple/
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.
The product is available free of charge - activation is not required.