Захват системной трассировки на устройстве

Устройства под управлением Android 9 (уровень API 28) или выше включают приложение системного уровня под названием System Tracing. Это приложение похоже на утилиту командной строки systrace , но приложение позволяет вам записывать трассировки непосредственно с самого тестового устройства, без необходимости подключать устройство и подключаться к нему через adb . Затем вы можете использовать приложение для обмена результатами этих трассировок с вашей командой разработчиков.

Устройства под управлением Android 10 и выше записывают трассировки в формате Perfetto, тогда как более ранние устройства записывают их в формате Systrace. Мы рекомендуем использовать просмотрщик трассировок Perfetto, чтобы открыть оба формата и затем проанализировать трассировки.

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

Запись трассировки системы

Приложение System Tracing позволяет вам записывать системную трассировку с помощью плитки быстрых настроек или меню в самом приложении. В следующих разделах описывается, как завершить процесс записи с помощью этих интерфейсов.

Запись с использованием плитки быстрых настроек

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

Установить плитку

Если вы впервые используете трассировку системы на тестовом устройстве или если вы не видите плитку «Трассировка системы» на панели быстрых настроек вашего устройства, как показано на рисунке 2, выполните следующие шаги по настройке:

  1. Включить параметры разработчика .
  2. Откройте экран настроек параметров разработчика .
  3. В разделе Отладка выберите Трассировка системы . Откроется приложение Трассировка системы, отображающее меню приложения.
  4. В меню приложения включите функцию «Показать плитку быстрых настроек» , как показано на рисунке 1. Система добавит плитку «Трассировка системы» на панель быстрых настроек , как показано на рисунке 2:

    Рисунок 1. Переключатель плитки «Показать быстрые настройки» в приложении «Трассировка системы».
    Рисунок 2. Плитка «Трассировка системы» на панели быстрых настроек .

    Примечание: По умолчанию система добавляет плитку System Tracing в качестве первой плитки на панели быстрых настроек . Если вы хотите, чтобы плитка отображалась в другом месте, используйте режим редактирования панели, чтобы переместить плитку.

Завершите запись трассировки системы

Чтобы записать трассировку системы с помощью панели быстрых настроек , выполните следующие действия:

  1. Нажмите на плитку System Tracing , которая имеет метку Record trace . Плитка становится активной, и появляется постоянное уведомление, уведомляющее вас о том, что система записывает трассировку, как показано на рисунке 3:

    Уведомление с сообщением «Трассировка записывается. Нажмите, чтобы остановить трассировку».
    Рисунок 3. Постоянное уведомление, появляющееся после запуска трассировки системы на устройстве.
  2. Выполните действия в вашем приложении, которые должна проверить система.

  3. Остановите отслеживание, нажав либо на плитку «Отслеживание системы» на панели быстрых настроек , либо на уведомление «Отслеживание системы».

    Система отображает новое уведомление, содержащее сообщение «Сохранение трассировки». После завершения сохранения система отклоняет уведомление и отображает третье уведомление, подтверждающее, что ваша трассировка сохранена и что вы готовы поделиться системной трассировкой , как показано на рисунке 4:

    Уведомление с сообщением «Трассировка сохранена. Нажмите, чтобы поделиться своей трассировкой».
    Рисунок 4. Постоянное уведомление, которое появляется после того, как система завершает сохранение записанного следа.

Запись с помощью меню приложения

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

