Documentation | Installation & Activation
All versions of the Developer Kernel share the same setup logic:
The Developer Kernel must be activated to be used. Typically, setup asks to perform activation as the last step of the installation, but you can also do this anytime by selecting activation from the program group.
For debugging purposes, the Developer Kernel stores run-time license in a registry so the product can be used out of the box without any special treatment.
For deploying on other machines or running app without a debugger, license codes must be embedded into the application. Please see Delphi Specific, .NET Specific, ActiveX Specific, and Java Specific sections for details.
The setup creates all required paths. So, starting to use the Developer Kernel should be effortless. Please, however, ensure that you do not mix the DK11 and a previous DK version on the same environment, which can result in selecting an improper version of the library.
There is a way, however, to run the DK11 in a separated environment:
"c:\Program Files (x86)\Embarcadero\Studio\18.0\bin\bds.exe" -rDK11
/customreg=DK11
HKEY_CURRENT_USER\SOFTWARE\Embarcadero\DK11\18.0
%USERPROFILE%\Documents\TatukGIS\DK11 for Delphi.xyz\Licenses
An easy way to update just assemblies is to use NuGet packages (including Unstable). To use them a setup must be used first. Then switching between versions is provided via NuGet. Keep in mind, that activation, samples, and deployments packages (including grid-shift files) are available only in regular setup files.
https://nuget.tatukgis.com/nuget
directly from Visual Studio,nuget sources Add -Name "TatukGIS" -Source https://nuget.tatukgis.com/nuget
For a number of reasons (e.g., somewhat tricky setup routines), we do not automatically add the Developer Kernel into Visual Studio toolbox. To do this manually:
c:\Program Files (x86)\TatukGIS\DK11 for .NET\Lib
Please note, that if you add a NuGet package then those steps are not required - toolbox will be automatically updated (at least in VS2019).
%USERPROFILE%\Documents\TatukGIS\DK11 for .NET\Licenses
//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 at the early // stage of application initialization (before use of any GIS functionality) TatukGIS.NDK.TGIS_LicenseManager.SetLicense( "content of the License - for example, copied for GisLicense.cs" )
ASP.NET Core packages are available only via NuGet. To use them a setup must be used first: activation, samples, and deployments packages (including grid-shift files) are available only in regular setup files.
https://nuget.tatukgis.com/nuget
directly from Visual Studio,nuget sources Add -Name "TatukGIS" -Source https://nuget.tatukgis.com/nuget
Every file connected with the Developer Kernel software for Java is installed in path:
%USERPROFILE%\Documents\TatukGIS\DK11 for Java\
~/TatukGIS.DK11 for Java/
To add our Controls to NetBeans IDE you need to:
%USERPROFILE%\Documents\TatukGIS\DK11 for Java\GisLicense.txt
$/TatukGIS/DK11 for Java/GisLicense.txt
public static void main(String args[]) { // call it before calling and other TatukGIS code TGIS_LicenseManager.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!
%USERPROFILE%\Documents\TatukGIS\DK11 for .ActiveX\GisLicense.txt
(new TGIS_Utils()).SetLicense(license_activation_code);