VSIX-Manifest-Designer

  • Artikel

Ändert eine VSIX-Paketmanifestdatei, die das Installationsverhalten für eine Visual Studio-Erweiterung festlegt.

Der VSIX-Manifest-Designer wird dem zugrunde liegenden VSIX-Schema zugeordnet. Jedes Element im Schema kann mithilfe eines entsprechenden Steuerelements im Designer festgelegt werden. Weitere Informationen zum Schema finden Sie unter VSIX Extension Schema 2.0 Reference.

Um den VSIX-Manifest-Designer zu öffnen, suchen Sie in Projektmappen-Explorer eine Datei "source.extension.vsixmanifest", und öffnen Sie die Datei. Wenn die Datei keine gültige XML-Datei enthält, wird der Manifest-Designer nicht geöffnet.

Hinweis

Die Datei "source.extension.vsixmanifest " wird beim Erstellen des Pakets in "extension.vsixmanifest " ausgegeben.

UIElement-Liste

Der VSIX-Manifest-Designer enthält vier Abschnitte, die diesen Elementen der obersten Ebene des Schemas entsprechen:

  • Metadaten
  • Ziele installieren
  • Objekte
  • Abhängigkeiten

Der Überschriftenbereich enthält die folgenden Steuerelemente:

  • Der Produktname beschreibt den Erweiterungsnamen.
  • Die Produkt-ID gibt die eindeutigen Identifikationsinformationen für dieses Paket an.
  • Autor gibt den Namen des Autors der Erweiterung an.
  • Version gibt die Versionsnummer der Erweiterung an.

Die Registerkarte "Metadaten " enthält die folgenden Steuerelemente:

  • Beschreibung enthält eine Textbeschreibung der Erweiterung, die im Erweiterungs-Manager angezeigt werden soll.
  • Die Sprache gibt die Standardsprache für das Paket an, die den Textdaten im Manifest entspricht. Das Language Attribut folgt der Common Language Runtime (CLR)-Gebietsschemacodekonvention für Ressourcenassemblys, z. B. "en-us", "en", "fr-fr". Der Wert ist standardmäßig neutral, was bedeutet, dass das Paket auf jeder Sprachversion von Visual Studio ausgeführt wird.
  • Die Lizenz gibt die Textdatei an, die die Benutzerlizenz enthält, sofern vorhanden.
  • Das Symbol gibt die Grafikdatei (PNG, BMP, JPEG, ICO) an, die das Symbol enthält, das im Erweiterungs-Manager angezeigt werden soll, wenn ein Symbol vorhanden ist. Das Symbolbild muss 32 x 32 Pixel sein, oder die Größe wird auf diese Abmessungen angepasst. Wenn kein Symbol angegeben ist, verwendet der Erweiterungs-Manager ein Standardsymbol.
  • Das Vorschaubild gibt die Grafikdatei (PNG, BMP, JPEG, ICO) an, die das Vorschaubild enthält, das im Erweiterungs-Manager angezeigt werden soll, wenn ein Vorschaubild vorhanden ist. Das Vorschaubild muss 200 x 200 Pixel betragen. Wenn kein Vorschaubild angegeben ist, verwendet der Erweiterungs-Manager ein Standardbild.
  • Tags fügen Texttags hinzu, die für Suchhinweise verwendet werden sollen.
  • Versionshinweise geben eine Datei (.txt, RTF) an, die Versionshinweise enthält. Es kann sich dabei auch um die URL einer Website handeln, auf der die Anmerkungen zu diesem Release enthalten sind.
  • Der Leitfaden für erste Schritte gibt eine Datei (.txt, RTF) an, die Informationen zur Verwendung der Erweiterung oder des Inhalts im VSIX-Paket enthält. Dieses Handbuch wird angezeigt, wenn die Erweiterungsinstallation abgeschlossen ist. Übernimmt auch die URL einer Website, die den Leitfaden anzeigt.
  • Weitere Info-URL gibt die URL einer Website an, die zusätzliche Informationen zum Produkt enthält.

