Overview
Когда это нужно
Если Primuse вылетает, перестаёт отвечать, пропускает треки при сканировании, не может подключиться к источнику музыки или прерывает воспроизведение, разработчику обычно нужна запись именно того момента, когда всё пошло не так. Диагностика хранится на вашем устройстве и никогда не отправляется автоматически — она покидает устройство, только когда вы отправляете её сами.
Прежде чем начать
- Проверьте версию приложения: в разделе Настройки → О нас указаны Версия и Сборка. Укажите их в обращении.
- Для загрузки нужен интернет. С одного устройства можно загружать до 5 раз в день, каждый пакет — не больше 8 МБ.
Шаг 1. Включите режим диагностики (рекомендуется)
- Откройте Настройки → О нас → «Диагностические отчеты».
- Mac: Настройки → О нас → «Журналы диагностики…», затем в открывшемся окне нажмите «Диагностические отчеты».
- Apple TV: откройте «Диагностические отчеты» в разделе Настройки.
- Включите «Записывать подробный журнал». Следующие 24 часа приложение записывает дополнительные подробности для поиска неполадок, затем выключает режим само.
- Повторите проблему (например, запустите сканирование заново, снова включите трек или переподключите источник) и запомните примерное время.
То, что произошло до включения режима, есть только в обычном журнале, и подробностей там может не хватить. Лучше один раз повторить проблему с включённым режимом.
Шаг 2. Загрузите разработчику
- На экране «Диагностические отчеты» нажмите «Отправить автору» на панели инструментов.
- В разделе «Вложения (необязательно)» выберите, что приложить: «Диагностические отчеты» (отчёты о сбоях и зависаниях, метрики работы) и «Журналы».
- При желании добавьте снимки экрана в «Изображения (необязательно)» (до 6, уменьшаются автоматически) и опишите в поле «Пожелания или предложения», что вы делали, чего ожидали, что произошло на самом деле и примерно когда.
- Нажмите «Загрузить автору» внизу. По очереди появятся «Упаковка…», «Загрузка: …%» и «Подтверждение…».
- Когда появится «Отправлено автору», нажмите «Скопировать код» и укажите код в обращении на GitHub или в письме.
Ожидаемый результат: на экране показан код отчёта. После успешной загрузки загруженные отчёты и журналы удаляются с устройства.
На Apple TV нет системных отчётов о сбоях, поэтому загружаются только журнал и ваше сообщение; после появления кода можно нажать «Отправить ещё», чтобы отправить ещё раз.
Если загрузить не получается: почта или «Поделиться»
- Под кнопкой загрузки есть «Отправить по почте» или «Поделиться другим способом». К письму прикладываются выбранные отчёты или журналы, и вы просматриваете его перед отправкой.
- Если служба загрузки недоступна, кнопки загрузки нет; на панели инструментов появляется «Открыть почту» или «Поделиться», а также адрес почты разработчика.
- В версиях до 1.12.2 загрузки нет — используйте «Отправить автору» для отправки по почте или через «Поделиться».
Поделиться одним отчётом
Нажмите на отчёт на экране «Диагностические отчеты», чтобы поделиться только им. На Mac кнопка «Экспорт журналов» показывает файл журнала в Finder.
Что означают параметры
| Параметр | Значение |
|---|---|
| Отчёты о сбоях и зависаниях | Отчёты, которые система оставляет после сбоя или долгого зависания; обычно появляются после следующего запуска приложения |
| Показатели работы | Периодические данные системы о работе приложения, например пиковая память и причины завершения |
| Журналы | Собственная запись приложения о недавнем воспроизведении, сканировании и синхронизации; при загрузке и отправке берётся только последняя часть |
| Записывать подробный журнал | 24 часа записывает больше подробностей, затем выключается |
| Очистить журналы | Удаляет журналы на этом устройстве; отменить нельзя |
Конфиденциальность
В журналах есть названия треков и пути к файлам; адреса и учётные записи источников музыки заменяются короткими метками. Пароли, токены и другие учётные данные удаляются до записи. Загруженное используется только для поиска неполадок и удаляется с сервера разработчика через 30 дней (раньше, если не хватает места). Перед отправкой можно снять отметку «Журналы» или не прикладывать снимки экрана.
Ограничения
- Одна загрузка — не больше 8 МБ после упаковки; 5 загрузок в день на устройство, незавершённые попытки тоже считаются.
- Отчёты и журналы хранятся на устройстве около 7 дней.
- На Apple TV нет отчётов о сбоях и зависаниях; на Apple Watch нет экрана диагностики — отправляйте с сопряжённого iPhone.