Nice3point.Revit.Build.Tasks 1.1.2

Revit Build Tasks

This repository contains the MSBuild tasks for developing and publishing the plugin for multiple Revit versions.

Installation

You can install Tasks as a nuget package.

<PackageReference Include="Nice3point.Revit.Build.Tasks" Version="1.*"/>

How to use this package? Just add it to your add-in, and this package will setup the project for simplified maintenance and development. About MSBuild targets.

Package included by default in Revit Templates.

MSBuild Targets

OR_GREATER preprocessor symbols

Included a target for generating the Define Constants needed to support code for multiple Revit versions. OR_GREATER variants are accumulative in nature and provide a simpler way to write compilation conditions.

Usage:

#if REVIT2021_OR_GREATER
    UnitUtils.ConvertFromInternalUnits(69, UnitTypeId.Millimeters);
#else
    UnitUtils.ConvertFromInternalUnits(69, DisplayUnitType.DUT_MILLIMETERS);
#endif

To support removed APIs in newer versions of Revit, you can invert the constant:

#if !REVIT2023_OR_GREATER
    var builtinCategory = (BuiltInCategory) category.Id.IntegerValue;
#endif

Constants are generated from the names of project configurations. If your project configurations do not contain metadata about the version, you can specify it explicitly:

<PropertyGroup>
    <RevitVersion>2025</RevitVersion>
</PropertyGroup>

To disable it, set:

<PropertyGroup>
    <DisableImplicitRevitDefines>true</DisableImplicitRevitDefines>
</PropertyGroup>

Publishing

Included a target for copying addin files to the %AppData%\Autodesk\Revit\Addins folder after building a project.

Clean solution or Clean project will delete the published files.

Copying files helps attach the debugger to the add-in when Revit starts. This makes it easier to test the application or can be used for local development.

Should only be enabled in projects containing the .addin file.

Disabled by default, to enable, set:

<PropertyGroup>
    <PublishAddinFiles>true</PublishAddinFiles>
</PropertyGroup>

By default, all project files and dependencies required for the plugin to run, including the .addin manifest, are copied. If you need to include additional files, such as configuration or family files, include them in the Content item.

The PublishDirectory property specifies which subfolder of the plugin the file should be copied to. If it is not specified, the files will be copied to the root folder.

<ItemGroup>
    <Content Include="Resources\Families\Window.rfa" PublishDirectory="Families"/>
    <Content Include="Resources\Music\Click.wav" PublishDirectory="Music\Effects"/>
    <Content Include="Resources\Images\**" PublishDirectory="Images"/>
    <Content Include="Readme.md"/>
</ItemGroup>

To disable copying Content file, set CopyToPublishDirectory="Never"

<ItemGroup>
    <Content Include="Contributing.md" CopyToPublishDirectory="Never"/>
</ItemGroup>

Result:

📂%AppData%\Autodesk\Revit\Addins\2025
 ┣📜RevitAddIn.addin
 ┗📂RevitAddIn
   ┣📂Families
   ┃ ┗📜Family.rfa
   ┣📂Images
   ┃ ┣📜Image.png
   ┃ ┣📜Image2.png
   ┃ ┗📜Image3.jpg
   ┣📂Music
   ┃ ┗📂Effects
   ┃   ┗📜Click.wav
   ┣📜CommunityToolkit.Mvvm.dll
   ┣📜RevitAddIn.dll
   ┗📜Readme.md

Implicit global usings

Included a target for generating implicit global Usings depending on the project references. Helps to reduce the frequent use of using in a project.

To disable it, set:

<PropertyGroup>
    <DisableImplicitRevitUsings>true</DisableImplicitRevitUsings>
    
    <ImplicitUsings>false</ImplicitUsings>
</PropertyGroup>

MSBuild Properties

By default, some properties are set that are optimal for publishing an application.

These properties are automatically applied to the .csproj file by default and can be overriden:

<PropertyGroup>
    <CopyLocalLockFileAssemblies>true</CopyLocalLockFileAssemblies>
    <AppendTargetFrameworkToOutputPath>false</AppendTargetFrameworkToOutputPath>
    <PublishAddinFiles>false</PublishAddinFiles>
</PropertyGroup>