Die Registerkarte "Ziele installieren" enthält die folgenden Steuerelemente:

  • Installationstyp listet Visual Studio Extension and Extension SDK als Zielinstallationstypen auf. Die Optionen unterscheiden sich je nach gewählter Art.

    • Die Visual Studio-Erweiterung enthält die InstallationTarget-Elemente, die beschreiben, wie das Paket installiert werden kann und in welche Visual Studio-Produkte diese Erweiterung installiert werden kann. Jedes Produkt wird separat anhand des Namens und einer Version oder eines Versionsbereichs identifiziert. Produkte können der Liste, Änderung und Löschung hinzugefügt werden. Der Name und die Version eines Produkts entsprechen den Id- und Version-Attributen des zugeordneten InstallationTarget-Elements .

      • Der Versionsbereich ist [12.0, 14.0] und verwendet die folgende Schreibweise:
        • [ – Mindestversion inklusive
        • ] - Maximale Version inklusive
        • ( - Mindestversion exklusiv
        • ) - maximale Version exklusiv
        • Einzelne Version # – nur die angegebene Version

    • Das Erweiterungs-SDK gibt eine globale Installation an, die nicht auf ein bestimmtes Produkt und eine bestimmte Version festgelegt ist. Die Zielplattform-ID ist die Plattform, z. B . "Windows", auf die Sie abzielen. Die Zielplattformversion ist die Version, z. B. 8.0, Ihrer Zielplattform. SDK-Name und SDK-Version sind der Name bzw. die Versionsnummer des SDK.

  • Dieser VSIX wird für alle Benutzer installiert (erfordert die Erhöhung bei der Installation). Wenn Sie dieses Kontrollkästchen aktivieren, wird die Erweiterung für alle Benutzer installiert. andernfalls wird sie nur für den aktuellen Benutzer installiert.

  • Dieser VSIX wird von Windows Installer installiert. Wenn Sie dieses Kontrollkästchen aktivieren, wird die Erweiterung vom Windows Installer (MSI-Datei ) installiert. Andernfalls wird sie als typische VSIX-Paketdatei (VSIX-Datei ) installiert.

Die Registerkarte "Objekte " enthält die folgenden Steuerelemente:

  • Liste der Ressourcen listet die Asset-Elemente auf, die die Erweiterungs- oder Inhaltselemente beschreiben, die dieses Paket anzeigt. Jede Erweiterung oder jedes Inhaltselement wird separat nach Quelle, Typ und Pfad aufgeführt. Erweiterungen und Inhaltselemente können der Liste hinzugefügt, geändert und gelöscht werden. Der Typ und Pfad einer Erweiterung oder eines Inhaltselements entspricht den Type Attributen Path und Attributen des zugeordneten Asset Elements. Die folgenden Typen werden unterstützt:

    • Microsoft.VisualStudio.Package
    • Microsoft.VisualStudio.MefComponent
    • Microsoft.VisualStudio.ToolboxControl
    • Microsoft.VisualStudio.Samples
    • Microsoft.VisualStudio.ProjectTemplate
    • Microsoft.VisualStudio.ItemTemplate
    • Microsoft.VisualStudio.Assembly
    • Microsoft.ExtensionSDK

    Um eine Ressource hinzuzufügen oder zu bearbeiten, müssen Sie den Objekttyp angeben, unabhängig davon, ob es sich bei der Ressource um ein Projekt in der aktuellen Projektmappe oder um eine Datei im Dateisystem handelt, und den Namen des Projekts. Sie können auch den Namen des Ordners angeben, in den sie eingebettet werden sollen.

    Sie können auch eigene Typen erstellen und ihnen eindeutige Namen zuweisen.

Die Registerkarte "Abhängigkeiten " enthält die folgenden Steuerelemente:

  • Name, Quelle und Versionsbereich listet die Abhängigkeitselemente dieses Pakets auf, die andere Pakete sind, von denen dieses Paket abhängt. Wenn ein Abhängigkeitspaket angegeben ist, muss es installiert werden, bevor dieses Paket installiert wird. andernfalls muss es von diesem Paket installiert werden.

    Abhängigkeitspakete werden durch Bezeichner, Name, Versionsbereich, Quelle und die Auflösung der Abhängigkeit angegeben. Jedes Abhängigkeitspaket wird separat nach Name, Version und Quelle aufgeführt. Abhängigkeitspakete können der Liste, Änderung und Löschung hinzugefügt werden.

    Der Bezeichner muss mit dem ID Attribut der Metadaten des Abhängigkeitspakets übereinstimmen. Die Quelle kann ein Projekt in der aktuellen Lösung, eine aktuell installierte Erweiterung oder eine Datei sein. Die Einstellung zum Auflösen von Abhängigkeiten kann der relative Pfad eines geschachtelten Pakets oder die URL des Downloadspeicherorts für die Abhängigkeit sein. Die ID, die Version und die Auflösung des Abhängigkeitspakets entsprechen den IdAttributen Versionund Location Attributen des zugeordneten Dependency Elements.

Siehe auch