Domina el archivo .csproj
Aprende a configurar proyectos C# para Autodesk Revit API, comprende qué controla MSBuild y genera una base segura para Revit 2024–2027.
El .csproj es el plano de construcción de tu código
Visual Studio muestra botones y propiedades; MSBuild lee el archivo .csproj para decidir qué compilar, con qué versión de .NET, qué bibliotecas usar y qué archivo producir.
En un add-in de Revit, una elección incorrecta puede generar una DLL que compila pero que Revit no puede cargar. El año de Revit, su actualización y el runtime deben estar alineados.
¿Qué ocurre al pulsar “Compilar”?
→
→
→
→
Solución (.sln)
Agrupa uno o varios proyectos. Organiza; no define por sí sola el runtime de cada DLL.
Proyecto (.csproj)
Define framework, salida, referencias, constantes, WPF y automatizaciones de compilación.
Código (.cs)
Contiene comandos, aplicaciones, servicios y modelos que se convierten en IL dentro de la DLL.
Biblioteca (.dll)
Es el ensamblado que Revit cargará. Un add-in no debe producir un EXE de consola.
Manifiesto (.addin)
Le indica a Revit dónde está la DLL, el tipo de extensión y la clase de entrada.
RevitAPI.dll
Expone la API. Debe referenciarse desde la instalación correspondiente y no copiarse al resultado.
No basta con elegir el año de Revit
| Producto instalado | Target recomendado | Observación |
|---|---|---|
| Revit 2024 | net48 | API basada en .NET Framework 4.8. |
| Revit 2025.0–2025.4 | net8.0-windows | Los add-ins deben recompilarse para .NET 8. |
| Revit 2025.5 | net10.0-windows | La actualización 2025.5 migra a .NET 10. |
| Revit 2026.0–2026.4 | net8.0-windows | El SDK 2026 original exige .NET 8. |
| Revit 2026.5 | net10.0-windows | La actualización 2026.5 migra a .NET 10. |
| Revit 2027 | net10.0-windows | Revit 2027 usa el runtime final de .NET 10. |
Cómo leer un .csproj sin memorizarlo
XML es un lenguaje de marcado para representar información jerárquica. Los signos < y > delimitan una etiqueta. La pareja <PlatformTarget>x64</PlatformTarget> forma un elemento: tiene etiqueta de apertura, un valor y etiqueta de cierre. En cambio, Sdk=»Microsoft.NET.Sdk» es un atributo escrito dentro de la etiqueta Project.
MSBuild interpreta ese XML como un modelo de proyecto. No ejecuta las líneas de arriba abajo como C#: evalúa propiedades, elementos, condiciones y objetivos para construir un grafo de compilación.
| Fragmento | Qué es | Cómo se interpreta |
|---|---|---|
| <PropertyGroup> | Elemento contenedor | Agrupa propiedades de MSBuild. Por sí solo no configura nada. |
| <PlatformTarget>x64</PlatformTarget> | Propiedad y valor | La propiedad se llama PlatformTarget y su valor de texto es x64. |
| Condition=»‘$(Configuration)’ == ‘Release.R27′» | Atributo con condición | El bloque solo se aplica cuando la expresión es verdadera. $(Configuration) obtiene el valor de otra propiedad. |
| <Reference Include=»RevitAPI»> | Elemento de un ítem | Declara una dependencia llamada RevitAPI; sus hijos precisan ruta y comportamiento de copia. |
¿Quién crea las propiedades? ¿Puedo inventar una?
Hay tres grupos. MSBuild define propiedades como Configuration y PlatformTarget; el .NET SDK añade otras como TargetFramework, Nullable o ImplicitUsings; y tú puedes declarar propiedades personalizadas como RevitVersion o RevitInstallDir.
Una propiedad personalizada no hace nada automáticamente. Adquiere utilidad cuando otra expresión la consume: por ejemplo, $(RevitVersion) se inserta en una ruta o condición. Los nombres distinguen mayúsculas solo en ciertos contextos, por lo que conviene respetar exactamente la escritura documentada.
<Project Sdk=»Microsoft.NET.Sdk»>: raíz, etiqueta y atributo
Project es el elemento raíz: todo el archivo queda contenido en él. El atributo Sdk solicita el SDK de .NET, que importa reglas y tareas predefinidas para restaurar paquetes, localizar archivos C#, invocar al compilador y crear la salida.
Sin el SDK tendrías que declarar muchas importaciones manualmente, como ocurría en proyectos antiguos. “SDK-style” describe este formato moderno y reducido; no significa que el SDK de Revit venga incluido.
PropertyGroup, orden de evaluación y Condition
PropertyGroup solo organiza propiedades relacionadas. Puede haber varios grupos. MSBuild los evalúa en orden y, normalmente, una asignación posterior reemplaza una anterior si su condición se cumple.
Una Condition permite variantes sin duplicar el proyecto. Ejemplo: el grupo de Release.R24 puede usar net48, mientras otro grupo utiliza net10.0-windows. La condición no es C#: es sintaxis de expresiones de MSBuild.
TargetFramework: qué runtime y API base puede usar tu DLL
El TFM o Target Framework Moniker identifica el destino de compilación. net48 apunta a .NET Framework 4.8; net8.0-windows y net10.0-windows apuntan a .NET moderno e indican que el proyecto puede usar API específicas de Windows.
No instala .NET ni convierte automáticamente bibliotecas incompatibles. Determina qué ensamblados de referencia usa el compilador y qué runtime necesitará la DLL. Por eso debe coincidir con la actualización concreta de Revit.
OutputType, AssemblyName y RootNamespace
OutputType=Library ordena producir una DLL, que es lo que Revit carga. Exe produce una aplicación ejecutable y se reserva aquí para los ejemplos de consola.
AssemblyName define el nombre de la DLL resultante. RootNamespace sirve como espacio de nombres predeterminado para herramientas y plantillas, pero no cambia por sí solo los namespace ya escritos en tus archivos C#.
PlatformTarget=x64 y Prefer32Bit=false: qué significan realmente
PlatformTarget indica la arquitectura para la que se compila el ensamblado. Revit de escritorio es un proceso de 64 bits, por eso el add-in se fija en x64. Así, el compilador y el cargador detectan antes una dependencia nativa incompatible.
Prefer32Bit solo tiene sentido principalmente para ejecutables AnyCPU: solicita que se inicien como proceso de 32 bits cuando sea posible. Un add-in no inicia su propio proceso; se carga dentro de Revit. Dejarlo en false hace explícito que no se desea preferencia por 32 bits. Con PlatformTarget=x64 resulta redundante, pero documenta la intención y evita cambios accidentales si alguien vuelve a AnyCPU.
Nullable, ImplicitUsings y LangVersion
Nullable=enable activa el análisis de referencias anulables: el compilador advierte cuando un valor posiblemente nulo se usa sin comprobación. No impide que existan nulos en tiempo de ejecución.
ImplicitUsings=enable agrega automáticamente espacios de nombres comunes; reduce líneas using, pero no importa Autodesk.Revit.DB. LangVersion selecciona las características sintácticas de C#. Usar latest es cómodo, aunque en equipos docentes suele ser más reproducible fijar una versión compatible con el SDK instalado.
Configurations y DefineConstants
Configurations declara los nombres que aparecerán en Visual Studio, como Debug, Release o Release.R27. El nombre por sí solo no modifica nada: los grupos condicionados son los que asignan el framework, rutas y constantes correspondientes.
DefineConstants crea símbolos para el preprocesador de C#. Con REVIT_2027 puedes escribir #if REVIT_2027 cuando una porción pequeña de la API varía. No es una variable disponible en tiempo de ejecución.
ItemGroup, Reference, HintPath, Private y SpecificVersion
ItemGroup reúne ítems: referencias, archivos, recursos o paquetes. A diferencia de una propiedad única, una lista de ítems puede contener muchos elementos del mismo tipo.
Reference Include=»RevitAPI» declara la dependencia; HintPath indica dónde buscarla. Private=false equivale a desactivar “Copiar local”: Revit ya suministra esas DLL y no deben distribuirse con tu add-in. SpecificVersion=false flexibiliza la resolución de la referencia, pero no garantiza compatibilidad entre versiones de la API.
Compile Remove=»Program.cs»: por qué se excluye
En proyectos SDK-style, los archivos .cs de la carpeta se incluyen automáticamente. Compile Remove retira uno del conjunto que llega al compilador. Aquí evita mezclar el punto de entrada de consola con el ensamblado del add-in.
No borra el archivo del disco; solo lo excluye de esa evaluación del proyecto. Si se aplica con una condición, puede permanecer disponible en configuraciones de consola.
StartAction y StartProgram: depurar con F5
Estas propiedades no forman parte funcional del add-in. Indican a Visual Studio que, al iniciar la depuración, lance Revit.exe. Después Revit encuentra el manifiesto, carga la DLL y el depurador puede detenerse en tus puntos de interrupción.
La ruta debe corresponder a la versión seleccionada. Compilar y depurar son acciones distintas: una compilación exitosa no demuestra que el manifiesto o la clase de entrada sean correctos.
Target, AfterTargets y las tareas de MSBuild
Un Target es un objetivo de trabajo compuesto por tareas. AfterTargets=»Build» solicita ejecutarlo después de compilar. En el ejemplo, MakeDir crea la carpeta y WriteLinesToFile escribe el manifiesto.
Estas etiquetas sí provocan acciones porque el SDK/MSBuild conocen esas tareas. Deben limitarse a configuraciones de Revit para que un ejercicio de consola no despliegue archivos accidentalmente.
Genera y analiza tu .csproj
Cambia los parámetros y observa el XML. Después puedes editarlo y validarlo.
Las referencias de Revit solo existen en perfiles de add-in; usa DLL oficiales con Private=false; separa los casos .NET 8/.NET 10 por actualización; y habilita F5 para cada instalación, no únicamente para 2027.
Decisiones que evitan errores difíciles
Referencias oficiales
Usa RevitAPI.dll y RevitAPIUI.dll de la carpeta instalada. Un paquete NuGet comunitario puede ser útil, pero no sustituye verificar procedencia, licencia y versión.
Un perfil por runtime
Trata 2025.5 y 2026.5 como perfiles distintos. El nombre del año no garantiza el mismo runtime después de una actualización mayor.
Salida limpia
Separa bin\Release.R27 y similares. Evita que una DLL antigua termine en la carpeta de otro Revit.
Manifiesto trazable
Guarda un GUID estable por add-in y confirma que FullClassName incluya namespace y clase exactos.
WPF solo cuando aplica
Activa UseWPF únicamente si hay interfaz. Mantén la lógica de negocio en bibliotecas independientes para facilitar pruebas.
Prueba antes de distribuir
Compila en limpio, inicia la versión objetivo, revisa el Journal de Revit y prueba instalación y desinstalación en un equipo diferente.
Fuentes y alcance
Contenido actualizado el 8 de noviembre de 2026 con documentación oficial de Autodesk: guía de migración de Revit 2025 a .NET 8, requisitos de desarrollo de Revit 2026, transición 2025.5/2026.5 a .NET 10 y migración de Revit 2027 a .NET 10. Verifica siempre las notas de la actualización instalada.
Revit 2025: migración a .NET 8 · Revit 2026: requisitos · Revit 2027: .NET 10