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.
Checking the stable version of the documentation...
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 шлях до завантаженого шаблону експорту.
Дотримуйтесь інструкцій у розділі Налаштування, щоб дізнатися, як налаштувати та створити трасування.
Використання шаблонів збірки, що не належать до Gradle
Перейдіть на сторінку випуску та завантажте такі артефакти випуску, де
godot_versionвідповідає версії використовуваного рушія:Godot_v<godot_version>_android_debug.perfetto.apk(для налагоджувальних збірок)Godot_v<godot_version>_android_release.perfetto.apk(для релізних збірок)
У діалоговому вікні Проект > Експорт:
Розширені параметри мають бути увімкнені
Опція Використовувати Gradle для збірки має бути вимкнена
Вкажіть у полі «Custom Template» шлях до завантажених шаблонів експорту.
Дотримуйтесь інструкцій у розділі Налаштування, щоб дізнатися, як налаштувати та створити трасування.
Спеціальні збірки 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 також включатиме до трасування деякі події від системних служб).
Потім ви можете використовувати клавіші WASD для навігації по графіку:
Натисніть A або D, щоб переміщатися вперед або назад по часовій шкалі
Натисніть W або S, щоб збільшити або зменшити масштаб
Вам, ймовірно, доведеться трохи збільшити масштаб, перш ніж ви зможете побачити окремі події з «Godot».
Щоб дізнатися більше, див. документацію з інтерфейсу користувача Perfetto.