Чтобы записать трассировку системы с помощью меню приложения «Трассировка системы», выполните следующие действия:

  1. Включить параметры разработчика .
  2. Откройте экран настроек Developer Options . В разделе Debugging выберите System Tracing . Откроется приложение System Tracing.

    Кроме того, если вы настроили плитку «Трассировка системы» , вы можете нажать и удерживать плитку, чтобы войти в приложение «Трассировка системы».

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

  4. При желании выберите Категории системных и сенсорных вызовов для трассировки и выберите Размер буфера на ЦП в КБ. Выберите категории, соответствующие варианту использования, который вы тестируете, например категорию Аудио для тестирования операций Bluetooth или категорию Память для распределения кучи.

  5. При желании выберите Длинные трассы , чтобы включить трассы, которые непрерывно сохраняются в хранилище устройства. Для этой опции установите ограничения для Максимального размера длинной трассы и Максимальной длительности длинной трассы .

  6. Включите переключатель «Запись трассировки» , выделенный на рисунке 5. Плитка станет активной, и появится постоянное уведомление о том, что система записывает трассировку, как показано на рисунке 3 .

    Рисунок 5. Переключатель записи трассировки в настройках системной трассировки.
  7. Выполните действия в вашем приложении, которые должна проверить система.

  8. Остановите трассировку, отключив переключатель «Запись трассировки» .

    Система отображает новое уведомление, содержащее сообщение «Сохранение трассировки». После завершения сохранения система закрывает уведомление и отображает третье уведомление, подтверждающее, что ваша трассировка сохранена и что вы готовы поделиться системной трассировкой , как показано на рисунке 4 .

Поделитесь системным следом

Приложение System Tracing помогает вам делиться результатами трассировки системы в рамках нескольких различных рабочих процессов. На устройстве под управлением Android 10 (уровень API 29) или выше файлы трассировки сохраняются с расширением имени файла .perfetto-trace и могут быть открыты в пользовательском интерфейсе Perfetto . На устройстве под управлением более ранней версии Android файлы трассировки сохраняются с расширением имени файла .ctrace , что обозначает формат Systrace.

Поделиться как сообщение

System Tracing позволяет вам делиться собранной трассировкой с другими приложениями на вашем устройстве. Вы можете отправить трассировку своей команде разработчиков по электронной почте или через приложение для отслеживания ошибок без необходимости подключения устройства к вашей машине разработки.

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

Поделиться из приложения «Файлы»

На устройствах под управлением Android 10 (уровень API 29) или выше трассировки отображаются в приложении «Файлы». Вы можете поделиться трассировкой из этого приложения.

Загрузить отчет с помощью ADB

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

cd /path-to-traces-on-my-dev-machine && \
  adb pull /data/local/traces/ .

Конвертация между форматами трассировки

Вы можете преобразовать файлы трассировки Perfetto в формат Systrace. Для получения дополнительной информации см. Преобразование между форматами трассировки .

Создать HTML-отчет

При предоставлении доступа к трассировке сам отчет сохраняется в файле .perfetto-trace на устройствах под управлением Android 10 и выше или в файле .ctrace для всех остальных версий.

Создайте HTML-отчет из файла трассировки с помощью веб-интерфейса или из командной строки .

Веб-интерфейс пользователя

Используйте пользовательский интерфейс Perfetto , чтобы открыть файл трассировки и создать отчет.

Для файла Perfetto нажмите Открыть файл трассировки . Для файла Systrace нажмите Открыть с устаревшим пользовательским интерфейсом . Устаревший пользовательский интерфейс имеет тот же вид и функции, что и отчет Systrace .

Командная строка

Выполните следующие команды в окне терминала, чтобы создать HTML-отчет из файла трассировки:

cd /path-to-traces-on-my-dev-machine && \
  systrace --from-file trace-file-name{.ctrace | .perfetto-trace}

Если у вас еще нет программы командной строки systrace , вы можете загрузить ее из проекта Catapult на GitHub или непосредственно из Android Open Source Project .

{% дословно %} {% endverbatim %} {% дословно %} {% endverbatim %} ,

Устройства под управлением Android 9 (уровень API 28) или выше включают приложение системного уровня под названием System Tracing. Это приложение похоже на утилиту командной строки systrace , но приложение позволяет вам записывать трассировки непосредственно с самого тестового устройства, без необходимости подключать устройство и подключаться к нему через adb . Затем вы можете использовать приложение для обмена результатами этих трассировок с вашей командой разработчиков.

Устройства под управлением Android 10 и выше записывают трассировки в формате Perfetto, тогда как более ранние устройства записывают их в формате Systrace. Мы рекомендуем использовать просмотрщик трассировок Perfetto, чтобы открыть оба формата и затем проанализировать трассировки.

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

Запись трассировки системы

Приложение System Tracing позволяет вам записывать системную трассировку с помощью плитки быстрых настроек или меню в самом приложении. В следующих разделах описывается, как завершить процесс записи с помощью этих интерфейсов.

