Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Visual Studio 2026 führt ein API-versionsbasiertes Kompatibilitätsmodell ein, das die Notwendigkeit von Erweiterungsupdates über Hauptversionen reduziert. VSIX-Erweiterungen, die für Visual Studio 2022 erstellt wurden, funktionieren weiterhin in Visual Studio 2026 ohne Änderungen, wenn sie auf unterstützte APIs abzielen.
Überblick
Ältere Erweiterungen haben die Kompatibilität erklärt, indem sie die Produktversionsbereiche von Visual Studio im VSIX-Manifest angegeben haben, wobei in der Regel eine Änderung der oberen Grenze für jede neue Hauptversion erforderlich ist. Ab Visual Studio 2026 wird die Kompatibilität von der API-Versionsunterstützung anstelle von Produktversionen gesteuert, sodass die meisten Visual Studio 2022-Erweiterungen in Visual Studio 2026 ohne erneute Veröffentlichung geladen werden können.
Wichtige Prinzipien
Erweiterungen deklarieren API-Versionen, nicht Produktversionen. Zur Ladezeit wertet Visual Studio die API-Versionen als Erweiterungsziele aus und lädt nur kompatible Erweiterungen.
Stabile APIs vermeiden inkompatible Änderungen. Mit Ausnahme wichtiger Plattformverschiebungen (z. B. der Wechsel zur 64-Bit-Version in Visual Studio 2022) zielt die Plattform darauf ab, die Abwärtskompatibilität für stabile APIs beizubehalten.
Neue APIs sind zunächst additiv und zuerst in der Vorschau. Vorschau-APIs können sich ändern oder entfernen und werden für Produktionserweiterungen oder die Veröffentlichung im Visual Studio Marketplace nicht unterstützt.
Auswirkungen auf vorhandene Erweiterungen
Wenn Ihre VSIX-Erweiterung in Visual Studio 2022 funktioniert, sind keine Änderungen für Visual Studio 2026 erforderlich. Visual Studio 2026:
- Unterstützt API Version 17.x.
- Bewertet die Kompatibilität, indem nur die untere Grenze des Installationszielversionsbereichs genutzt wird.
- Ignoriert die obere Grenze des Bereichs.
Example
Eine Erweiterung mit diesem Installationsziel wird sowohl in Visual Studio 2022 als auch in Visual Studio 2026 ausgeführt:
<InstallationTarget
Id="Microsoft.VisualStudio.Community"
Version="[17.0,18.0)" />
Neue Erweiterungen, die in Visual Studio 2026 erstellt wurden
Wenn Sie eine Erweiterung in Visual Studio 2026 erstellen, wird das VSIX-Manifest mit einer unteren Grenze von 17.0 und ohne Obergrenze konfiguriert:
<InstallationTarget
Id="Microsoft.VisualStudio.Community"
Version="[17.0,)" />
Diese Konfiguration ermöglicht die Ausführung der Erweiterung sowohl für Visual Studio 2022 als auch für Visual Studio 2026 ohne Änderung.
Testen und Problembehandlung
Auch wenn keine Änderungen erwartet werden, testen Sie die Erweiterung in Visual Studio 2026, um Folgendes abzufangen:
- Verhaltensänderungen.
- Plattformprobleme.
- Nicht unterstützte API-Verwendung.
Wenn Sie auf ein Plattformproblem stoßen, melden Sie es mit "Problem melden" in Visual Studio.
MSI-basierte Erweiterungen
Das Kompatibilitätsmodell gilt nur für VSIX-Erweiterungen. Für MSI-verteilte Erweiterungen:
- Visual Studio verwaltet keine Installation oder Kompatibilität.
- Sie sind für die Anpassung des Installers für Visual Studio 2026 verantwortlich.
- Die automatische Migration von älteren Visual Studio-Versionen gilt nicht.
Tipp
Verwenden Sie VSIX so oft wie möglich zur Verteilung. Die MSI-basierte Installation sollte nur für benutzerdefinierte Verteilungsanforderungen verwendet werden.