Installation & Activation

Documentation | Installation & Activation

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 DK11” 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. Then the setup will create a shortcut on the desktop providing easy access to the Developer Kernel folders.

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:

1. Quit this setup.
2. Create a shortcut to your RAD Studio and change Target similar to:
   

   "c:\Program Files (x86)\Embarcadero\Studio\18.0\bin\bds.exe" -rDK11

3. Start RAD Studio from the link at least once so RAD Studio will create all required registry keys.
4. Run setup again providing additional parameter:
   

   /customreg=DK11

5. Now all the DK11 stuff will be installed only in this dedicated environment.
6. If you want to revert and install in a regular environment, delete the registry entry like this one:
   

   HKEY_CURRENT_USER\SOFTWARE\Embarcadero\DK11\18.0

1. Files with license code can be found in a program group and are typically located at:

   %USERPROFILE%\Documents\TatukGIS\DK11 for Delphi.xyz\Licenses

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 header on your main form code.

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.

• NuGet retail distribution Packages:
  • add a NuGet source https://nuget.tatukgis.com/nuget directly from Visual Studio,
  • or run a command-line utility:
    • download NuGet command line from https://dist.nuget.org/win-x86-commandline/latest/nuget.exe
    • and execute:

      nuget sources Add -Name "TatukGIS" -Source https://nuget.tatukgis.com/nuget

  • provide your TatukGIS credentials upon request.
• Trial packages are available from the official nuget.org feed.
• .NET Core & Standard packages are available only via 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:

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 desktop icon to find it!), but usually is located in:
   

   c:\Program Files (x86)\TatukGIS\DK11 for .NET\Lib

5. Click OK. Now the components should be visible in the Toolbox.

Please note, that if you add a NuGet package then those steps are not required - toolbox will be automatically updated (at least in VS2019).

1. Files with license code can be found in the program group and are typically located at:

   %USERPROFILE%\Documents\TatukGIS\DK11 for .NET\Licenses

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 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"
   )

• Typcially deployment is just copying app to the server.
• Upon deploying application remember to activate application for specific web address (eg. test.mydomain.com) and used aliasses using Activate Deployment app which is usaually aceessible from the program icon on the desktop.
• Created .license file must be copied to a bin folder (or app folder in a case on .NET Core).

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.

• NuGet retail distribution Packages:
  • add a NuGet source https://nuget.tatukgis.com/nuget directly from Visual Studio,
  • or run a command-line utility:
    • download NuGet command line from https://dist.nuget.org/win-x86-commandline/latest/nuget.exe
    • and execute:

      nuget sources Add -Name "TatukGIS" -Source https://nuget.tatukgis.com/nuget

  • provide your TatukGIS credentials upon request.
• Trial packages are available from the official nuget.org feed.

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

• Windows:

  %USERPROFILE%\Documents\TatukGIS\DK11 for Java\

• Linux/MacOS:

  ~/TatukGIS.DK11 for Java/

To add our Controls to NetBeans IDE you need to:

1. Open NetBeans designer
2. Right-Click on the pallette
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

1. Files with license code can be found in the program group and are typically located at:
   • Windows:
     

     %USERPROFILE%\Documents\TatukGIS\DK11 for Java\GisLicense.txt

   • Linux/MaxcOS:
     

     $/TatukGIS/DK11 for Java/GisLicense.txt

2. At application startup call:

   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!

• NetBeans:
  Just 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 startup window, and leave defaults options in the wizard dialog. Go to “Project Structure” in File menu and, in “Libraries” section, add tatukgis.jdk.jar from <installation-folder>\Lib\

1. Files with license code can be found in the program group and are typically located at:

   %USERPROFILE%\Documents\TatukGIS\DK11 for .ActiveX\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);