VSIX-Bereitstellung
Sie können das VSIX-Format zu packen projektvorlagen, Elementvorlagen in Visual Studio-Integrations-Paket-, Managed Extensibility Framework (MEF) Bestandteilen, in Toolbox-Steuerelementen zu den Assemblys und benutzerdefinierte Typen können benutzerdefinierte Startseiten (einschließlich). Das VSIX-Format verwendet dateibasierte Bereitstellung und unterstützt das Schreiben nicht im globalen Assemblycache (GAC) oder die Systemregistrierung. Es wird empfohlen, VSIX-Bereitstellung für die Arten von Erweiterungen verwenden, die sie unterstützen.
Wenn Sie Erweiterungen hochladen, die im VSIX-Paketformat auf die Site Visual Studio Gallery verfügen, können Benutzer Erweiterungs-Manager verwenden, um sie zu finden und zu installieren. Weitere Informationen zu Erweiterungs-Managerfinden Sie unter Verwalten von Erweiterungen und Updates für Visual Studio.
Das VSIX-Format unterstützt nicht die Installation von Makros, Add-Ins und Codeausschnitte. Sie unterstützt auch bestimmte andere Szenarien, z. B. Schreiben registrierungsschlüssel nicht während des Setups. Einen Vergleich von anderen verfügbaren Bereitstellungsstrategien finden Sie unter Bereitstellung von Erweiterungen für Visual Studio.
Um Konflikte zu vermeiden, wenn Sie eine Erweiterung entwickeln, empfiehlt es sich, dass Sie frühere Versionen der Erweiterung deinstallieren, und Erweiterungen deinstallieren oder kontroverse möglicherweise deaktivieren.
Das VSIX-Paket
Ein VSIX-Paket ist eine komprimierte Datei, die dem OPC (Open Packaging Conventions)-Standard folgt. Das Paket enthält Binärdateien und Sichern von Dateien zusammen mit einer [Content_Types] .xml Datei und eine VSIX-Manifestdatei. Ein VSIX-Paket enthält möglicherweise die Ausgabe von mehreren Projekten oder sogar mehrere Pakete, die ihre eigenen Manifeste verfügen. Weitere Informationen über den Inhalt eines VSIX-Pakets finden Sie unter Aufbau eines VSIX-Pakets.
Die meisten Projektvorlagen in Visual Studio SDK Erstellen eines VSIX-Pakets für Sie, wenn Sie das Projekt erstellen. Sie können ein VSIX-Paket um die Erweiterung auch erstellen, indem Sie ein Leerzeichen VSIX Projekt erstellen, und anschließend die Erweiterung hinzufügen. Weitere Informationen darüber, wie Sie ein VSIX-Paket finden Sie unter VSIX-Projektvorlageerstellt.
Hinweis
Namen von Dateien, die in VSIX-Paketen enthalten sind, dürfen Leerzeichen immer noch Zeichen einschließen, die in der Spezifikation der Uniform Resource Identifier (URI) reserviert sind, z. B. nicht unter [RFC2396]definiert.
Installationsspeicherort
Während der Installation uncompresses Erweiterungs-Manager die VSIX-Datei und legt seinen Inhalt in %LocalAppData% \ Microsoft \ VisualStudio \ 10.0 \ Extensions \\ UnternehmenProdukt\ \Versionein. Firma, Produktund Version werden in der Datei " extension.vsixmanifest " angegeben und entsprechen dem Namespace, in den Projektnamen und die Versionsnummer, die in den Projekteigenschaften festgelegt werden.
Standardmäßig gilt die Installation nur für den aktuellen Benutzer daran, dass ein %LocalAppData% benutzerspezifisches Verzeichnis befindet. Wenn Sie jedoch den AllUsers-Element des Manifests zu True, die Erweiterung in. installiert werden. \ IstOrdner Visual Studio-Installations\ Common7 \ IDE \ Extensions \OrganisationProdukt\ \. \Versionund für alle Benutzer des Systems verfügbar.
Behandeln von Abhängigkeiten
Wenn ein Benutzer versucht, eine Erweiterung zu installieren, die Abhängigkeiten enthält, überprüft das Installationsprogramm, dass die erforderlichen Assemblys auf dem Benutzersystem installiert werden. Wenn die erforderlichen Assemblys nicht gefunden werden, wird Erweiterungs-Manager dem Benutzer eine Liste der fehlenden Assembly an.
Wenn das Add-In manifest eine oder mehrere Verweis-Elemente enthält, vergleicht Erweiterungs-Manager das Manifest jedes Verweises auf den Erweiterungen, die auf dem System installiert sind, und installiert die referenzierte Erweiterung, falls sie nicht bereits installiert ist. Wenn eine ältere Version einer Erweiterung installiert ist, auf den verwiesen wird, die neuere Version ersetzt sie.
Standardmäßig in einer Projektmappe mit mehreren Projekten, wenn ein Projekt, das in ein VSIX-Paket ausgibt, einen Verweis auf ein anderes Projekt in der Projektmappe enthält, enthält sie die Abhängigkeiten dieses Projekts ein. Sie können dieses Verhalten überschreiben, indem Sie auf den Verweis für das interne Projekt, und klicken Sie dann im Fenster Eigenschaften klicken und die In VSIX eingeschlossene Ausgabegruppen-Eigenschaft auf BuiltProjectOutputGroupfestlegen.
Veröffentlichung
Sie können ein VSIX-Paket verteilen, indem Sie sie auf die Visual Studio Gallery Website platzieren, sodass sie auf die Visual Studio-Benutzern über Erweiterungs-Managerverfügbar ist. Wahlweise können Sie das Paket an eine andere Website oder eine Netzwerkfreigabe hochladen, sodass Benutzer die Erweiterung installieren können, indem sie auf die VSIX-Datei entsprechend den Anweisungen und doppelklicken.
Private Kataloge
Sie können die Steuerelemente, die Vorlagen und Tools verwenden, die Sie innerhalb einer Organisation über ein Intranet entwickeln, indem Sie sie auf ein privates Katalog senden. Weitere Informationen finden Sie unter Private Kataloge.
Verwandte Themen
Titel |
Beschreibung |
|---|---|
Beschreibt die Komponenten eines VSIX-Pakets. |
|
Stellt schrittweise Anweisungen für das Verpacken und veröffentlicht eine Erweiterung. |
|
Erklärt, wie lokalisierten Text für den Installationsvorgang für die Verwendung von extension.vsixlangpack-Dateien bereitstellt. |
|
Beschreibt, wie eine Erweiterung auf dem System aktualisiert und wie eine Aktualisierung auf eine vorhandene Visual Studio-Erweiterung bereitstellt. |
|
Vorgehensweise: Hinzufügen eines Verweises zu einem VSIX-Paket |
Beschreibt, wie Verweise auf VSIX-Bereitstellungs paketen hinzugefügt wird. |