User Tools

Site Tools


guides:setup

Installation & Activation

Documentation | Installation & Activation

Setup

All versions of Developer Kernel share,s 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 going to be sent to the client.
  3. Enter the received serial number when prompted upon running setup product.
  4. When asked for Create desktop item we suggest leaving this checked. Setup will create a shortcut on the desktop to easy access Developer Kernel folders.

Activation

Developer Kernel must be activated to be used. Typically setup asks to do this as the last step of the installation, but you can also do this anytime be selecting activation from the program group.

For debugging purposes 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 verify Delphi Specific, .NET Specific, ActiveX Specific, and Java Specific sections for details.

Delphi Specific

Setup

Setup creates all required paths. So starting to use the Developer Kernel should be effortless. Please, however, ensure that you are not mixing DK11 and previous version on the same environment, which can result in picking an improper version of the library.

There is a way, however to run DK11 in a separated environment:

  1. Quit this setup.
  2. Create a shortcut to your RAD Studio and change Target to similar to:
    "c:\Program Files (x86)\Embarcadero\Studio\18.0\bin\bds.exe" -rDK11
  3. Start RAD Studio form this 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 DK11 stuff will be installed only in this dedicated environment.
  6. If you want to revert and install in a regular environment, please delete registry entry like this one:
    HKEY_CURRENT_USER\SOFTWARE\Embarcadero\DK11\18.0

Embedding license

  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 main form)
  3. If you are a C++Builder developer, add GisLicense.hpp as one of the first includes on your main form code.

.NET Specific

Setup

For a number of reasons (a bit tricky setup routines) we do not add 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 is typically located in the installation folder (use desktop icon to find it!) but usually it is located in:
    c:\Program Files (x86)\TatukGIS\DK11 for .NET\Lib
  5. Click OK. Now components should be visible in the Toolbox.

Embedding license

  1. Files with licence code can be found in a program group and are typically located at:
    %USERPROFILE%\Documents\TatukGIS\DK11 for .NET\Licenses
  2. Add a GisLicense.cs or GisLicense.vb to your project.
  3. Before first use/initialization of the Developer - 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 languges 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"
    )

Java Specific

Instalation directory

Every file connected with our software for Java is installed in path:

  • Windows:
    %USERPROFILE%\Documents\TatukGIS\DK11 for Java\
  • Linux/MacOS:
    ~/TatukGIS.DK11 for Java/

Setup

To add our Controls to NetBeans IDE you need to:

  1. Open NetBeans designer
  2. Right-Click on the pallete
  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 instalation path
  8. Select “Show Marked JavaBeans”
  9. Select all controls
  10. Click next
  11. Select your new category, for us “TatukGIS”
  12. Finish process

Embedding license

  1. Files with licence code can be found in a 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 
      ...
    }

Running samples

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

  • NetBeans:
    Just open 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, 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\

ActiveX Specific

Embedding license

  1. Files with licence code can be found in a 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 simillar to:
    (new TGIS_Utils()).SetLicense(license_activation_code);
2019/07/25 14:19