Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

Perfetto

Дивись також

Будь ласка, дивіться tracing profiler instructions для отримання додаткової інформації.

Perfetto є системою трасування за замовчуванням для Android. Фактично, служба трасування системи вбудована в платформу, починаючи з Android 9.

Використання офіційних шаблонів Perfetto

Починаючи з Godot 4.7, шаблони експорту для Perfetto надаються для кожного стабільного випуску Godot і їх можна завантажити зі сторінки випусків на GitHub.

Використання шаблону збірки Gradle

  • Перейдіть на сторінку випуску та завантажте архів випуску Godot_v<godot_version>_android_source.perfetto.zip, де godot_version відповідає версії використовуваного рушія.

  • У діалоговому вікні Проект > Експорт необхідно ввімкнути параметри Додаткові параметри та Використовувати збірку Gradle.

  • Вкажіть у полі Шаблон вихідного коду Android шлях до завантаженого шаблону експорту.

../../../_images/cpp_profiler_perfetto_gradle_build_config.webp

Дотримуйтесь інструкцій у розділі Налаштування, щоб дізнатися, як налаштувати та створити трасування.

Використання шаблонів збірки, що не належать до Gradle

  • Перейдіть на сторінку випуску та завантажте такі артефакти випуску, де godot_version відповідає версії використовуваного рушія:

    • Godot_v<godot_version>_android_debug.perfetto.apk (для налагоджувальних збірок)

    • Godot_v<godot_version>_android_release.perfetto.apk (для релізних збірок)

  • У діалоговому вікні Проект > Експорт:

    • Розширені параметри мають бути увімкнені

    • Опція Використовувати Gradle для збірки має бути вимкнена

  • Вкажіть у полі «Custom Template» шлях до завантажених шаблонів експорту.

../../../_images/cpp_profiler_perfetto_non_gradle_build_config.webp

Дотримуйтесь інструкцій у розділі Налаштування, щоб дізнатися, як налаштувати та створити трасування.

Спеціальні збірки Godot із підтримкою Perfetto

У кореневому каталозі godot запустіть наступний скрипт на Python, щоб встановити останню версію SDK Perfetto в каталозі thirdparty/perfetto:

python misc/scripts/install_perfetto.py

Далі створіть шаблони для налагодження або релізної версії Android для вашої архітектури за допомогою scons (згідно з Компіляція для Android), додавши аргумент profiler=perfetto.

Примітка

Зазвичай рекомендується створювати профілі шаблонів релізів, оскільки це версія, яку використовуватимуть ваші гравці, і вона працюватиме інакше, ніж інші типи збірок. Однак у випадку Android іноді може бути корисним використовувати шаблони налагодження, оскільки Godot може виконувати віддалене налагодження лише ігор, експортованих із шаблонів налагодження.

Наприклад, щоб створити шаблони релізів для arm64:

scons platform=android target=template_release arch=arm64 generate_android_binaries=yes profiler=perfetto

Налаштування

Perfetto потребує файлу конфігурації, щоб вказати, які події відстежувати.

Створіть файл із назвою godot.config із таким вмістом:

# Trace for 10 seconds.
duration_ms: 10000

buffers {
    size_kb: 32768
    fill_policy: RING_BUFFER
}

# Write to file once every second to prevent overflowing the buffer.
write_into_file: true
file_write_period_ms: 1000

# Track events in the "godot" category.
data_sources {
    config {
        name: "track_event"
        track_event_config {
            enabled_categories: "godot"
        }
    }
}

Примітка

Godot фіксує два види змагань з легкої атлетики:

  • godot: Використовується для запису подій движка Godot. Ця опція призначена для аналізу продуктивності. Навантаження, пов’язане з відстеженням подій, не повинно істотно впливати на продуктивність. Це має бути стандартним режимом відстеження для більшості розробників.

  • godot_scripting: Використовується для запису подій скриптів Godot. Ця категорія працює повільно, оскільки аналізує всю логіку скриптів гри. Вона застосовується для розуміння коду, налагодження та виявлення причин затримок у відтворенні кадрів. Продуктивність значно знижується, але це допомагає виявити той єдиний проблемний виклик функції, який інакше залишився б непоміченим.

Записати трасування

Нарешті, запустіть свою гру на пристрої Android, використовуючи шаблони експорту, які ви створили раніше.

Коли ви будете готові до запису трасування (наприклад, коли ви дійдете до тієї частини гри, де виникають проблеми з продуктивністю), ви можете скористатися цим скриптом із репозиторію Perfetto на GitHub.

./record_android_trace -c /path/to/godot.config

Запис триватиме 10 секунд (відповідно до конфігурації) або доки ви не натиснете Ctrl + C.

Дослідження сліду

Щойно цей скрипт завершить роботу, він запустить інтерфейс користувача Perfetto у веббраузері.

Щоб переглянути події Godot, розгорніть рядок вашого додатка, натиснувши на його Унікальне ім’я / Ім’я пакета / Ідентифікатор додатка для Android (Perfetto також включатиме до трасування деякі події від системних служб).

../../../_images/cpp_profiler_perfetto.webp

Потім ви можете використовувати клавіші WASD для навігації по графіку:

  • Натисніть A або D, щоб переміщатися вперед або назад по часовій шкалі

  • Натисніть W або S, щоб збільшити або зменшити масштаб

Вам, ймовірно, доведеться трохи збільшити масштаб, перш ніж ви зможете побачити окремі події з «Godot».

Щоб дізнатися більше, див. документацію з інтерфейсу користувача Perfetto.