Запись с использованием плитки быстрых настроек

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

Установить плитку

Если вы впервые используете трассировку системы на тестовом устройстве или если вы не видите плитку «Трассировка системы» на панели быстрых настроек вашего устройства, как показано на рисунке 2, выполните следующие шаги по настройке:

  1. Включить параметры разработчика .
  2. Откройте экран настроек параметров разработчика .
  3. В разделе Отладка выберите Трассировка системы . Откроется приложение Трассировка системы, отображающее меню приложения.
  4. В меню приложения включите функцию «Показать плитку быстрых настроек» , как показано на рисунке 1. Система добавит плитку «Трассировка системы» на панель быстрых настроек , как показано на рисунке 2:

    Рисунок 1. Переключатель плитки «Показать быстрые настройки» в приложении «Трассировка системы».
    Рисунок 2. Плитка «Трассировка системы» на панели быстрых настроек .

    Примечание: По умолчанию система добавляет плитку System Tracing в качестве первой плитки на панели быстрых настроек . Если вы хотите, чтобы плитка отображалась в другом месте, используйте режим редактирования панели, чтобы переместить плитку.

Завершите запись трассировки системы

Чтобы записать трассировку системы с помощью панели быстрых настроек , выполните следующие действия:

  1. Нажмите на плитку System Tracing , которая имеет метку Record trace . Плитка становится активной, и появляется постоянное уведомление, уведомляющее вас о том, что система записывает трассировку, как показано на рисунке 3:

    Уведомление с сообщением «Трассировка записывается. Нажмите, чтобы остановить трассировку».
    Рисунок 3. Постоянное уведомление, появляющееся после запуска трассировки системы на устройстве.
  2. Выполните действия в вашем приложении, которые должна проверить система.

  3. Остановите отслеживание, нажав либо на плитку «Отслеживание системы» на панели быстрых настроек , либо на уведомление «Отслеживание системы».

    Система отображает новое уведомление, содержащее сообщение «Сохранение трассировки». После завершения сохранения система отклоняет уведомление и отображает третье уведомление, подтверждающее, что ваша трассировка сохранена и что вы готовы поделиться системной трассировкой , как показано на рисунке 4:

    Уведомление с сообщением «Трассировка сохранена. Нажмите, чтобы поделиться своей трассировкой».
    Рисунок 4. Постоянное уведомление, которое появляется после того, как система завершает сохранение записанного следа.

Запись с помощью меню приложения

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

Чтобы записать трассировку системы с помощью меню приложения «Трассировка системы», выполните следующие действия:

  1. Включить параметры разработчика .
  2. Откройте экран настроек Developer Options . В разделе Debugging выберите System Tracing . Откроется приложение System Tracing.

    Кроме того, если вы настроили плитку «Трассировка системы» , вы можете нажать и удерживать плитку, чтобы войти в приложение «Трассировка системы».

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

  4. При желании выберите Категории системных и сенсорных вызовов для трассировки и выберите Размер буфера на ЦП в КБ. Выберите категории, соответствующие варианту использования, который вы тестируете, например категорию Аудио для тестирования операций Bluetooth или категорию Память для распределения кучи.

  5. При желании выберите Длинные трассы , чтобы включить трассы, которые непрерывно сохраняются в хранилище устройства. Для этой опции установите ограничения для Максимального размера длинной трассы и Максимальной длительности длинной трассы .

  6. Включите переключатель «Запись трассировки» , выделенный на рисунке 5. Плитка станет активной, и появится постоянное уведомление о том, что система записывает трассировку, как показано на рисунке 3 .

    Рисунок 5. Переключатель записи трассировки в настройках системной трассировки.
  7. Выполните действия в вашем приложении, которые должна проверить система.

  8. Остановите трассировку, отключив переключатель «Запись трассировки» .

    Система отображает новое уведомление, содержащее сообщение «Сохранение трассировки». После завершения сохранения система закрывает уведомление и отображает третье уведомление, подтверждающее, что ваша трассировка сохранена и что вы готовы поделиться системной трассировкой , как показано на рисунке 4 .

Поделитесь системным следом

