RhinoCommon Zoo Plugins

This guide discusses how to create RhinoCommon plugins that can obtain licenses the Zoo.

Overview

Zoo 5.0 allows 3rd party plugin developers to add licensing support for their products to the Zoo. RhinoCommon allows developers to write plugins for Rhino that use the Rhino license manager and obtain licenses from Zoo servers.

Prerequisites

RhinoCommon plugins are .NET Framework 4.0 assemblies. Thus, to create a RhinoCommon plugin for Rhino 6, you will need one of the following development tools:

  • Microsoft Visual C# 2017
  • Microsoft Visual Basic .NET 2017
  • RhinoCommon

Also, all Rhino plugins that use the Rhino license manager to access the Zoo must be signed with an Authenticode certificate issued by McNeel Plugin Security. These certificates are free, but must be requested by each developer. Developers must agree to the Terms of Use before a certificate is issued. For more information on plugin signing, see the Digitally Signing Plugins for Zoo guide.

It is presumed you have a RhinoCommon plugin you wish to add license support to. See the Your First Plugin (Windows) guide for instructions.

Add License Support

After you have built and tested your basic plugin, you can add licensing support as follows:

Step-by-Step

  1. In your plugin’s Rhino.PlugIns inherited class, create a new method with the same signature as the Rhino.PlugIns.ValidateProductKeyDelegate delegate. Rhino will call into this function whenever it needs your plugin to validate a license that is entered by a user, returned by the Rhino license manager (standalone node), or returned from a Zoo server (network node). For details, see the Zoo 5 Developer Samples.
  2. In your plugin’s OnLoad method, call Rhino.PlugIns.GetLicense and pass it the build type of the license required by your product, and your delegate function.
  3. Build your plugin.
  4. Digitally sign your plugin.
  5. Launch Rhino and test your plugin. When your plugin is loaded for the first time, you will be prompted to enter a license…

License Not Found

Managing Licenses

Rhino plugins that use the Rhino license manager appear in the Licenses page of the Options dialog. Here, the user is allowed to view and manage the license…

License Manager