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.
VSIX-Projekte sind die Standardmethode zum Packen von Visual Studio Erweiterungen für die Verteilung. Unabhängig davon, ob Sie eine VisualStudio.Extensibility-Erweiterung oder eine VSSDK-basierte Erweiterung erstellen, handelt es sich bei der Ausgabe um eine .vsix Datei, die Benutzer über den Erweiterungs-Manager oder den Visual Studio Marketplace installieren.
Important
In diesem Artikel werden ältere VSIX-Projektvorlagen und die Pflege vorhandener Paketierungsprojekte behandelt. Verwenden Sie für neue Projekte in Visual Studio 18.11 oder höher die Modern VSIX Project Template, das die VSIX-Paketierung übernimmt. Hierbei handelt es sich um alternative Projektworkflows, nicht um aufeinander folgende Schritte. Wählen Sie basierend auf Ihrer Entwicklungsumgebung und Ihrem vorhandenen Projekt aus, nicht nur auf der Visual Studio-Version, auf die Ihre Erweiterung abzielt.
Erstellen eines VSIX-Projekts
VSIX-Projektvorlagen sind im Dialogfeld " Neues Projekt erstellen " verfügbar. Suchen Sie nach "VSIX", um sie zu finden:
- VisualStudio.Extensibility Extension – Für Out-of-Process-Erweiterungen mithilfe des neuen Erweiterbarkeitsmodells.
- VSIX Project – Für VSSDK-basierte Erweiterungen oder für das Umschließen mehrerer Erweiterungsausgaben.
- VisualStudio.Extensibility-Erweiterung mit VSSDK-Kompatibilität – Für hybride Erweiterungen, die beide Modelle verwenden.
- Leere VSIX-Project – Ein leerer VSIX-Container zum Verpacken vorhandener Komponenten.
Tip
Für neue Erweiterungen empfehlen wir Visual Studio 18.11 oder höher sowie die Vorlage Modern VSIX Project. Wählen Sie VisualStudio.Extensibility (Out-Of-Process) für Features aus, die von diesem Modell unterstützt werden; Wählen Sie eine VSSDK- oder Hybridoption nur aus, wenn Sie prozessinterne APIs benötigen. Verwenden Sie in früheren Visual Studio Versionen die VisualStudio.Extensibility Extension-Vorlage oder die VSSDK-kompatible Vorlage, wenn Sie VSSDK-APIs benötigen.
Paketerweiterungen in einem VSIX-Projekt
Note
Die source.extension.vsixmanifest Datei und die nachstehenden Schritte gelten nur für VSSDK- und Hybriderweiterungen. VisualStudio.Extensibility (Out-of-Process)-Erweiterungen generieren ihre Metadaten aus dem ExtensionConfiguration.Metadata im Code – es ist keine Manifestdatei erforderlich.
Sie können eine vorhandene Erweiterung oder Komponente verpacken, indem Sie sie in ein VSIX-Projekt umschließen:
- Erstellen Sie ein VSIX-Projekt mithilfe einer der oben genannten Vorlagen.
- Die
source.extension.vsixmanifestDatei wird im Manifest-Designer geöffnet. - Wählen Sie auf der Registerkarte Assets die Option Neu aus, um Komponenten hinzuzufügen.
- Wählen Sie in der Typ-Liste den Typ der hinzuzufügenden Ressource aus (z. B.
Microsoft.VisualStudio.MefComponent,Microsoft.VisualStudio.VsPackage). - Legen Sie Quelle auf Ein Projekt in der aktuellen Lösung fest, und wählen Sie das Projekt aus.
Das VSIX-Format unterstützt das Verpacken von VSPackages, MEF-Komponenten, Assemblys, Projektvorlagen, Elementvorlagen, Toolboxsteuerelementen und benutzerdefinierten Erweiterungstypen.
Hinzufügen von Abhängigkeiten zu einem VSIX-Paket
Sie können Ihr VSIX so konfigurieren, dass es andere Erweiterungen als Abhängigkeiten erfordert. Wenn ein Benutzer Ihre Erweiterung installiert, überprüft das Installationsprogramm, ob alle erforderlichen Abhängigkeiten vorhanden sind.
So fügen Sie eine Abhängigkeit hinzu:
- Öffnen Sie
source.extension.vsixmanifestin der Ansicht Entwurf. - Wechseln Sie zur Registerkarte Abhängigkeiten und wählen Sie Neu aus.
- Wählen Sie Installierte Erweiterung aus, um eine Abhängigkeit von bereits installierten Erweiterungen auszuwählen, oder Datei im Dateisystem, um direkt auf einen anderen VSIX zu verweisen.
Eine bestimmte Visual Studio-Version erfordern
Um eine Mindest-Visual Studio Buildnummer festzulegen, legen Sie den InstallationTarget Versionsbereich fest:
<Installation>
<InstallationTarget Id="Microsoft.VisualStudio.Community" Version="[17.0,)" />
</Installation>
Note
Ab Visual Studio 2026 wird nur die untere Grenze des Versionsbereichs ausgewertet. Die obere Grenze wird zu Kompatibilitätszwecken ignoriert. Siehe Erweiterungskompatibilität.
Erstellen eines Erweiterungspakets
Ein Erweiterungspaket ist eine Reihe von Erweiterungen, die zusammen installiert werden können. Mit Erweiterungspaketen können Sie Ihre bevorzugten Erweiterungen für Kollegen freigeben oder eine Reihe von Erweiterungen für ein Szenario bündeln.
So erstellen Sie ein Erweiterungspaket:
- Erstellen Sie ein neues VSIX-Projekt.
- Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf das Projekt, und wählen Sie"Neues Element>" aus.
- Wählen Sie die Erweiterungspaketvorlage aus. Dadurch wird eine
.vsextDatei hinzugefügt. - Bearbeiten Sie die
.vsextDatei, um die zu enthaltenden Erweiterungen aufzulisten:
{
"id": "MyExtensionPack",
"name": "My Extension Pack",
"description": "A curated set of extensions for my team",
"version": "1.0.0.0",
"extensions": [
{
"vsixId": "41858b2d-ff0b-4a43-80b0-f1b2d6084935",
"name": "AlignAssignments"
},
{
"vsixId": "42374550-426a-400e-96f9-237682e8dea6",
"name": "CopyAsHtml"
}
]
}
- Suchen Sie das
vsixIdim Visual Studio Marketplace ↗ – öffnen Sie die Erweiterungsseite, und wählen Sie „ID kopieren“ aus. - Erstellen und veröffentlichen Sie das Projekt. Weitere Informationen finden Sie unter Auf dem Marketplace veröffentlichen.
Note
Erweiterungspakete können nur Erweiterungen installieren, die auf dem Visual Studio Marketplace ↗ oder einer privaten Galerie verfügbar sind.
Übersicht über die Erweiterungsarchitektur
Wenn Sie wissen, wie Visual Studio Ihre Erweiterung lädt, können Sie bessere Verpackungs- und Bereitstellungsentscheidungen treffen.
VisualStudio.Extensibility (prozessextern)
Prozessexterne Erweiterungen werden in einem separaten Prozess als Visual Studio ausgeführt und kommunizieren über einen JSON-RPC-Kanal:
┌─────────────────────┐ JSON-RPC ┌──────────────────────┐
│ Visual Studio │◄─────────────────────►│ Extension Process │
│ (DevEnv.exe) │ │ (.NET 8+) │
│ │ │ │
│ ┌───────────────┐ │ │ ┌────────────────┐ │
│ │ Extension Host│ │ │ │ Your Extension │ │
│ │ (manages │ │ │ │ Code │ │
│ │ lifecycle) │ │ │ └────────────────┘ │
│ └───────────────┘ │ └──────────────────────┘
└─────────────────────┘
Wichtige Merkmale:
- Die Erweiterung läuft auf modernem .NET (8+).
- Abstürze von Erweiterungsprozessen sind weniger wahrscheinlich, Visual Studio zum Absturz zu bringen
- Installieren/Deinstallieren ohne Neustart von VS
- Installation pro Benutzer (keine Administratorrechte erforderlich)
VSSDK / Hybrid (In-Process)
In-Process-Erweiterungen werden direkt in den Visual Studio Prozess geladen:
┌──────────────────────────────────────────┐
│ Visual Studio (DevEnv.exe) │
│ │
│ ┌────────────────┐ ┌────────────────┐ │
│ │ VS Core │ │ Your Extension │ │
│ │ Services │◄─┤ (.NET Framework│ │
│ │ │ │ or hybrid) │ │
│ └────────────────┘ └────────────────┘ │
└──────────────────────────────────────────┘
Wichtige Merkmale:
- Vollzugriff auf alle VS-APIs und -Dienste
- Beschränkt auf .NET Framework (außer bei Hybrid)
- Erweiterungsfehler können sich auf die VS-Stabilität auswirken
- Erfordert einen VS-Neustart bei der Installation/Aktualisierung
Was ist in einem .vsix-Paket?
Eine .vsix Datei ist ein ZIP-Archiv mit einer Standardstruktur. Die Inhalte unterscheiden sich je nach Erweiterungsmodell:
| Component | VisualStudio.Extensibility | VSSDK |
|---|---|---|
| Erweiterungsmetadaten |
ExtensionConfiguration im Code |
source.extension.vsixmanifest |
| Erweiterungsbinärdateien | Ihre .NET 8+ DLLs | Ihre .NET Framework-DLLs |
| Lokalisierungsdateien | .vsextension/string-resources.json |
.vsixlangpack-Dateien |
| Inhaltstypen | [Content_Types].xml |
[Content_Types].xml |
| Paketmanifest | Automatisch generiert extension.vsixmanifest |
Handverfasst source.extension.vsixmanifest |