Приложение System Tracing помогает вам делиться результатами трассировки системы в рамках нескольких различных рабочих процессов. На устройстве под управлением Android 10 (уровень API 29) или выше файлы трассировки сохраняются с расширением имени файла .perfetto-trace и могут быть открыты в пользовательском интерфейсе Perfetto . На устройстве под управлением более ранней версии Android файлы трассировки сохраняются с расширением имени файла .ctrace , что обозначает формат Systrace.

Поделиться как сообщение

System Tracing позволяет вам делиться собранной трассировкой с другими приложениями на вашем устройстве. Вы можете отправить трассировку своей команде разработчиков по электронной почте или через приложение для отслеживания ошибок без необходимости подключения устройства к вашей машине разработки.

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

Поделиться из приложения «Файлы»

На устройствах под управлением Android 10 (уровень API 29) или выше трассировки отображаются в приложении «Файлы». Вы можете поделиться трассировкой из этого приложения.

Загрузить отчет с помощью ADB

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

cd /path-to-traces-on-my-dev-machine && \
  adb pull /data/local/traces/ .

Конвертация между форматами трассировки

Вы можете преобразовать файлы трассировки Perfetto в формат Systrace. Для получения дополнительной информации см. Преобразование между форматами трассировки .

Создать HTML-отчет

При предоставлении доступа к трассировке сам отчет сохраняется в файле .perfetto-trace на устройствах под управлением Android 10 и выше или в файле .ctrace для всех остальных версий.

Создайте HTML-отчет из файла трассировки с помощью веб-интерфейса или из командной строки .

Веб-интерфейс пользователя

Используйте пользовательский интерфейс Perfetto , чтобы открыть файл трассировки и создать отчет.

Для файла Perfetto нажмите Открыть файл трассировки . Для файла Systrace нажмите Открыть с устаревшим пользовательским интерфейсом . Устаревший пользовательский интерфейс имеет тот же вид и функции, что и отчет Systrace .

Командная строка

Выполните следующие команды в окне терминала, чтобы создать HTML-отчет из файла трассировки:

cd /path-to-traces-on-my-dev-machine && \
  systrace --from-file trace-file-name{.ctrace | .perfetto-trace}

Если у вас еще нет программы командной строки systrace , вы можете загрузить ее из проекта Catapult на GitHub или непосредственно из Android Open Source Project .

{% дословно %} {% endverbatim %} {% дословно %} {% endverbatim %} ,

Устройства под управлением Android 9 (уровень API 28) или выше включают приложение системного уровня под названием System Tracing. Это приложение похоже на утилиту командной строки systrace , но приложение позволяет вам записывать трассировки непосредственно с самого тестового устройства, без необходимости подключать устройство и подключаться к нему через adb . Затем вы можете использовать приложение для обмена результатами этих трассировок с вашей командой разработчиков.

Устройства под управлением Android 10 и выше записывают трассировки в формате Perfetto, тогда как более ранние устройства записывают их в формате Systrace. Мы рекомендуем использовать просмотрщик трассировок Perfetto, чтобы открыть оба формата и затем проанализировать трассировки.

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

Запись трассировки системы

Приложение System Tracing позволяет вам записывать системную трассировку с помощью плитки быстрых настроек или меню в самом приложении. В следующих разделах описывается, как завершить процесс записи с помощью этих интерфейсов.

Запись с использованием плитки быстрых настроек

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

Установить плитку

Если вы впервые используете трассировку системы на тестовом устройстве или если вы не видите плитку «Трассировка системы» на панели быстрых настроек вашего устройства, как показано на рисунке 2, выполните следующие шаги по настройке:

  1. Включить параметры разработчика .
  2. Откройте экран настроек параметров разработчика .
  3. В разделе Отладка выберите Трассировка системы . Откроется приложение Трассировка системы, отображающее меню приложения.
  4. В меню приложения включите функцию «Показать плитку быстрых настроек» , как показано на рисунке 1. Система добавит плитку «Трассировка системы» на панель быстрых настроек , как показано на рисунке 2:

    Рисунок 1. Переключатель плитки «Показать быстрые настройки» в приложении «Трассировка системы».
    Рисунок 2. Плитка «Трассировка системы» на панели быстрых настроек .

    Примечание: По умолчанию система добавляет плитку System Tracing в качестве первой плитки на панели быстрых настроек . Если вы хотите, чтобы плитка отображалась в другом месте, используйте режим редактирования панели, чтобы переместить плитку.

