Visual Studio-Erweiterungen aktualisieren und migrieren

Dieser Artikel befasst sich mit dem Upgrade einer vorhandenen Erweiterung auf Visual Studio 2026 und der Migration vom Visual Studio SDK (VSSDK) zum VisualStudio.Extensibility-Modell.

Sie müssen die Erweiterbarkeitsmodelle nicht ändern, um eine neuere Visual Studio Version zu unterstützen. Testen Sie zuerst die Kompatibilität, und modernisieren Sie dann nach Bedarf Ihre Build- oder Migrations-APIs.

Upgrade auf Visual Studio 2026

Visual Studio 2022-Erweiterungen lassen sich in Visual Studio 2026 mit minimalen oder ganz ohne Änderungen installieren und ausführen.

Installieren und testen

  1. Installieren Sie Visual Studio 2026.
  2. Öffnen Sie Erweiterungen>Erweiterungen verwalten und lokalisieren Sie Ihre Erweiterungen.
  3. Testen Sie Ihre Erweiterung, um sicherzustellen, dass alle Features ordnungsgemäß funktionieren.

Bahnbrechende Änderungen

Visual Studio 2026 weist nur wenige grundlegende Änderungen auf:

Erfahrungen:

  • Entfernen des IntegratedShell Installationsziels – Aktualisierung auf Microsoft.VisualStudio.Community.
  • Geänderte Häufigkeit des Scannens für SDK-Erweiterungen
  • Entfernen von VSIX-Projektvorlagen im MPF-Stil
  • Entfernung der Bildbibliotheksanzeige

APIs:

  • Entfernung von IGraphProvider API – Verwenden Sie IAttachedCollectionSourceProvider stattdessen.
  • Entfernung öffentlicher APIs in Microsoft.VisualStudio.Text.Internal.dll
  • Entfernen der synchronen QuickInfo-Erweiterbarkeit der Legacyversion – Verwenden Sie die asynchrone QuickInfo-API.
  • Entfernen nicht verwendeter NuGet-Visual Studio Extensibility-APIs

Wenn Ihre Erweiterung auf IntegratedShell abzielt, aktualisieren Sie das Manifest:

<InstallationTarget
  Id="Microsoft.VisualStudio.Community"
  Version="[17.0,)" />

Die vollständige Liste finden Sie auf der Seite zu Breaking Changes ↗ auf GitHub.

Änderungen der Themafarbe

Visual Studio 2026 konsolidiert Designfarbtoken, siehe Modernisieren von Designfarben. Für die Themamigration ist kein neues VSIX-Payload erforderlich.

Migrieren eines VSIX-Projekts zum Visual Studio Projekt-SDK

Informationen zum Modernisieren des Buildsetups eines vorhandenen VSSDK-Projekts, ohne seine Erweiterungs-ID zu ändern oder ein anderes Erweiterbarkeitsmodell zu übernehmen, finden Sie unter Migrieren eines VSIX-Projekts zum Visual Studio Projekt-SDK.

Migration von VSSDK zu VisualStudio.Extensibility

Überprüfen Sie zunächst, ob VisualStudio.Extensibility die Features Ihrer Erweiterung unterstützt. Siehe Szenarien, für die VSSDK erforderlich ist.

Wenn Sie weiterhin VSSDK-APIs benötigen, übernehmen Sie VisualStudio.Extensibility inkrementell in einer hybriden Erweiterung. Beide SDKs werden im Visual Studio Prozess ausgeführt und können Features aus demselben VSIX beitragen. Informationen zu Hinzufügen von VisualStudio.Extensibility zu einem vorhandenen VSSDK-Erweiterungsprojekt für Setup und Dienstinjektion finden Sie unter. VSSDK-Aufrufe behalten ihre Threadinganforderungen bei.

Wenn alle erforderlichen Features über VisualStudio.Extensibility-Entsprechungen verfügen, können Sie vollständig außerhalb des Prozesses migrieren, um Prozessisolation und modernes .NET zu nutzen. Verwenden Sie Erstellen Ihrer ersten Erweiterung, um das Zielprojekt einzurichten, Ihre Features zu portieren und das Testverhalten zu testen, bevor Sie die vorhandene Erweiterung ersetzen.

Die Unterschiede zwischen Architektur und Threading finden Sie unter Detaillierter Vergleich der Erweiterbarkeitsmodelle.