Mise à niveau des macros de Revit

Lorsque vous procédez à la mise à niveau des macros, il faut généralement effectuer des tâches de gestion des fichiers pour mettre à jour et exécuter correctement les macros dans Revit.

Veillez à bien prendre connaissance des modifications apportées au kit de développement logiciel (SDK, Software Development Kit) de Revit, ainsi que des informations suivantes sur la mise à niveau des macros.

Mise à niveau des macros au niveau du document

1. Ouvrez le projet contenant les macros imbriquées au niveau du document. Le projet est mis à jour, puis s'ouvre.
2. Cliquez sur l'onglet Gérerle groupe de fonctions Macros Gestionnaire de macros.
3. Cliquez sur chaque onglet au niveau du document à mettre à jour.
4. Une fois terminé, cliquez sur Fermer.
5. Enregistrez le projet et fermez-le.

Aucune étape supplémentaire n'est requise, à moins que le code de la macro doive être modifié manuellement.

Mise à niveau des macros au niveau de l'application

1. Copiez et collez les répertoires de macros dans :
   • Windows 7 et Windows 8 : %ProgramFiles%\Autodesk\<nom de produit et version>\AppHookup

   Dans les versions antérieures à Revit 2016, les macros étaient situées dans %ProgramFiles%\Autodesk\<nom de produit et version>\VstaMacros\AppHookup ou %ProgramData%\Autodesk\Revit\Macros\<version du produit>\Revit\VstaMacros\AppHookup.

2. Lancez Revit.
3. Cliquez sur l'onglet Gérerle groupe de fonctions Macros Gestionnaire de macros.
4. Cliquez sur l'onglet Application.
5. Choisissez un module, puis cliquez sur Modifier.
6. L'environnement de développement intégré (IDE) de macro Revit s'ouvre. Cliquez sur Outils Mise à niveau du projet.
7. Sous l'onglet Mise à niveau du projet, choisissez le module.
8. Dans la liste déroulante Convert selected projects to (Convertir les projets sélectionnés), choisissez un langage de conversion.
   • Pour les macros en C#, choisissez C# 4.0.
   • Pour les macros en VB.NET, choisissez MSBuild 4.0.
9. Dans la liste déroulante Change target framework (Modifier le framework cible), choisissez .NET Framework 4.0 Client Profile.
10. Cliquez sur Convertir.
11. Répétez les étapes 5 à 11 pour tous les modules au niveau de l'application.
12. Une fois terminé, cliquez sur Fermer.

Remarque : En cas de problèmes de compatibilité observés au cours de la mise à niveau, des copies, auxquelles est ajouté le symbole ~R, du projet d'origine (pour les macros au niveau du document) et des macros au niveau de l'application sont placées dans My Documents\Revit <version>. Selon les paramètres de votre dossier Explorateur Windows, ces fichiers peuvent être cachés.

Le code des projets devra peut-être être modifié manuellement, de manière à créer et exécuter correctement les macros dans Autodesk Revit 2016. Consultez le SDK pour obtenir la liste des modifications appliquées à l'API, de manière à pouvoir résoudre tout problème relatif à la compatibilité des versions.

Modification apportées à l'environnement de développement intégré (IDE)

Dans Autodesk Revit 2016, l'environnement Revit VSTA IDE a été remplacé par SharpDevelop. Cela ne modifie pas de manière significative le workflow de développement de macros. Les classes générées dans le fichier *.desinger.cs(vb) sont automatiquement mises à jour. En revanche, si vous utilisiez les classes suivantes dans d'autres fichiers que les exemples du kit SDK, vous devez les mettre à jour manuellement, comme suit.

Classes SharpDevelop (anciennes)	Classes SharpDevelop (nouvelles)
Autodesk.Revit.UI.Macros.ApplicationEntryPoint	Autodesk.Revit.UI.Macros.ApplicationEntryPoint
Autodesk.Revit.UI.Macros.DocumentEntryPoint	Autodesk.Revit.UI.Macros.DocumentEntryPoint
Autodesk.Revit.UI.Macros.IEntryPoint	Autodesk.Revit.DB.Macros.IEntryPoint
Autodesk.Revit.UI.Macros.AddInIdAttribute	Autodesk.Revit.DB.Macros.AddInIdAttribute
Autodesk.Revit.UI.Macros.VendorIdAttribute	Autodesk.Revit.DB.Macros.VendorIdAttribute