Introdução e Add-ins necessários para começar a escrever plug-ins Revit em Python

 Introdução

Primeiramente, seja bem vindo! Este blog será meu diário pessoal nesta jornada para dominar a API do Revit e ganhar mais experiência em programação. Espero que esta página seja um recurso útil para os outros assim como é para mim. 

O desenvolvimento de plugins personalizados para Revit usando a API pode ser uma tarefa complicada para quem está começando. O processo de desenvolvimento de plugins com a API do Revit é complexo e quase não existem bons materiais em português ensinado pelo menos o básico. Além disso, os conteúdos em inglês parecem desatualizados e já não funcionam corretamente com a Revit API 2020+.

Este blog é uma tentativa de remediar essa deficiência de conteúdo sobre o assunto e espero que venha a poupar tempo de pesquisa aos futuros interessados nessa área. Se tiver alguma sugestão, comentário ou quiser me ensinar alguma coisa, por favor entre em contato pelo e-mail wadbott@gmail.com 

Aproveite!

O que preciso instalar para começar a criar plug-ins Revit em Python? 

                        

1) RevitPythonShell

Rodando scripts Python dentro do Revit

RevitPythonShell é um Revit add-in criado por Daren Thomas. A ferramenta permite que desenvolvedores e designers escrevam comandos API do Revit usando Iron Python. Isso permite um fluxo de trabalho iterativo muito mais fluido, semelhante a ambientes de script em outros programas.

Nos exemplos iniciais vamos executar nossos scripts por esse add-in, mais tarde quando formos criar programas mais complexos vamos migrar para o PyRevit. 

Você pode baixar um instalador compatível com a versão do seu Revit aqui. Baixar último release.

Após a instalação é só abrir o seu Revit e localizar a Shell dentro da aba Suplementos. 

Aba Suplementos -> Interactive Python Shell 

2) pyRevit

Escrevendo seu primeiro plugin Revit em Python

pyRevit é um Revit add-in criado por Ehsan Iran-Nejad. O pyRevit ajuda você a esboçar rapidamente suas idéias de automação e plugins dentro do ambiente Revit e usando suas APIs. Ele também vem com um amplo conjunto de ferramentas poderosas que mostram seus recursos como um ambiente de desenvolvimento.

Você pode baixar o último release do pyRevit aqui. Baixar último release.

Após a instalação, uma aba nova chamada 'pyRevit' irá aparecer no seu Revit.

pyRevit já vem com várias ferramentas

Depois de baixar e instalar os dois add-in, podemos começar com a estrutura básica de código.