Rhino Installer Engine

This guide is a brief introduction to the Rhino Installer Engine.

Overview

The Rhino Installer Engine simplifies distribution, installation, and updating of plugins for Rhino for Windows (on both 32- and 64- bit) and Rhino for Mac.

How It Works

A Rhino Installer Package is a zip file with an .rhi extension (or a .macrhi extension on Mac). The rhi file can contain directory structures, and can include more than one version of a plugin (for Windows).

There are no file structure or naming requirements.

For example:

  • myPlugIn\4.0\myPlugIn.rhp
  • myPlugIn\5.0\x86\myPlugIn.rhp
  • myPlugIn\5.0\x64\myPlugIn.rhp

works just as well as…

  • myPlugIn_rhino4.rhp
  • myPlugIn_rhino5_x86.rhp
  • myPlugIn_rhino5_x64.rhp

On Windows, the Rhino Installer Engine examines each plugin and extracts the plugin GUID, Title, Version, and appropriate SDK version numbers. It also examines each Rhino installed on the computer.

On Windows, the Rhino Installer Engine supports installing AnyCPU plugins written in .NET and will register them with both 32- and 64-bit Rhino 5. On Mac, the Rhino Installer Engine - and Rhino itself - only support 64-bit installation.

On Windows, each plugin is compared to each installed version of Rhino. The newest compatible plugin is registered with the corresponding version of Rhino.

Limitations

  • The Rhino Installer Engine will copy files from the rhi archive, and will register the plug ins it finds. No other execution is done.
  • Currently, it is not possible to digitally sign rhi files in order to verify the source of rhi files.
  • The Rhino Installer Engine is currently available with Rhino 5 and later.