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


Пошаговое руководство. Публикация расширения Visual Studio

В этом пошаговом руководстве показано, как опубликовать расширение Visual Studio в Visual Studio Marketplace. При добавлении расширения в Visual Studio Marketplace разработчики могут использовать расширения и обновления для поиска новых и обновленных расширений.

Предпосылки

Чтобы выполнить это пошаговое руководство, необходимо установить пакет SDK Для Visual Studio. Дополнительные сведения см. в статье Установка пакета SDK для Visual Studio.

Создание расширения Visual Studio

В этой статье используется расширение VSPackage по умолчанию, но шаги допустимы для каждого типа расширения.

Упакуйте своё расширение

  1. Обновите расширение .vsixmanifest с правильными сведениями о имени продукта, авторе и версии.

    обновление расширения vsixmanifest

  2. Создайте расширение в режиме релиз. Теперь расширение упаковается в виде VSIX в папке \bin\Release.

  3. Чтобы проверить установку, дважды щелкните VSIX.

Тестирование расширения

Перед распространением расширения выполните сборку и тестирование, чтобы убедиться, что она установлена правильно в экспериментальном экземпляре Visual Studio.

  1. В Visual Studio начните отладку, чтобы открыть экспериментальный экземпляр Visual Studio.

  2. В экспериментальном экземпляре перейдите в меню "Сервис"и щелкните "Расширения" и "Обновления". Расширение TestPublish должно отображаться в центральной области и быть включено.

  3. В меню "Сервис" убедитесь, что отображается тестовая команда.

Публикация расширения в Visual Studio Marketplace

  1. Убедитесь, что вы создали версию выпуска расширения и что она обновлена.

  2. В веб-браузере перейдите в Visual Studio Marketplace.

  3. В правом верхнем углу нажмите кнопку "Войти".

  4. Используйте свою учетную запись Майкрософт для входа. Если у вас нет учетной записи Майкрософт, ее можно создать на этом этапе.

  5. Щелкните "Опубликовать расширения". Этот параметр позволяет перейти на страницу управления для всех расширений. Если у вас нет учетной записи издателя, вам будет предложено создать ее в настоящее время.

    Отправка в Marketplace

  6. Выберите издателя, который вы хотите использовать для отправки расширения. Вы можете изменить издателей, щелкнув имена издателей, перечисленные слева. Нажмите кнопку "Создать расширение" и выберите Visual Studio.

  7. В 1: Загрузка расширения вы можете загрузить VSIX-файл прямо в Visual Studio Marketplace или просто добавить ссылку на свой веб-сайт. В этом примере расширение TestPublish.vsix загружается. Перетащите расширение или щелкните ссылку для поиска файла. Найдите расширение в папке \bin\Release проекта. Нажмите кнопку Продолжить.

  8. В 2. Укажите сведения о расширении, некоторые поля автоматически заполняются из файла source.extension.vsixmanifest вашего расширения. Найдите дополнительную информацию о каждом из ниже перечисленных.

    • Внутреннее имя используется в URL-адресе страницы сведений расширения. Например, публикация расширения под именем издателя "myname" и указание внутреннего имени как "моё расширение" приводит к URL-адресу "marketplace.visualstudio.com/items?itemName=myname.myextension" для страницы подробностей вашего расширения.

    • Отображаемое имя расширения. Это имя заполняется автоматически из файла source.extension.vsixmanifest .

    • Номер версии передаваемого расширения. Эта версия заполняется автоматически из файла source.extension.vsixmanifest .

    • Идентификатор VSIX — это уникальный идентификатор, который Visual Studio использует для расширения. Этот идентификатор необходим, если вы хотите автоматически обновить расширение. Этот идентификатор заполняется автоматически из файла source.extension.vsixmanifest .

    • Логотип , используемый для расширения. Этот логотип заполняется автоматически из файла source.extension.vsixmanifest , если он указан.

    • Краткое описание того, что делает расширение. Это описание заполняется автоматически из файла source.extension.vsixmanifest .

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

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

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

    • Тип. Наиболее распространенным типом расширения является Tools.

    • Категории. Выберите до трех, которые лучше всего подходят для вашего расширения.

    • Теги — это ключевые слова, помогающие пользователям найти расширение. Теги могут помочь повысить релевантность расширений поиска в Visual Studio Marketplace.

    • Категория цен — это стоимость расширения.

    • Репозиторий исходного кода позволяет поделиться ссылкой на исходный код с сообществом.

    • Разрешить Q&A для вашего расширения позволяет пользователям задавать вопросы на странице вашего расширения.

  9. Нажмите кнопку "Сохранить" и "Отправить". Этот параметр возвращает вас на страницу управления издателем. Ваше расширение еще не опубликовано.

  10. Чтобы опубликовать расширение, щелкните правой кнопкой мыши расширение и выберите "Сделать общедоступным". Чтобы узнать, как будет выглядеть расширение в Visual Studio Marketplace, выберите "Просмотреть расширение". Чтобы получить идентификационные номера приобретений, сделайте щелчок на Отчеты. Чтобы внести изменения в расширение, нажмите кнопку "Изменить".

    Меню ввода расширения

  11. Нажмите кнопку "Сделать общедоступным", и расширение теперь является общедоступным. Выполните поиск в Visual Studio Marketplace для расширения.

