Dynamo for Revit
Dynamo for Revit is a plugin for Revit and a library of Dynamo Nodes.
Dynamo for Revit has different branches for different versions of Revit. For example to run Dynamo for Revit on Revit 2016 you want the Dynamo for Revit 2016 branch.
- Clone the DynamoRevit repository.
git clone https://github.com/DynamoDS/DynamoRevit.git
- Make sure you have .Net Framework 4.7 SDK installed on your computer
restorepackages.batwith administrative privileges.
- Open DynamoRevit.2013.sln in Visual Studio, and select a build confiuration (Debug | Release)
After DynamoRevit is built, you will notice that there is a
Dynamo.config file in DynamoRevit\bin\AnyCPU\Debug[Or Release]. With this file you can specify which DynamoCore you want to run with the DynamoRevit built.
For example, if you specify
<add key="DynamoRuntime" value="D:\Dynamo\bin\AnyCPU\Debug"/>
you will run DynamoRevit with the DynamoCore at
D:\Dynamo\bin\AnyCPU\Debug. This is especially useful when you want to test the DynamoRevit built with different flavors of DynamoCore. Or you are using RTF to test a built version of DynamoRevit.
Creating an Addin
DynamoRevit requires an addin which instructs Revit to load the plugin on startup. The Dynamo for Revit installer takes care of building an addin for use on the end user's machine. For development, you'll have to create an addin manually. A DynamoRevit addin would look like this:
<?xml version="1.0" encoding="utf-8" standalone="no"?> <RevitAddIns> <AddIn Type="Application"> <Name>Dynamo For Revit</Name> <Assembly>"E:\MyGitPath\Dynamo\bin\AnyCPU\Debug\Revit_xxxx\DynamoRevitVersionSelector.dll"</Assembly> <AddInId>8D83C886-B739-4ACD-A9DB-1BC78F315B2B</AddInId> <FullClassName>Dynamo.Applications.VersionLoader</FullClassName> <VendorId>ADSK</VendorId> <VendorDescription>Dynamo</VendorDescription> </AddIn> </RevitAddIns>
<?xml version="1.0" encoding="utf-8" standalone="no"?> <RevitAddIns> <AddIn Type="Application"> <Name>Dynamo For Revit</Name> <Assembly>"D:\DynamoRevit\bin\AnyCPU\Debug\Revit_2017\DynamoRevitDS.dll"</Assembly> <AddInId>8D83C886-B739-4ACD-A9DB-1BC78F315B2B</AddInId> <FullClassName>Dynamo.Applications.DynamoRevitApp</FullClassName> <VendorId>ADSK</VendorId> <VendorDescription>Dynamo</VendorDescription> </AddIn> </RevitAd
These two addin files are mostly same but the second one specifies which version of DynamoRevit you want to load with Revit without going through version selector at all. This could be useful sometimes when you have multiple versions of DynamoRevit built or installed, thus you want to be more specific which one you are testing against.
This .addin file should be placed in one of the following locations:
<user> is the user who will be using the addin and
<version> is the version of Revit for which the addin is built. Notice that the
Assembly tag points to the VersionSelector.dll that is built during a build of Dynamo for Revit and copied into the Dynamo/bin/Revitxxx/ folder.
Dynamo for Revit requires a few dependencies
- Dynamo from http://www.github.com/DyanmoDS/Dynamo. The required binaries are obtained from DynamoVisualProgramming, NuGet Packages.
- RevitAPI.dll + RevitAPIUI.dll (path set with REVITAPI)
- IronPython 2.7 (this is already installed if you install Dynamo)
- Few other dependencies are also fetched from NuGet package.
NuGet packages are downloaded using restorepackages.bat, it creates soft link for all the NuGet packages folder dropping the version information so that the projects files doesn't need to be changed when package versions are changed. The package versions are defined in packages-template.aget file. LatestBeta is used for Dynamo specific packages to automatically download the latest beta packages.
restorepackages.bat file is run as a pre-build step for AssemblySharedInfoGenerator project. Sometimes this file may fail to create the symbolic links in absence of administrative privilege. To fix the issue you can run restorepackages.bat file as administrator.
if you see errors like:
1> "C:\Program Files (x86)\Common Files\microsoft shared\TextTemplating\11.0\TextTransform.exe" -out AssemblySharedInfo.cs AssemblySharedInfo.tt 1>c:\Users\bykovsm\AppData\Local\Temp\AssemblySharedInfo.tt(1,1): error CS1519: Compiling transformation: Invalid token 'this' in class, struct, or interface member declaration 1>c:\Users\bykovsm\AppData\Local\Temp\AssemblySharedInfo.tt(1,6): error CS1520: Compiling transformation: Method must have a return typethen you need to get rid of any white space in the last line of DynamoRevit/src/AssemblyInfoGenerator/transform_all.tt it's also possible that transform_all.bat is looking for a text templating engine for a version of visual studio you do not have installed.
if you see missing classes or namespaces from the Revit or Dynamo APIS see here: CS.props contains environment variable DYNAMOAPI and REVITAPI to define path for Dynamo and Revit libraries respectively. These environment variables can be overwritten by providing correct path for Dynamo and Revit libraries in user_locals.props
####Note#### the installer structure for DynamoCore and DynamoRevit has recently changed - if you have trouble with these instructions please reach out to the Dynamo team for help.
Testing latest master with Revit 2020
- Install Revit 2020 - user Revit Beta Program
- Build Dynamo master branch
- Build DynamoRevit master branch. Make sure
dynamo.configfile, which will be in the
binfolder, is pointing to the
binfolder of Dynamo that was just built. Your config file should look like below. Note that the
dynamo.configneeds to be updated after a successful build
<?xml version="1.0" encoding="utf-8"?> <configuration> <appSettings> <add key="DynamoRuntime" value="C:\Workspace\GitHub\Dynamo\bin\AnyCPU\Debug"/> </appSettings> </configuration>
- Remove/delete the DynamoForRevit addin folder from the following location:
C:\Program Files\Autodesk\Revit Preview Release\AddIns
- Now add a
Dynamo.addinfile to this location:
C:\ProgramData\Autodesk\Revit\Addins\2020. The addin file looks like:
<?xml version="1.0" encoding="utf-8" standalone="no"?> <RevitAddIns> <AddIn Type="Application"> <Name>Dynamo For Revit</Name> <Assembly>"C:\Workspace\GitHub\DynamoRevit\bin\AnyCPU\Debug\Revit\DynamoRevitDS.dll"</Assembly> <AddInId>8D83C886-B739-4ACD-A9DB-1BC78F315B2B</AddInId> <FullClassName>Dynamo.Applications.DynamoRevitApp</FullClassName> <VendorId>ADSK</VendorId> <VendorDescription>Dynamo</VendorDescription> </AddIn> </RevitAddIns>
- Start Revit 2020 and check if you can load Dynamo