Завершите запись трассировки системы

Чтобы записать трассировку системы с помощью панели быстрых настроек , выполните следующие действия:

  1. Нажмите на плитку System Tracing , которая имеет метку Record trace . Плитка становится активной, и появляется постоянное уведомление, уведомляющее вас о том, что система записывает трассировку, как показано на рисунке 3:

    Уведомление с сообщением «Трассировка записывается. Нажмите, чтобы остановить трассировку».
    Рисунок 3. Постоянное уведомление, появляющееся после запуска трассировки системы на устройстве.
  2. Выполните действия в вашем приложении, которые должна проверить система.

  3. Остановите отслеживание, нажав либо на плитку «Отслеживание системы» на панели быстрых настроек , либо на уведомление «Отслеживание системы».

    Система отображает новое уведомление, содержащее сообщение «Сохранение трассировки». После завершения сохранения система отклоняет уведомление и отображает третье уведомление, подтверждающее, что ваша трассировка сохранена и что вы готовы поделиться системной трассировкой , как показано на рисунке 4:

    Уведомление с сообщением «Трассировка сохранена. Нажмите, чтобы поделиться своей трассировкой».
    Рисунок 4. Постоянное уведомление, которое появляется после того, как система завершает сохранение записанного следа.

Запись с помощью меню приложения

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

Чтобы записать трассировку системы с помощью меню приложения «Трассировка системы», выполните следующие действия:

  1. Включить параметры разработчика .
  2. Откройте экран настроек Developer Options . В разделе Debugging выберите System Tracing . Откроется приложение System Tracing.

    Кроме того, если вы настроили плитку «Трассировка системы» , вы можете нажать и удерживать плитку, чтобы войти в приложение «Трассировка системы».

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

  4. При желании выберите Категории системных и сенсорных вызовов для трассировки и выберите Размер буфера на ЦП в КБ. Выберите категории, соответствующие варианту использования, который вы тестируете, например категорию Аудио для тестирования операций Bluetooth или категорию Память для распределения кучи.

  5. При желании выберите Длинные трассы , чтобы включить трассы, которые непрерывно сохраняются в хранилище устройства. Для этой опции установите ограничения для Максимального размера длинной трассы и Максимальной длительности длинной трассы .

  6. Включите переключатель «Запись трассировки» , выделенный на рисунке 5. Плитка станет активной, и появится постоянное уведомление о том, что система записывает трассировку, как показано на рисунке 3 .

    Рисунок 5. Переключатель записи трассировки в настройках системной трассировки.
  7. Выполните действия в вашем приложении, которые должна проверить система.

  8. Остановите трассировку, отключив переключатель «Запись трассировки» .

    Система отображает новое уведомление, содержащее сообщение «Сохранение трассировки». После завершения сохранения система закрывает уведомление и отображает третье уведомление, подтверждающее, что ваша трассировка сохранена и что вы готовы поделиться системной трассировкой , как показано на рисунке 4 .

Поделитесь системным следом

Приложение System Tracing помогает вам делиться результатами трассировки системы в рамках нескольких различных рабочих процессов. На устройстве под управлением Android 10 (уровень API 29) или выше файлы трассировки сохраняются с расширением имени файла .perfetto-trace и могут быть открыты в пользовательском интерфейсе Perfetto . На устройстве под управлением более ранней версии Android файлы трассировки сохраняются с расширением имени файла .ctrace , что обозначает формат Systrace.

Поделиться как сообщение

System Tracing позволяет вам делиться собранной трассировкой с другими приложениями на вашем устройстве. Вы можете отправить трассировку своей команде разработчиков по электронной почте или через приложение для отслеживания ошибок без необходимости подключения устройства к вашей машине разработки.

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

Поделиться из приложения «Файлы»

На устройствах под управлением Android 10 (уровень API 29) или выше трассировки отображаются в приложении «Файлы». Вы можете поделиться трассировкой из этого приложения.

Загрузить отчет с помощью ADB

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

cd /path-to-traces-on-my-dev-machine && \
  adb pull /data/local/traces/ .