Обновление опубликованного расширения в Visual Studio Marketplace

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

  1. В веб-браузере перейдите в Visual Studio Marketplace.

  2. В правом верхнем углу нажмите кнопку "Войти", а затем войдите с помощью учетной записи Майкрософт.

    Снимок экрана: выбор отправленного файла расширения в проводнике.

  3. Щелкните "Опубликовать расширения", а затем выберите издателя, который вы хотите использовать для отправки обновленного расширения.

    Снимок экрана: Visual Studio Marketplace с выделенной ссылкой

  4. Рядом с расширением, которое нужно обновить, наведите указатель мыши на три горизонтальные точки и нажмите кнопку "Изменить".

    Снимок экрана: выбор расширения для редактирования.

  5. В 1: Загрузка расширения, после введения имени вашего файла VSIX, щелкните значок карандаша, чтобы изменить опубликованное расширение.

    Снимок экрана, на котором показано нажатие на значок карандаша для редактирования расширения.

  6. Перейдите к файлу вашего обновленного расширения VSIX. Щелкните файл и нажмите кнопку "Открыть".

    Ваши обновленные загрузки расширений.

    Снимок экрана: уведомление о отправке файла после отправки измененного расширения.

  7. На 2: Укажите сведения о расширении некоторые сведения доступны только для чтения при обновлении расширения или они автоматически заполняются из файла source.extension.vsixmanifest вашего расширения. Дополнительные сведения о расширении см. в следующем разделе:

    • Внутреннее имя* используется в URL-адресе страницы сведений о расширении. Например, публикация расширения под именем издателя "myname" и указание внутреннего имени как "мое расширение" приводит к URL-адресу "marketplace.visualstudio.com/items?itemName=myname.myextension" для страницы сведений о расширении.

    • Отображаемое имя* расширения. Это имя заполняется автоматически из файла source.extension.vsixmanifest .

    • Номер версии* передаваемого расширения. Эта версия заполняется автоматически из файла source.extension.vsixmanifest .

    • VSIX ID* — это уникальный идентификатор, который Visual Studio использует для расширения. Этот идентификатор необходим, если вы хотите автоматически обновить расширение. Этот идентификатор заполняется автоматически из файла source.extension.vsixmanifest .

    • Логотип* , используемый для расширения. Этот логотип заполняется автоматически из файла source.extension.vsixmanifest , если он указан.

    • Краткое описание того, что делает расширение. Это описание заполняется автоматически из файла source.extension.vsixmanifest .

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

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

    • Поддерживаемый выпуск Visual Studio* позволяет выбрать выпуски Visual Studio, над которыми будет работать расширение. Расширение устанавливается только в этих редакциях.

    • Тип. Наиболее распространенным типом расширения является Tools.

    • Категории. Выберите до трех, которые лучше всего подходят для вашего расширения.

    • Теги — это ключевые слова, помогающие пользователям найти расширение. Теги могут помочь повысить релевантность расширений поиска в Visual Studio Marketplace.

    • Категория цен — это стоимость расширения.

    • Репозиторий исходного кода позволяет поделиться ссылкой на исходный код с сообществом.

    • Разрешить Q&A для вашего расширения позволяет пользователям задавать вопросы на странице вашего расширения.

      * Эти сведения не могут быть изменены для обновления расширения.

  8. Нажмите кнопку "Сохранить" и "Отправить". Этот параметр возвращает вас на страницу управления издателем. Ваше расширение еще не опубликовано.

  9. Чтобы опубликовать расширение, щелкните правой кнопкой мыши расширение и выберите "Сделать общедоступным". Чтобы узнать, как будет выглядеть расширение в Visual Studio Marketplace, выберите "Просмотреть расширение". Для получения номеров приобретений нажмите «Отчеты». Чтобы внести изменения в расширение, нажмите кнопку "Изменить".

