Generating the MSI Installer

CAUTION: The msi project is only for the purpose of installing Dynamo and its associated content. It does not install pre-requisites like Iron Python.

####Required Frameworks
WIX Toolset

####Environment Variables
The following environment variables are all set to defaults in Install.props. But, you can inject them into the environment when running on the CI. This will allow you to configure the path for things like the sign tools and the harvest directory.

• DYNAMO_BASE - This is the path to the Dynamo repository on your machine.
• DYNAMO_HARVEST_PATH - This is a folder where the installation files will be staged prior to building the installer. Wix's Heat tool is used to "harvest" the installation files from this directory.
• DYNAMO_MIGRATION_NODES_PATH - This is a path to the directory which contains the common custom nodes used for migrations.
• DYNAMO_SAMPLES_PATH - This is a path to the samples to be included with the installer.
• DYNAMO_REVIT_SIGN_TOOLS - This is the path to a folder which contains the signing tools used to generate a signature file for verifying Dynamo as a Revit internal addin. Only Autodesk employees will have access to these tools, so .msi files generated on third-party development systems will not be able to generate the signature file required to verify Dynamo as a Revit internal AddIn.

The Dynamo msi installer is created using the WIX Toolset. The .msi installer project is a separate solution so that all developers need not have the WIX toolset installed if they are not interested in generating an installer. But, the .wxproject representing the installer is a proper Visual Studio project and can be edited as such by opening the src\Install.sln solution and editing the DynamoInstall project.

###Build Order

1. Dynamo.All.2012.sln - Master (Build in Release to get assets for Revit 2014)
2. Dynamo.All.2012.sln - Revit2015 (Build in Release to get assets for Revit 2015)
3. Install.sln (Build in Release to generate the msi project)

###Prebuild The project includes a prebuild step which generates a signature file and harvests the appropriate files.

###Install Location
The .msi installer installs Dynamo as an "internal" addin under a Revit installation. For example:
C:\Program Files\Autodesk\Revit\AddIns\Dynamo.

###Installer Properties
The installer has three properties that can be set from the command line:

• REVIT_FLAVOR - This parameter specifies the version of Revit under which you would like to install Dynamo.
  • The location of the Revit install under which Dynamo is installed is determined using the Autodesk registry keys created for the uninstall of applications. The key is located like this:
    HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\[REVIT_FLAVOR]\InstallLocation
• INSTALL_FOR_REVIT_2014 - This parameter specifies whether an AddIn file should be included in the install to register Dynamo as an addin for Revit 2014.
• INSTALL_FOR_REVIT_2015 - This parameter specifies whether an AddIn file should be included in the install to register Dynamo as an addin for Revit 2015.