Installing Kanzi

System requirements

Minimum system requirements for using Kanzi Studio:

  • On a PC: 64-bit Windows 7 SP1, 8.1, 10 Anniversary Update (version 1607) or newer, and 11

  • On a Mac: Any of the above Windows versions in Boot Camp, or OS X with VMware Fusion or Parallels Desktop

  • 12 GB of free disk space

  • 1 GB of RAM (2 GB recommended)

  • Graphics card compatible with OpenGL 3.3 or later and graphics card drivers no more than 12 months old

  • Kanzi Studio depends on these Microsoft libraries and frameworks:

    • Microsoft .NET Framework 4.8

    • Microsoft Visual C++ 2015-2019 Redistributable, both x86 and x64 versions

    During Kanzi installation the installer prompts you to install these.

To use the Debug build configuration of the Kanzi Studio Preview, install the Visual Studio version for the configuration that you want to use. For example, use the Debug build configuration to debug your Kanzi Engine plugins. See Debugging native Kanzi Engine plugins.

Platform requirements

Windows

To run Kanzi applications on Windows, you need:

  • Microsoft Visual C++ 2015-2019 Redistributable (x86)

To develop Kanzi applications and Kanzi Engine plugins, you need:

  • Visual Studio 2019 or Visual Studio 2017 with the latest updates

  • CMake 3.15 or newer

To develop Kanzi Studio plugins, you need:

  • Visual Studio 2019 with the latest updates

  • .NET framework 4.8

Android

To develop Kanzi applications for Android, you need:

  • Android Studio 4.1.3 or newer stable version

    You can download and install Android Studio from here.

  • Android Gradle plugin 4.1.3 or newer

  • Gradle 6.7.1 or newer

  • 64-bit JDK 8 or 11.

    We recommend using JDK 11 that is installed with Android Studio.

    Kanzi does not yet support JDK 17 installed by Android Studio Flamingo or newer. In this case, you need to install a JDK yourself. You can check the version of JDK installed with Android Studio in the About window. See Troubleshooting Android application development with Kanzi.

  • CMake 3.10.2.4988404 from Android Studio or newer

  • Android API level:

    • Kanzi Android framework (droidfw) requires Android API level 26 (Android version 8.0.0) or newer.

    • Kanzi application framework (appfw) requires Android API level 21 (Android version 5.0) or newer.

  • Java language version:

    • Kanzi Android framework (droidfw) requires Java 8 (1.8) or higher.

    • Kanzi application framework (appfw) requires Java 7 (1.7) or higher.

To use Java Kanzi Engine plugins from Kanzi Studio, you need:

Other platforms

To build and deploy Kanzi applications for other platforms, you need:

  • Python 2.7.x

  • Python 3.x

  • SCons 2.5.1 or newer

Installing and activating Kanzi

To get Kanzi, go to www.rightware.com/get-kanzi or contact Rightware sales team at sales@rightware.com.

To upgrade Kanzi, see Upgrading Kanzi.

To install and activate Kanzi:

  1. Copy the Kanzi installer file to a local disk.

    You need administrator’s rights on the computer where you are installing Kanzi.

  2. Run the Kanzi installer and follow the onscreen instructions.

    Set the <KanziWorkspace> to the root of a hard disk partition, because the Windows operating systems have a limit of 255 characters for paths.

  3. Activate your Kanzi license:

To find out what Kanzi installs on your computer, see What is installed with Kanzi?

For technical support use the Kanzi Support Portal at http://support.rightware.com. See Technical support.

Installing Kanzi unattended

Use unattended installation when you want to avoid user interaction during the installation of Kanzi. This is useful when you want to automate the installation.

When you install Kanzi unattended, the installer shows the installation progress window, but does not require user interaction.

To install Kanzi unattended:

  1. Start the Windows Command Prompt with administrator’s rights.

  2. Go to the directory where you have the Kanzi installer.

  3. Run this command:

    .\KanziStudio_<KanziVersion>.exe /silent

What’s next?

Now that you installed Kanzi you can:

Using Kanzi documentation offline

When you are connected to the Internet, and in Kanzi Studio you press or select Help > Documentation, Kanzi Studio points your default web browser to the Kanzi documentation at https://docs.kanzi.com.

To use Kanzi documentation offline:

  1. Download the https://docs.kanzi.com/3.9.7/Documentation/KanziDocumentation-397.zip file, that contains the Kanzi documentation.

  2. Extract the Kanzi documentation zip file to the <KanziWorkspace> directory.

  3. To view the Kanzi documentation when you are not connected to the Internet, in Kanzi Studio select Edit > User Preferences and disable the Online documentation setting.

    When this option is disabled, Kanzi Studio uses the documentation in the <KanziWorkspace>/Documentation directory.

    ../_images/disable-online-documentation.png

Telemetry

To help us understand how we can improve Kanzi Studio, you can let Kanzi Studio send to Rightware these anonymized telemetry data:

  • Error reports contain diagnostic information when an error occurs in Kanzi Studio or Kanzi Studio crashes. These reports help us understand what caused the error or crash and what we must change to prevent such events.

  • Usage data contains information about how Kanzi Studio features are used and how they perform. This data helps us understand how we can improve our product.

Before Kanzi Studio sends these telemetry data, it removes all information that would enable us to link it to you.

When you run Kanzi Studio for the first time, Kanzi Studio asks whether you want to send anonymized error reports and usage data.

To change your preferences later, in the Kanzi Studio main menu, select Edit > User Preferences and in the General tab, use the Send anonymized error reports and Send anonymized usage data settings.

../_images/telemetry-section-preferences.png

See also

Upgrading Kanzi

What is installed with Kanzi?

Deploying Kanzi applications to Android