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.

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:

• 64-bit JDK 8 (1.8.0) or newer

  We recommend using the JDK that is bundled with the Android Studio installation.

  Alternatively, you can install a standalone OpenJDK. For example, from https://github.com/adoptium/temurin8-binaries/releases/download/jdk8u362-b09/OpenJDK8U-jdk_x64_windows_hotspot_8u362b09.zip.

  Note that you can only use Java plugins with Kanzi Android framework (droidfw) applications.

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:

   • If you have a Kanzi product key, see Using a product key to activate Kanzi Studio.

   • If you have a Kanzi license file, see Using a license file to activate Kanzi Studio.

   • If you have a Kanzi dongle license, see Using a dongle license to activate Kanzi Studio.

   • If you are using Kanzi floating licenses, see Using a floating 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:

• Get familiar with Kanzi >

• Complete Kanzi tutorials >

• Explore Kanzi features >

• Set up your build environment for Android >

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.6/Documentation/KanziDocumentation-396.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.

   

Error reports

To help us improve the quality of Kanzi, Kanzi sends anonymized error reports. We are not able to link this information directly to any individual user. You can opt-out from sending this information during the installation.

See also

Upgrading Kanzi

What is installed with Kanzi?

Deploying Kanzi applications to Android