Конвертация между форматами трассировки

Вы можете преобразовать файлы трассировки Perfetto в формат Systrace. Для получения дополнительной информации см. Преобразование между форматами трассировки .

Создать HTML-отчет

При предоставлении доступа к трассировке сам отчет сохраняется в файле .perfetto-trace на устройствах под управлением Android 10 и выше или в файле .ctrace для всех остальных версий.

Создайте HTML-отчет из файла трассировки с помощью веб-интерфейса или из командной строки .

Веб-интерфейс пользователя

Используйте пользовательский интерфейс Perfetto , чтобы открыть файл трассировки и создать отчет.

Для файла Perfetto нажмите Открыть файл трассировки . Для файла Systrace нажмите Открыть с устаревшим пользовательским интерфейсом . Устаревший пользовательский интерфейс имеет тот же вид и функции, что и отчет Systrace .

Командная строка

Выполните следующие команды в окне терминала, чтобы создать HTML-отчет из файла трассировки:

cd /path-to-traces-on-my-dev-machine && \
  systrace --from-file trace-file-name{.ctrace | .perfetto-trace}

Если у вас еще нет программы командной строки systrace , вы можете загрузить ее из проекта Catapult на GitHub или непосредственно из Android Open Source Project .

{% дословно %} {% endverbatim %} {% дословно %} {% endverbatim %} ,

Устройства под управлением Android 9 (уровень API 28) или выше включают приложение системного уровня под названием System Tracing. Это приложение похоже на утилиту командной строки systrace , но приложение позволяет вам записывать трассировки непосредственно с самого тестового устройства, без необходимости подключать устройство и подключаться к нему через adb . Затем вы можете использовать приложение для обмена результатами этих трассировок с вашей командой разработчиков.

Устройства под управлением Android 10 и выше записывают трассировки в формате Perfetto, тогда как более ранние устройства записывают их в формате Systrace. Мы рекомендуем использовать просмотрщик трассировок Perfetto, чтобы открыть оба формата и затем проанализировать трассировки.

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

Запись трассировки системы

Приложение System Tracing позволяет вам записывать системную трассировку с помощью плитки быстрых настроек или меню в самом приложении. В следующих разделах описывается, как завершить процесс записи с помощью этих интерфейсов.

Запись с использованием плитки быстрых настроек

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

Установить плитку

Если вы впервые используете трассировку системы на тестовом устройстве или если вы не видите плитку «Трассировка системы» на панели быстрых настроек вашего устройства, как показано на рисунке 2, выполните следующие шаги по настройке:

  1. Включить параметры разработчика .
  2. Откройте экран настроек параметров разработчика .
  3. В разделе Отладка выберите Трассировка системы . Откроется приложение Трассировка системы, отображающее меню приложения.
  4. В меню приложения включите функцию «Показать плитку быстрых настроек» , как показано на рисунке 1. Система добавит плитку «Трассировка системы» на панель быстрых настроек , как показано на рисунке 2:

    Рисунок 1. Переключатель плитки «Показать быстрые настройки» в приложении «Трассировка системы».
    Рисунок 2. Плитка «Трассировка системы» на панели быстрых настроек .

    Примечание: По умолчанию система добавляет плитку System Tracing в качестве первой плитки на панели быстрых настроек . Если вы хотите, чтобы плитка отображалась в другом месте, используйте режим редактирования панели, чтобы переместить плитку.

Завершите запись трассировки системы

Чтобы записать трассировку системы с помощью панели быстрых настроек , выполните следующие действия:

  1. Нажмите на плитку System Tracing , которая имеет метку Record trace . Плитка становится активной, и появляется постоянное уведомление, уведомляющее вас о том, что система записывает трассировку, как показано на рисунке 3:

    Уведомление с сообщением «Трассировка записывается. Нажмите, чтобы остановить трассировку».
    Рисунок 3. Постоянное уведомление, появляющееся после запуска трассировки системы на устройстве.
  2. Выполните действия в вашем приложении, которые должна проверить система.

  3. Остановите отслеживание, нажав либо на плитку «Отслеживание системы» на панели быстрых настроек , либо на уведомление «Отслеживание системы».

    Система отображает новое уведомление, содержащее сообщение «Сохранение трассировки». После завершения сохранения система отклоняет уведомление и отображает третье уведомление, подтверждающее, что ваша трассировка сохранена и что вы готовы поделиться системной трассировкой , как показано на рисунке 4:

    Уведомление с сообщением «Трассировка сохранена. Нажмите, чтобы поделиться своей трассировкой».
    Рисунок 4. Постоянное уведомление, которое появляется после того, как система завершает сохранение записанного следа.

