Installing Tools (Windows)

This guide covers the tools required to author, build and debug Rhino plugins on Windows.

Prerequisites

This guide presumes you have Rhino 7 for Windows


Install Visual Studio

Visual Studio is Microsoft’s development platform and Integrated Development Environment (IDE). Visual Studio comes in three major “streams”: Visual Studio Code1, Visual Studio Online2, and Visual Studio “proper”3. In order to author RhinoCommon plugins, you will need Visual Studio “proper” (Visual Studio Code and Visual Studio Online are not supported).

At the time of this writing, Visual Studio “proper” comes in three editions: Community, Professional, and Enterprise. Any of these editions will work.

Note: For the purposes of this guide, we will presume you are using Visual Studio 2019 Community Edition.

Step-by-Step

  1. Visual Studio Community Edition is free from Microsoft for students, open-source contributors, and small teams. Details here. Click the Community button to download the installer.
  2. Run the Visual Studio installer you downloaded from Microsoft.
  3. Follow the onscreen prompts to install Visual Studio. You will need the “.NET desktop development” workload for RhinoCommon based plug-in development. When successfully installed, click the Launch button.

RhinoCommon templates

The RhinoCommon templates contains wizards to get you started creating plugins quickly.

Step-by-Step

  1. Launch Visual Studio.
  2. Navigate to Tools > Extensions and Updates…
  3. In the left-hand sidebar, expand the Online section, then select the Visual Studio Gallery entry… Extensions and Updates
  4. In the Search field, search for rhinocommon. This filters the gallery list below.
  5. Find RhinoCommon templates and select it.
  6. Click the Download button. The extension installation should begin after you close Visual Studio.
  7. You must Accept the license agreement by clicking on the Install button.
  8. If the installation is successful, the extension should appear in your list of Installed extensions.

Next Steps

Congratulations! You have the tools to build a RhinoCommon plugin for Rhino for Windows. Now what?

Check out the Your First Plugin (Windows) guide for instructions building - your guessed it - your first plugin.


Footnotes

  1. Visual Studio Code is Microsoft’s cross-platform source code editor for Windows, Linux, and macOS. At the time of this writing, Visual Studio code does not yet support the features required to author RhinoCommon plugins. 

  2. Visual Studio Online is Microsoft’s online counterpart to the desktop edition of Visual Studio (referred to as Visual Studio “proper” above). We have not tested using Visual Studio Online to debug RhinoCommon plugins as having a copy of Rhino running would prove logistically difficult. 

  3. Visual Studio “proper” is the desktop version of Visual Studio…we are only attaching the “proper” epithet to distinguish it from the Visual Studio Code and Visual Studio Online. In subsequent guides this will be referred to as simply “Visual Studio.”