Поделиться через

Конструктор манифеста VSIX

  • Статья

Изменяет файл манифеста пакета VSIX, который задает поведение установки для расширения Visual Studio.

Конструктор манифестов VSIX сопоставляется с базовой схемой VSIX. Каждый элемент схемы можно задать с помощью соответствующего элемента управления в конструкторе. Дополнительные сведения о схеме см. в справочнике по схеме расширения VSIX 2.0.

Чтобы открыть конструктор манифестов VSIX, найдите файл source.extension.vsixmanifest в Обозреватель решений и откройте файл. Если файл не содержит допустимый XML, конструктор манифестов не откроется.

Примечание.

Файл source.extension.vsixmanifest выводится в extension.vsixmanifest при построении пакета.

Список элементов пользовательского интерфейса (UIElement)

Конструктор манифестов VSIX содержит четыре раздела, соответствующие этим элементам схемы верхнего уровня:

  • Метаданные
  • Установка целевых объектов
  • Ресурсы
  • Зависимости

Область заголовка содержит следующие элементы управления:

  • Имя продукта описывает имя расширения.
  • Идентификатор продукта указывает уникальные идентификационные данные для этого пакета.
  • Автор задает имя автора расширения.
  • Версия указывает номер версии расширения.

Вкладка метаданных содержит следующие элементы управления:

  • Описание содержит текстовое описание расширения, отображаемое в диспетчере расширений.
  • Язык задает язык по умолчанию для пакета, соответствующий текстовым данным манифеста. Атрибут Language следует соглашению о языковом стандарте среды CLR для сборок ресурсов, например en-us, en, fr-fr. По умолчанию значение является нейтральным, что означает, что пакет будет выполняться в любой языковой версии Visual Studio.
  • Лицензия указывает текстовый файл, содержащий лицензию пользователя, если он присутствует.
  • Значок задает графический файл (PNG, BMP, JPEG, ICO), содержащий значок, отображаемый в диспетчере расширений, если значок присутствует. Изображение значка должно иметь размер 32x32 пикселей или изменить размер этих измерений. Если значок не указан, диспетчер расширений использует значок по умолчанию.
  • Изображение предварительного просмотра указывает графический файл (.png, BMP, JPEG, ICO), содержащий изображение предварительного просмотра, отображаемое в диспетчере расширений, если изображение предварительного просмотра присутствует. Изображение предварительного просмотра должно быть 200x200 пикселей. Если образ предварительной версии не указан, диспетчер расширений использует образ по умолчанию.
  • Теги добавляют текстовые теги для использования для подсказок поиска.
  • Заметки о выпуске указывают файл (TXT, RTF), содержащий заметки о выпуске. Также принимает URL-адрес веб-сайта, отображающего заметки о выпуске.
  • Руководство по началу работы указывает файл (.txt, RTF), содержащий сведения об использовании расширения или содержимого пакета VSIX. Это руководство появляется после завершения установки расширения. Также принимает URL-адрес веб-сайта, отображающего руководство.
  • Дополнительные сведения о URL-адресе указывает URL-адрес веб-сайта, содержащего дополнительные сведения о продукте.

Вкладка "Целевые объекты установки" содержит следующие элементы управления:

  • Тип установки содержит список пакетов SDK расширений и расширений Visual Studio в качестве целевых типов установки. Параметры различаются в зависимости от выбранного типа.

    • Расширение Visual Studio содержит элементы InstallationTarget , описывающие, как можно установить пакет и в какой продукт Visual Studio можно установить это расширение. Каждый продукт определяется отдельно по имени и диапазону версий или версий. Продукты можно добавлять в список, изменять и удалять. Имя и версия продукта соответствуют атрибутам идентификатора и версии связанного элемента InstallationTarget .

      • Диапазон версий [ 12.0, 14.0] и использует следующую нотацию:
        • [ — минимальная версия включительно
        • ] — максимальная версия включительно
        • ( — минимальная версия, исключаемая
        • ) — максимальная версия, исключаемая
        • Отдельная версия # — только указанная версия

    • Пакет SDK расширений указывает глобальную установку, которая не область определенному продукту и версии. Идентификатор целевой платформы — это платформа, например "Windows", предназначенная для вас. Целевая версия платформы — это версия , например 8.0, целевой платформы. Имя пакета SDK и версия пакета SDK — это имя и номер версии пакета SDK соответственно.

  • Этот VSIX устанавливается для всех пользователей (требуется повышение прав при установке).a0> Если выбрать этот проверка поле, расширение устанавливается для всех пользователей; в противном случае оно устанавливается только для текущего пользователя.

  • Этот VSIX устанавливается установщиком Windows. Если выбрать этот проверка поле, расширение устанавливается установщиком Windows (MSI-файл); в противном случае оно устанавливается как типичный пакет VSIX (VSIX-файл).

Вкладка "Активы" содержит следующие элементы управления:

  • Список ресурсов содержит элементы ресурса, описывающие элементы расширения или содержимого, которые будут отображаться в этом пакете. Каждый элемент расширения или содержимого указывается отдельно по источнику, типу и пути. Расширения и элементы содержимого можно добавлять в список, изменять и удалять. Тип и путь к элементу расширения или содержимого соответствует Type атрибутам Path связанного Asset элемента. Поддерживаются такие типы:

    • Пакет Microsoft.VisualStudio.Package
    • Microsoft.VisualStudio.MefComponent
    • Microsoft.VisualStudio.ToolboxControl
    • Microsoft.VisualStudio.Samples
    • Microsoft.VisualStudio.ProjectTemplate
    • Microsoft.VisualStudio.ItemTemplate
    • Microsoft.VisualStudio.Assembly
    • Microsoft.ExtensionSDK

    Чтобы добавить или изменить ресурс, необходимо указать тип ресурса, является ли ресурс проектом в текущем решении или файлом в файловой системе, а также именем проекта. Можно также указать имя папки, в которую необходимо внедрить.

    Вы также можете создать собственные типы и дать им уникальные имена.

Вкладка "Зависимости" содержит следующие элементы управления:

  • Имя, источник и диапазон версий перечисляют элементы зависимостей этого пакета, от которых зависят другие пакеты. Если указан пакет зависимостей, его необходимо установить перед установкой этого пакета; в противном случае этот пакет должен установить его.

    Пакеты зависимостей задаются идентификатором, именем, диапазоном версий, источником и способом разрешения зависимостей. Каждый пакет зависимостей указывается отдельно по имени, версии и источнику. Пакеты зависимостей можно добавлять в список, изменять и удалять.

    Идентификатор должен соответствовать атрибуту ID метаданных пакета зависимостей. Источник может быть проектом в текущем решении, установленным расширением или файлом. Параметр разрешения зависимостей может быть относительным путем вложенного пакета или URL-адресом расположения загрузки для зависимости. Идентификатор, версия и разрешение пакета зависимостей соответствуют IdVersionатрибутам связанного Dependency элемента и Location атрибутам.

См. также