Installing Kanzi Studio plugins

Kanzi Studio plugins extend the functionality of Kanzi Studio and run in Kanzi Studio.

For example, you can extend the functionality of Kanzi Studio to:

• Automate tasks that take a lot of time to do manually in Kanzi Studio, or are prone to errors.

• Import and export content from Kanzi Studio, such as localization tables in a format that Kanzi Studio does not support

• Create editors that abstract the details and speed up the workflow, such as visualization tools that support work on your projects in Kanzi Studio.

To install a Kanzi Studio plugin:

1. Copy the Kanzi Studio plugin DLL file to the %ProgramData%\Rightware\<KanziVersion>\plugins directory.

   If the plugins directory does not exist in %ProgramData%\Rightware\<KanziVersion>, create it.

   Tip

   In File Explorer, create a shortcut from your Kanzi Studio plugin DLL file and move the shortcut to the %ProgramData%\Rightware\<KanziVersion>\plugins directory.

   When you build the plugin, you can see in the Output window the location where Visual Studio stored the plugin DLL file.

2. Open Kanzi Studio.

   Kanzi Studio loads the plugins in the plugins directory and adds them to either the main menu or the context menus invoked from nodes and resources.

   Tip

   When you download a Kanzi Studio plugin from the internet, Windows can block access to the plugin files, which prevents Kanzi Studio from loading the plugin.

   If a plugin does not load in Kanzi Studio:

   1. Open the Kanzi Studio log file

      %USERPROFILE%/AppData/Local/Temp/KanziStudioLogs/KanziStudio.log
      

   2. If the log contains this error message:

      Plugin loading failed for: <PathToPlugin>. Error "Unable to load one or more of the requested types."

      Open Windows PowerShell in the plugin directory, and execute this command:

      Get-ChildItem . -Recurse | Unblock-File
      

      This way you unblock all the files in the directory.

   3. Restart Kanzi Studio.

See also

Creating Kanzi Studio command plugins

Creating Kanzi Studio window plugins

Creating Kanzi Engine plugins

Kanzi Studio plugins