Installer la nouvelle version du plugin dans Revit (deploy)

En une phrase : compiler le plugin et copier la .dll au bon endroit pour que Revit la charge. Difficulté : attention — règles critiques à respecter sinon Revit crash Temps : 3 à 5 minutes

Quand l'utiliser

• Vous venez de modifier du code C# et voulez tester en local
• Vous voulez vérifier qu'une version stable fonctionne avant de la publier

Règle critique

JAMAIS déployer une .dll compilée avec UseRevitStubs=true. Les stubs sont une fausse API pour la CI ; dans Revit, elle n'existe pas → crash garanti FileNotFoundException.

Avant de commencer

• [ ] Revit est fermé (sinon le fichier .dll est verrouillé)
• [ ] Vous êtes dans le dossier auguste-revit/
• [ ] Vous savez si vous ciblez Revit 2025 (net8) ou Revit 2024 (net481)

Étapes — Revit 2025

1. Compiler avec la vraie API Revit

dotnet build src/plugin/AugusteRevit/AugusteRevit.csproj -c Debug

Pas de -p:UseRevitStubs=true ici. Sans ce flag et avec Revit 2025 installé, le projet utilise la vraie RevitAPI.dll.

Sortie : bin/Debug/net8.0-windows/AugusteRevit.dll

2. Copier la DLL dans le dossier Addins

$src = "src/plugin/AugusteRevit/bin/Debug/net8.0-windows"
$dst = "$env:APPDATA/Autodesk/Revit/Addins/2025/AugusteRevit"
Copy-Item "$src/AugusteRevit.dll" "$dst/" -Force
Copy-Item "$src/AugusteRevit.pdb" "$dst/" -Force

3. Redémarrer Revit

Ouvrir Revit 2025 normalement. La sidebar Auguste doit apparaître.

Étapes — Revit 2024 (poste avec ancienne version)

Identique mais cibler net481 :

dotnet build src/plugin/AugusteRevit/AugusteRevit.csproj -p:TargetFramework=net481 -c Debug
$src = "src/plugin/AugusteRevit/bin/Debug/net481"
$dst = "$env:APPDATA/Autodesk/Revit/Addins/2024/AugusteRevit"
Copy-Item "$src/AugusteRevit.dll" "$dst/" -Force
Copy-Item "$src/AugusteRevit.pdb" "$dst/" -Force

NE PAS copier les *.deps.json en net481 — ils causent System.Runtime 8.0.0.0 FileNotFoundException. Le Copy-Item ci-dessus exclut explicitement ces fichiers.

Schéma

Vérifier que ça a marché

• Pas d'erreur au build (0 Erreur(s))
• Au démarrage de Revit, onglet Auguste présent
• Sidebar fonctionnelle
• Le fichier %APPDATA%/Auguste/sidebar.log montre des messages récents (date de l'installation)

Si ça ne marche pas

Symptôme	Que faire
FileNotFoundException: AugusteRevit.RevitStubs au lancement	Vous avez compilé avec stubs. Refaire SANS -p:UseRevitStubs=true.
FileNotFoundException: System.Runtime 8.0.0.0 (net48)	Supprimer *.deps.json du dossier addin
Build OK mais sidebar absente	Voir si-le-plugin-ne-souvre-pas.md côté utilisatrice
Revit crash au démarrage	Fermer Revit, supprimer la DLL nouvelle (Remove-Item $dst/AugusteRevit.dll), réinstaller l'ancienne

Ce qu'il ne faut JAMAIS faire

• Déployer avec -p:UseRevitStubs=true
• Copier des *.deps.json ou *RevitStubs* dans le dossier addin
• Forcer Revit (taskkill) s l'administrateur est en train d'utiliser le plugin sans confirmation

Pour aller plus loin

• Skill /push : automatise build + deploy + commit + push en une commande
• Skill /release : pousse une version officielle sur GitHub Releases (auto-update la récupère)

---

Public cible : développeur futur Dernière vérification : 2026-05-15