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

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

Плагин PanDev Metrics для Xcode — это лёгкое приложение для macOS, которое отслеживает вашу активность в Xcode и отправляет её на сервер PanDev Metrics. В отличие от плагинов из маркетплейсов, оно распространяется напрямую с платформы PanDev в виде нотаризованного .dmg, поэтому скачивается и устанавливается вручную.

Требования​

  • macOS 12 (Monterey) или новее
  • Установленный Xcode
  • Возможность выдать приложению доступ к Accessibility (см. Настройка)

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

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

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

Установка​

  1. Скачайте установщик с платформы PanDev:

    https://cdn.pandev.io/xcode/plugin.dmg

  2. Откройте скачанный plugin.dmg. Откроется окно с приложением PanDev Metrics и ярлыком Applications.

  3. Перетащите PanDev Metrics на папку Applications.

  4. Извлеките образ и запустите PanDev Metrics из Applications (или Launchpad).

Первый запуск

Приложение подписано Apple Developer ID и нотаризовано Apple, поэтому открывается обычным образом. Если macOS всё же покажет предупреждение Gatekeeper — кликните правой кнопкой по приложению → Open → Open, один раз.

Настройка​

Выдайте доступ к Accessibility​

Чтобы считывать активность из Xcode, приложению нужен доступ к Accessibility. При первом запуске оно покажет диалог Accessibility Access Needed — нажмите Open System Settings.

Затем:

  1. В System Settings → Privacy & Security → Accessibility включите PanDev Metrics в списке.
  2. Если приложение уже было запущено — закройте и откройте его заново.
примечание

Без доступа к Accessibility приложение работает, но не фиксирует активность. Это разрешение нужно только для отслеживания — исходный код, скриншоты и нажатия клавиш не собираются.

Вход​

При запуске PanDev Metrics открывается окно Login. Вход — по единому токену пользователя: вставляете токен, отмечаете согласие с License agreement и Privacy policy — и всё. Воркспейс и сервер уже внутри токена, больше настраивать нечего.

  1. Вставьте токен в поле токена.
  2. Отметьте I agree with License agreement and Privacy policy.
  3. Нажмите Submit.
Где взять токен?

Откройте веб-приложение PanDev Metrics, перейдите в Settings → Plugins и нажмите Xcode — откроется инструкция по установке. Скопируйте значение из шага Введите ваш токен; токен начинается с pandev_.

В том же шаге есть Перевыпустить токен и Отозвать токен. Токен выдаётся для того воркспейса, под которым вы сейчас авторизованы в вебе, и активен он один на воркспейс — этот же токен подходит для IDE-плагинов, браузерных расширений и CLI. С on-prem так же: берите токен на своём инстансе.

Вместо диалога можно авторизоваться и через терминал:

pandev login -t <YOUR_TOKEN>

Проверка​

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

Если за пять минут ничего не появилось — см. Troubleshooting ниже.

Обновление​

Приложение для Xcode обновляется вручную. Когда выходит новая версия — скачайте свежий plugin.dmg с https://cdn.pandev.io/xcode/plugin.dmg и повторите установку: перетащите новое приложение поверх старого в Applications и выберите Replace.

Troubleshooting​

Нет данных на дашборде. Сначала проверьте, что выдан доступ к Accessibility (System Settings → Privacy & Security → Accessibility). Затем убедитесь, что Server URL без слеша в конце и соответствует вашему деплою (cloud или on-prem). Закройте и откройте приложение заново.

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

«PanDev Metrics can't be opened». Приложение нотаризовано, поэтому такое бывает редко. Если появилось — кликните правой кнопкой по приложению в Applications → Open → Open. Это нужно сделать один раз.

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

Часто работаю офлайн. Ничего дополнительно настраивать не нужно. Приложение складывает события в локальную очередь и сливает её при восстановлении связи.

FAQ​

Почему плагина для Xcode нет в App Store? Отслеживание активности опирается на macOS-API (глобальный мониторинг активности и интеграция с Git), недоступные приложениям из Mac App Store с включённой песочницей. Поэтому PanDev Metrics распространяет его напрямую как нотаризованную загрузку — тем же способом, что и другие трекеры активности разработчика. Приложение при этом подписано Apple и нотаризовано.

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

Оно работает постоянно? Приложение тихо работает в фоне, пока вы пишете код. Использует минимум CPU и памяти.

Можно использовать вместе с другими плагинами PanDev Metrics? Да. PanDev Metrics агрегирует данные со всех установленных плагинов — JetBrains, VS Code, Visual Studio, Xcode — в один таймлайн на разработчика.

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