Запись с помощью меню приложения

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

Чтобы записать трассировку системы с помощью меню приложения «Трассировка системы», выполните следующие действия:

  1. Включить параметры разработчика .
  2. Откройте экран настроек Developer Options . В разделе Debugging выберите System Tracing . Откроется приложение System Tracing.

    Кроме того, если вы настроили плитку «Трассировка системы» , вы можете нажать и удерживать плитку, чтобы войти в приложение «Трассировка системы».

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

  4. При желании выберите Категории системных и сенсорных вызовов для трассировки и выберите Размер буфера на ЦП в КБ. Выберите категории, соответствующие варианту использования, который вы тестируете, например категорию Аудио для тестирования операций Bluetooth или категорию Память для распределения кучи.

  5. При желании выберите Длинные трассы , чтобы включить трассы, которые непрерывно сохраняются в хранилище устройства. Для этой опции установите ограничения для Максимального размера длинной трассы и Максимальной длительности длинной трассы .

  6. Включите переключатель «Запись трассировки» , выделенный на рисунке 5. Плитка станет активной, и появится постоянное уведомление о том, что система записывает трассировку, как показано на рисунке 3 .

    Рисунок 5. Переключатель записи трассировки в настройках системной трассировки.
  7. Выполните действия в вашем приложении, которые должна проверить система.

  8. Остановите трассировку, отключив переключатель «Запись трассировки» .

    Система отображает новое уведомление, которое содержит сообщение «Следствие сохранения». При завершении сохранения система отклоняет уведомление и отображает третье уведомление, подтверждая, что ваш трассировка сохраняется и что вы готовы поделиться трассировкой системы , как показано на рисунке 4 .

Поделиться системным следом

Приложение System Tracing помогает вам поделиться результатами System Trace как часть нескольких различных рабочих процессов. На устройстве под управлением Android 10 (API-уровень 29) или выше, файлы трассировки сохраняются с расширением .ctrace . На устройстве, работающем более ранней версией Android, файлы .perfetto-trace сохраняются с расширением файла.

Поделиться как сообщение

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

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

Поделиться из приложения Files

На устройствах, работающих на Android 10 (API -уровне 29) или выше, в приложении Files показаны следы. Вы можете поделиться трассировкой из этого приложения.

Скачать отчет с использованием ADB

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

cd /path-to-traces-on-my-dev-machine && \
  adb pull /data/local/traces/ .

Преобразовать между форматами трассировки

Вы можете конвертировать файлы трассировки Perfetto в формат Systrace. См. Преобразование между форматами трассировки для получения дополнительной информации.

Создать отчет HTML

При обмене трассировкой сам отчет находится в файле .perfetto-trace на устройствах, работающих на Android 10 или выше, или файла .ctrace для всех других версий.

Создайте отчет HTML из файла трассировки, используя веб-интерфейс или из командной строки .

Интернет-интерфейс

Используйте пользовательский интерфейс Perfetto , чтобы открыть файл трассировки и генерировать отчет.

Для файла перфетто нажмите «Открыть файл трассировки» . Для файла Systrace нажмите «Открыть» с Legacy UI . Наследие пользовательского интерфейса имеет такой же вид, что и отчет Systrace .

Командная строка

Запустите следующие команды в окне терминала, чтобы создать отчет HTML из файла трассировки:

cd /path-to-traces-on-my-dev-machine && \
  systrace --from-file trace-file-name{.ctrace | .perfetto-trace}

Если у вас еще нет программы командной строки systrace , вы можете загрузить ее из проекта Catapult на GitHub или непосредственно из проекта с открытым исходным кодом Android .

{% дословно %} {% endverbatim %} {% дословно %} {% endverbatim %}