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

import IdealImage from "@theme/IdealImage";

Установка плагина для 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).

:::tip Первый запуск Приложение подписано 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 с двумя способами входа — Token и Login & Password. Используйте тот, что принят у вас в команде, отметьте согласие с License agreement и Privacy policy и нажмите Submit.

Вариант A — Token (рекомендуется)​

Самый быстрый способ: вставляете API-токен — и готово. Токен уже несёт в себе ваш воркспейс, больше ничего настраивать не нужно.

  1. На вкладке Token вставьте API-токен в поле.
  2. Отметьте I agree with License agreement and Privacy policy.
  3. Нажмите Submit.

:::tip Где взять токен? Откройте веб-приложение PanDev Metrics, перейдите в свой профиль / настройки API и скопируйте API-токен. :::

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

pandev login -t <YOUR_TOKEN>

Вариант B — Login & Password​

Используйте свои учётные данные PanDev Metrics и укажите адрес вашего деплоя.

  1. Переключитесь на вкладку Login & Password.
  2. Заполните поля:
ПолеЗначение
Server URLhttps://metrics-cloud.pandev.io для cloud, либо URL вашего сервера для on-prem (например, https://pandev.company.local)
LoginВаш email или логин PanDev Metrics
PasswordВаш пароль PanDev Metrics
  1. Отметьте I agree with License agreement and Privacy policy.
  2. Нажмите Submit.

:::note On-prem URL сервера и учётные данные предоставляет администратор. Убедитесь, что Server URL без слеша в конце. :::

Проверка​

  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. Проверьте Login и Password, войдя в веб-приложение PanDev Metrics. Если используете SSO через LDAP — вводите те же учётные данные.

«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 — в один таймлайн на разработчика.

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