Добавление дополнительных пользователей для управления учетной записью издателя

Visual Studio Marketplace поддерживает предоставление дополнительных пользователей разрешений для доступа к учетной записи издателя и управления ими.

  1. Попросите участника, который вы хотите добавить, чтобы войти в свою учетную запись в Marketplace и получить идентификатор пользователя. Идентификатор пользователя будет виден, если навести указатель мыши на электронную почту, как показано на следующем рисунке.

    Снимок экрана: идентификатор пользователя рядом с именем пользователя и адресом электронной почты в Marketplace.

  2. Участник может скопировать идентификатор пользователя, нажав кнопку копирования в буфер обмена, а затем предоставить к нему общий доступ.

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

  4. Выберите "Участники" и нажмите кнопку "Добавить".

    Добавление дополнительного пользователя

  5. Затем можно указать идентификатор пользователя, который вы хотите добавить, и предоставить нужный уровень доступа в разделе "Выбор роли". Вы можете выбрать один из следующих вариантов:

    • Создатель: пользователь может публиковать расширения, но не может просматривать или управлять расширениями, опубликованными другими пользователями.

    • Читатель: пользователь может просматривать расширения, но не может публиковать или управлять расширениями.

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

    • Владелец: пользователь может публиковать расширения и управлять ими, изменять параметры издателя и управлять доступом.

Устранение неполадок при добавлении пользователя в учетную запись издателя

При добавлении пользователя в профиль издателя с помощью адреса электронной почты может появиться ошибка TF14045: The identity could not be found.

Чтобы избежать этой ошибки, используйте идентификатор пользователя вместо адреса электронной почты, чтобы добавить пользователя в учетную запись издателя. Чтобы найти идентификатор пользователя в Visual Studio Marketplace, наведите указатель мыши на имя пользователя в верхней части панели. Щелкните значок копирования, чтобы скопировать идентификатор пользователя.

Снимок экрана: идентификатор пользователя рядом с именем пользователя и адресом электронной почты в Marketplace.

Затем можно добавить нового пользователя с помощью идентификатора пользователя.

Установка расширения из Visual Studio Marketplace

Теперь, когда расширение опубликовано, установите его в Visual Studio и проверьте его там.

  1. В Visual Studio в меню "Сервис" щелкните "Расширения" и "Обновления".

  2. Щелкните "Онлайн" и найдите TestPublish.

  3. Щелкните элемент Загрузить. Затем расширение поставлено в очередь на установку.

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

Удаление расширения

Расширение можно удалить из Visual Studio Marketplace и с компьютера.

Удаление или отмена публикации расширения из Visual Studio Marketplace

  1. Перейдите в Visual Studio Marketplace.

  2. В правом верхнем углу щелкните Опубликовать расширения. Выберите издателя, который использовался для публикации (например, TestPublish). Появится список расширений.

  3. Нажмите кнопку меню расширения → нажмите кнопку "Удалить". Вам будет предложено подтвердить, хотите ли вы удалить расширение.

Снимок экрана: пункт меню

Чтобы предотвратить случайную отмену публикации, необходимо подтвердить операцию удаления, заполнив имя расширения в диалоговом окне предупреждения. Обратите внимание, что действие remove/unpublish не является обратимым

Снимок экрана: предупреждение.

Удаление расширения с компьютера

  1. В Visual Studio в меню "Сервис" щелкните "Расширения" и "Обновления".

  2. Выберите TestPublish и нажмите кнопку "Удалить". Затем расширение запланировано для удаления.

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