Как установить файл vsix в visual studio

Начало работы с шаблоном проекта VSIX

Шаблон проекта VSIX можно использовать для создания расширения или упаковки существующего расширения для развертывания. Шаблон проекта VSIX содержит версии Visual Basic и Visual C# и устанавливается в составе пакета SDK Visual Studio.

Шаблон проекта VSIX состоит только из source.extension.vsixmanifest файла, содержащего сведения о расширении и ресурсах, которые он поставляет.

Чтобы найти шаблон проекта VSIX, необходимо установить пакет SDK Visual Studio. См. дополнительные сведения о пакете SDK для Visual Studio.

Развертывание пользовательского шаблона проекта с помощью шаблона проекта VSIX

Ниже показано, как использовать проект VSIX для упаковки шаблона проекта, который можно предоставить другим разработчикам или отправить в коллекцию Visual Studio.

1. Создайте шаблон проекта.
   1. Откройте проект, из которого нужно создать шаблон. Этот проект может иметь любой тип проекта.
   2. В меню Проект выберите команду Экспорт шаблона. Выполните действия мастера. Файл .zip создается в %USERPROFILE%\My Documents\Visual Studio \My Exported Templates\ .
   • Задайте для поля «Имя продукта» значение «Мой шаблон проекта».
   • Задайте для поля «Идентификатор продукта» значение MyProjectTemplate — 1.
   • Задайте для поля Author значение Fabrikam.
   • Задайте для поля «Описание« шаблон проекта «Мой».
   • В разделе «Активы» добавьте тип Microsoft.VisualStudio.ProjectTemplate и задайте путь к имени файла .zip.

   Указание расположения шаблона в диалоговом окне «Новый проект»

   1. Папки шаблонов находятся в \Common7\IDE\ProjectTemplates каталогах и \Common7\IDE\ItemTemplates каталогах. Имена разделов верхнего уровня в диалоговом окне «Новый проект » не совпадают с именами папок шаблона. Где они отличаются, используйте имя папки шаблона. Измените .vsix расширение .zip файла на , а затем откройте файл.
   2. Создайте новую папку с тем же именем, что и раздел диалогового окна «Новый проект» , в который должен появиться шаблон.
   3. Если шаблон будет отображаться в подразделе, создайте вложенную папку с тем же именем.
   4. Переместите файл шаблона .zip в новую папку.
   5. Измените .zip расширение .vsix на .
   6. Откройте манифест VSIX.
   7. В манифесте VSIX обновите путь ресурса шаблона, чтобы он указывает на корень дерева каталогов, содержащего файл шаблона. Например, если шаблон находится в \CSharp\Windows , ссылка должна указывать на \CSharp .

   Поиск, установка и управление расширениями для Visual Studio

   Расширения — это пакеты кода, которые выполняются в Visual Studio и предоставляют новые или улучшенные функции. Расширения могут быть элементами управления, примерами, шаблонами, инструментами или другими компонентами, которые добавляют функциональные возможности в Visual Studio, например Live Share или GitHub Copilot.

   Сведения о создании расширений Visual Studio см. в разделе Visual Studio SDK. Сведения об использовании расширений см. на страницах отдельных расширений в Visual Studio Marketplace. Дополнительные сведения о поиске расширений см. в записи блога Где мои избранные расширения в Visual Studio 2022?.

   Дополнительные сведения о новой модели расширяемости в настоящее время в предварительной версии см. в записи блога Build Better Extensions with VisualStudio.Extensibility (preview 3).

   Расширения — это пакеты кода, которые выполняются в Visual Studio и предоставляют новые или улучшенные функции. Расширения могут быть элементами управления, примерами, шаблонами, инструментами или другими компонентами, которые добавляют функциональные возможности в Visual Studio, например Live Share или GitHub Copilot.

   Сведения о создании расширений Visual Studio см. в разделе Visual Studio SDK. Сведения об использовании расширений см. на страницах отдельных расширений в Visual Studio Marketplace.

   Диалоговое окно «Управление расширениями»

   В интегрированной среде разработки Visual Studio диалоговое окно «Управление расширениями » — это средство, используемое для поиска, установки и управления расширениями Visual Studio. Чтобы открыть диалоговое окно Управление расширениями, выберите Расширения>Управление расширениями. Или введите расширения в поле поиска и выберите «Управление расширениями«.

   

   Левая панель классифицирует расширения по установленным, доступным в Visual Studio Marketplace (Online) и доступными обновлениями. Диспетчер перемещаемых расширений хранит список всех расширений Visual Studio, которые вы установили на любом компьютере или экземпляре Visual Studio. С его помощью вы легко сможете находить нужные вам расширения.

   Поиск и установка расширений

   Расширения можно установить в Visual Studio Marketplace или в диалоговом окне «Управление расширениями » в Visual Studio.

   Чтобы установить расширения из Visual Studio, выполните указанные ниже действия.

   1. В диалоговом окне Расширения>Управление расширениями найдите расширение, которое вы намерены установить. (Если известно имя или часть имени расширения, можно выполнить поиск в окне Поиск.)
   2. Щелкните Скачать.

   После завершения скачивания вы увидите уведомление в нижней части диалогового окна «Управление расширениями «: «Расширение запланировано на установку. Расширение будет установлено после закрытия всех экземпляров Visual Studio».

   

   При попытке установить расширение, имеющее зависимости, то установщик проверяет, установлены ли эти зависимости. Если они не установлены, то в диалоговом окне Управление расширениями отображается список зависимостей, которые требуется установить перед установкой этого расширения.

   Установка без использования диалогового окна «Управление расширениями»

   Расширения, которые были упакованы в VSIX-файлах , могут быть доступны в расположениях, отличных от Visual Studio Marketplace. Несмотря на то что VSIX-файлы не обнаруживаются в диалоговом окне Расширения>Управление расширениями, такой файл можно установить, дважды щелкнув его или выбрав файл и нажав клавишу ВВОД. После этого следуйте инструкциям. После установки такое расширение можно будет включить, отключить или удалить в диалоговом окне Управление расширениями.

   • Visual Studio Marketplace содержит расширения VSIX и MSI. Диалоговое окно «Управление расширениями» не может включать или отключать расширения на основе MSI.
   • Если расширение MSI содержит файл extension.vsixmanifest, оно появляется в диалоговом окне Управление расширениями.

   Удаление или отключение расширения

   Если требуется прекратить использование расширения, его можно отключить или удалить. Отключенное расширение сохранится, но не будет загружаться. Найдите расширение и выберите «Удалить » или «Отключить«. Перезапустите Visual Studio, чтобы выгрузить отключенное расширение.

   Отключать можно только расширения VSIX, но не расширения, которые были установлены с помощью MSI. Расширения, установленные с помощью MSI, можно только удалить.

   Управление расширениями

   Если вы управляете расширениями для организации или хотите узнать больше об автоматическом обновлении расширений, неответствующих уведомлениях и т. д., вы находитесь в правильном месте.

   Расширения на уровне пользователя и администратора

   Большинство расширений являются на пользователя и устанавливаются в папку %LocalAppData%\Microsoft\VisualStudio<\Visual Studio version>\Extensions\ . Несколько расширений являются административными расширениями и устанавливаются в папку <>установки Visual Studio\Common7\IDE\Extensions\.

   Чтобы защитить систему от расширений, которые могут содержать ошибки или вредоносный код, можно ограничить для каждого пользователя расширения загружаться только в том случае, если Visual Studio выполняется с обычными разрешениями пользователя. Это означает, что расширения на уровне пользователя отключаются при запуске Visual Studio с повышенными разрешениями.

   Чтобы ограничить загрузку расширений на уровне пользователя, выполните указанные ниже действия.

   1. Откройте страницу параметров расширений (Сервис>Параметры>Среда>Расширения).
   2. Снимите флажок Загружать расширения пользователей при выполнении от имени администратора.
   3. Перезапустите Visual Studio.

   Автоматическое обновление расширений

   Расширения обновляются автоматически при появлении новой версии в Visual Studio Marketplace. Новая версия расширения обнаруживается и устанавливается в фоновом режиме. При следующем открытии Visual Studio будет запущена новая версия расширения.

   Функцию автоматического обновления можно отключить для всех или только определенных расширений.

   • Чтобы отключить автоматическое обновление для всех расширений, щелкните ссылку Измените параметры расширений в диалоговом окне Расширения>Управление расширениями. В диалоговом окне Параметры снимите флажок Автоматически обновлять расширения.
   • Чтобы отключить автоматическое обновление для конкретного расширения, снимите флажок Автоматически обновлять это расширение в области сведений о расширении в правой части диалогового окна Управление расширениями.

   Уведомления об аварийном завершении работы или зависаниях

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

   Visual Studio оповещает еще и о тех расширениях, которые могут приводить к недоступности интерфейса.

   Получив такое оповещение, вы можете проигнорировать его или выполнить одно из следующих действий.

   • Выберите Отключить это расширение. Visual Studio отключает расширение и сообщает, нужно ли перезагрузить компьютер, чтобы отключение вступило в силу. Если потребуется, вы можете снова включить расширение в диалоговом окне Расширения>Управление расширениями.
   • Выберите Больше не показывать это сообщение.
     • Если уведомление относилось к аварийному завершению в предыдущем сеансе, в Visual Studio больше не будет отображаться уведомление при аварийном завершении работы этого расширения. Этот выбор не влияет на уведомления Visual Studio о зависаниях, связанных с этим расширением, а также об аварийных завершениях и зависаниях, связанных с другими расширениями.
     • Если же уведомление относилось к зависанию, в интегрированной среде разработки (IDE) больше не будут появляться уведомления о том, что это расширение связано с зависаниями. В Visual Studio по-прежнему будут отображаться уведомления об аварийном завершении работы этого расширения, а также об аварийном завершении работы и зависаниях других расширений.

     Уведомление о зависании или аварийном завершении пользовательского интерфейса означает только то, что один из модулей конкретного расширения находился в стеке в тот момент, когда произошло аварийное завершение. Это не обязательно означает, что само расширение было виновником. Возможно, расширение вызвало внутренний код Visual Studio, который привел к аварийному завершению или зависанию пользовательского интерфейса. Однако уведомление может по-прежнему быть полезным, если расширение, которое привело к неответственности пользовательского интерфейса или аварийному сбою, не важно для вас. Отключив такое расширение, вы сможете избежать аналогичных проблем в будущем без ущерба для производительности.

     Примеры

     При установке примера из сети решение сохраняется в двух местоположениях:

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

     С помощью диалогового окна Расширения>Управление расширениями можно выполнить следующие задачи, связанные с примерами.

     • Отобразить список контрольных экземпляров установленных образцов.
     • Отключить или удалить контрольный экземпляр образца.
     • Установить пакеты примеров — коллекции примеров, связанных с определенной технологией или функцией.
     • Установить отдельные примеры из сети.
     • Просмотреть уведомления об обновлениях, когда будут опубликованы изменения в исходном коде для установленных примеров.
     • Обновите главную копию установленного примера при наличии уведомления об обновлении.

     Связанный контент

     • SDK для Visual Studio
     • Страница расширяемости Visual Studio.
     • Visual Studio Marketplace
     • Поддержка пакета SDK для Visual Studio

     Установка

     Вы можете установить расширение из магазина приложений Visual Studio Marketplace или из VSIX-файла. VSIX-файлы публикуются на портале ИТС.

     Установка из Visual Studio Marketplace

     • Откройте панель Extensions (Ctrl+Shift+X);
     • В строке поиска введите Executor ;
     • Нажмите Install ;

     Установка из VSIX-файла: вариант 1

     • В Visual Studio Code нажмите F1 для активации командной палитры;
     • Наберите vsix ;
     • Выполните команду Extensions: Install from VSIX. (Расширения: Установка из VSIX. );
     • Выберите VSIX-файл и нажмите Install (Установить).

     Установка из из VSIX-файла: вариант 2

     • Откройте панель Extensions (Ctrl+Shift+X);
     • Откройте меню More Actions. (. ) (Дополнительные действия (. )) и нажмите Install from VSIX. (Установка из VSIX. );
     • Выберите VSIX-файл и нажмите Install (Установить).

     Интерфейс Visual Studio Code на русском языке

     Если вы хотите использовать интерфейс Visual Studio Code на русском языке, установите языковой пакет для русского языка:

     • Откройте панель Extensions (Ctrl+Shift+X);
     • В строке поиска введите Russian Language Pack for Visual Studio Code ;
     • Нажмите Install ;

     «1С:Исполнитель»

     • Для запуска и отладки скриптов установите «1С:Исполнитель» ;
     • В параметре плагина 1c.executor.path укажите путь к каталогу, в который установлен «1С:Исполнитель» .

     Анатомия пакета VSIX

     Пакет VSIX — это .vsix файл, содержащий одно или несколько расширений Visual Studio, а также метаданные Visual Studio, которые используются для классификации и установки расширений. Эти метаданные содержатся в манифесте VSIX и файле [Content_Types].xml . Пакет VSIX также может содержать один или несколько файлов Extension.vsixlangpack для предоставления локализованного текста установки и может содержать дополнительные пакеты VSIX для установки зависимостей.

     Формат пакета VSIX соответствует стандарту Open Packaging Conventions (OPC). Пакет содержит двоичные файлы и вспомогательные файлы, а также файл [Content_Types].xml и файл манифеста .vsix . Один пакет VSIX может содержать выходные данные нескольких проектов или даже несколько пакетов с собственными манифестами.

     Имена файлов, включенных в пакеты VSIX, не должны содержать пробелы, а также символы, зарезервированные в универсальных идентификаторах ресурсов (URI), как определено в разделе [RFC2396].

     Манифест VSIX

     Манифест VSIX содержит сведения об установленном расширении и следует схеме VSIX. Дополнительные сведения см . в справочнике по схеме расширения VSIX 2.0.

     Манифест VSIX должен быть назван extension.vsixmanifest , если он включен в .vsix файл.

     содержимое.

     Пакет VSIX может содержать шаблоны, элементы панели элементов, VSPackage или любое другое расширение, поддерживаемое Visual Studio.

     Языковые пакеты

     Пакет VSIX может содержать один или несколько файлов Extension.vsixlangpack для предоставления локализованного текста во время установки. Дополнительные сведения см. в разделе «Локализация пакетов VSIX».

     Зависимости и ссылки

     Пакет VSIX может содержать другие пакеты VSIX в виде ссылок. Каждый из этих других пакетов должен содержать собственный манифест VSIX.

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

     Если манифест расширения включает один или несколько элементов зависимостей, расширения и Обновления сравнивает манифест каждой ссылки на расширения, установленные в системе, и устанавливает указанное расширение, если оно еще не установлено. Если установлена более ранняя версия указанного расширения, новая версия заменяет ее.

     Если проект в решении с несколькими проектами содержит ссылку на другой проект в том же решении, пакет VSIX включает зависимости этого проекта. Это поведение можно переопределить, выбрав ссылку для внутреннего проекта, а затем в окне «Свойства » задайте для групп выходных данных, включенных в свойство VSIX значение BuiltProjectOutputGroup .

     Чтобы включить вспомогательные библиотеки DLL из ссылочных сборок в пакет VSIX, добавьте SatelliteDllsProjectOutputGroup в группы вывода, включенные в свойство VSIX .

     Расположение установки

     Во время установки расширения и Обновления ищет содержимое пакета VSIX в папке в папке %LocalAppData%\Microsoft\VisualStudio\\Extensions .

     По умолчанию установка применяется только к текущему пользователю, так как %LocalAppData% — это каталог, зависящий от пользователя. Однако если для элемента манифеста True задано AllUsers значение, расширение будет установлено ..\\Common7\IDE\Extensions и будет доступно всем пользователям компьютера.

     [Content_Types].xml

     Файл [Content_Types].xml определяет типы файлов в развернутом .vsix файле. Visual Studio использует этот файл во время установки пакета, но не устанавливает сам файл. Дополнительные сведения об этом файле см. в разделе Структура файла [Content_types].xml.

     Файл [Content_Types].xml требуется стандартом Open Packaging Conventions (OPC). Дополнительные сведения о OPC см. в статье OPC: новый стандарт упаковки данных.

     Похожие публикации:

     1. Для скольких различных значений маски это возможно
     2. Закрасьте прямоугольники в которых записаны последовательность символов
     3. Зачем нужна асинхронность python
     4. Как скачать программы для создания сайтов