Revit API. Introducción I
Todo lo que necesitas para empezar
Para comenzar a desarrollar nuestros propios programas dentro Revit el primer paso es tenerlo instalado, como es lógico. Si has llegado hasta este post, probablemente ya tienes alguna experiencia con Revit, por lo que omitiremos el proceso de instalación.
Sin embargo, dentro del paquete de instalación hay un apartado que sí nos va a interesar especialmente en este post. Ese apartado es el SDK (Software Development Kit), ubicado en el menú de instalación en “Instalar Herramientas y Utilidades”. El paquete contiene la ayuda de la API y una gran cantidad de ejemplos prácticos de programación para Revit. Si tenías esperanzas de realizar la instalación del SDK en castellano, olvídalo, toda la documentación está en inglés.
En la ubicación seleccionada para la instalación del SDK podrás encontrar el archivo de ayuda de la API “RevitAPI.chm” en el que es posible consultar los distintos tipos de clases y métodos propios de la API de Revit. Además, en esa misma carpeta encontrarás el archivo “Getting Started with the Revit API.docx”, que contiene explicaciones muy valiosas del funcionamiento general de los plug-ins de Revit.
Lo siguiente que necesitamos es instalar Microsoft Visual C# 2010 Express, que nos servirá para detectar errores mientras programamos y nos permitirá generar los archivos “.dll” que constituirán nuestros plug-ins, como veremos más adelante. La instalación del programa es sencilla y no tiene ninguna particularidad.
Una vez hecho esto, estamos listos para comenzar a programar nuestra primera aplicación en entorno Revit. Para ello, abriremos Microsoft Visual C# 2010 y crearemos un nuevo proyecto. Al crear un nuevo proyecto el programa nos pregunta qué tipo de proyecto queremos empezar. En nuestro caso seleccionaremos siempre “Class Library”.
Una vez hecho esto, nos aparecerá la pantalla dividida en cuatro ventanas:
Puesto que queremos crear una aplicación cuyo entorno va a ser Revit, lo primero que deberemos hacer es cargar las referencias que contienen las librerías de Revit. Para ello, pulsamos el botón derecho del ratón encima de “References” y aparecerá la opción “Add Reference”. En la ventana deberemos ir a la pestaña “Browse” y allí buscar los dos archivos que queremos cargar:”RevitAPI.dll” y “RevitAPIUI.dll”. Podemos encontrar estos archivos en la carpeta C/…/Archivos de Programa/Autodesk/Revit 2014 (o Revit 2013, según sea el caso).
Una vez hecho esto, hay que modificar las propiedades de los archivos que acabamos de importar. Si seleccionamos uno de ellos en el explorador, aparecen sus propiedades en la ventana correspondiente. El apartado “Copia Local” estará por por defecto en “True”, lo cual indica que se hará una copia de la referencia dentro de solución de nuestro plug-in. Esto no es necesario, puesto que la aplicación va a correr dentro de Revit, donde estas librerías son accesibles. Por tanto, nos situaremos encima cada una de ellas y pondremos el valor de “Copia Local” en “False”.
Con esto, hemos treminado la puesta a punto para comenzar a programar plug-ins para Revit. En el siguiente post haremos un primer plug-in partiendo desde este punto.