Перейти к основному содержимому
Версия: v2 (текущая)

Установка плагина для Visual Studio

Расширение PanDev Metrics для Microsoft Visual Studio (Windows) отслеживает активность в проектах .NET, C#, C++ и любых других проектах Visual Studio. Публикуется в Visual Studio Marketplace.

Поддерживаемые версии​

  • Visual Studio 2019
  • Visual Studio 2022
  • Visual Studio 2024+ — в теории должен работать, но мы ещё не тестировали эти релизы. Если что-то идёт не так — напишите в поддержку.

Что делает плагин​

  • Отслеживает активность по файлам (открытие, редактирование, закрытие), контекст solution / проекта и время.
  • Фиксирует переключения веток, если проект под Git.
  • Отправляет всё на сервер PanDev Metrics по HTTPS.
  • Не собирает исходный код и не делает скриншоты.

Полный список того, что собирается и не собирается — в обзоре.

Установка​

  1. Откройте Visual Studio.
  2. Перейдите в Extensions → Manage Extensions.
  3. Откройте вкладку Online.
  4. Введите в поиске PanDev Metrics.
  5. Нажмите Download.
  6. Закройте Visual Studio и дождитесь, пока отработает VSIX installer.
  7. Снова откройте Visual Studio.
подсказка

Marketplace обновляет расширение автоматически. Рекомендуем последнюю версию.

Настройка​

После установки откройте Tools → Options → PanDev Metrics.

Все плагины PanDev Metrics авторизуются одним токеном пользователя. Токен выдаётся в веб-приложении — вставьте его в настройки плагина, и на этом всё: адрес сервера и воркспейс уже зашиты в токен, других полей плагин не попросит.

  1. Откройте веб-приложение PanDev Metrics и перейдите в Settings → Plugins.
  2. Нажмите на Visual Studio — откроется инструкция по установке.
  3. Скопируйте значение из шага Введите ваш токен. Токен начинается с pandev_.
  4. Вставьте его в поле токена в плагине и сохраните.
К какому воркспейсу привязан токен?

Токен выдаётся для того воркспейса, под которым вы сейчас авторизованы в веб-приложении. Чтобы метрики шли в другой воркспейс, сначала переключитесь на него в вебе и скопируйте токен заново. On-prem работает так же — возьмите токен на своём инстансе, и плагин пойдёт на этот хост.

Перевыпуск и отзыв

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

Проверка​

  1. Откройте solution и поредактируйте файл.
  2. Подождите пару минут.
  3. Откройте веб-приложение PanDev Metrics → ваш профиль → сегодня.
  4. На таймлайне должна появиться активность.

Troubleshooting​

Нет данных на дашборде. Проверьте, что Server URL без слеша в конце и соответствует вашему деплою. Перезапустите Visual Studio.

Authentication failed. Если вы авторизовались по токену, самая частая причина — токен перевыпустили или отозвали в веб-приложении: скопируйте актуальный в Settings → Plugins и вставьте заново. Заодно проверьте, что токен скопирован целиком, без пробелов в начале и конце.

Self-signed certificate на on-prem. On-prem серверы иногда работают с самоподписанным сертификатом. В расширении есть опция отключить проверку SSL — администратор подскажет, нужно ли её включать.

Visual Studio 2024+ ведёт себя странно. Мы ещё не проверяли 2024+ полностью end-to-end. Плагин должен загружаться и работать; пожалуйста, напишите в поддержку, что именно не так, — это поможет приоритезировать тестирование.

FAQ​

Будет ли отправляться исходный код? Нет. Расширение фиксирует имена файлов, события активности, имена проектов / solution и ветки. Код остаётся на вашей машине.

Работает ли с VS Code или JetBrains Rider? Это расширение — только для Microsoft Visual Studio. Для VS Code см. VS Code plugin, для Rider — JetBrains plugin.

Можно держать несколько редакций Visual Studio на одной машине? Да. Установите расширение в каждую нужную редакцию — конфигурация общая.

Связанные статьи​