Логи игры и системный лог

В логе игры отображаются все результаты работы движка, нативных расширений и вашей игровой логики. Команды print() и pprint() можно использовать из ваших скриптов и Lua-модулей для отображения информации в логе игры. Вы можете использовать функции из пространства имен dmLog для записи в лог игры из нативных расширений. Лог игры можно прочитать из редактора, из окна терминала, с помощью специальных инструментов платформы или из файла лога.

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

Чтение лога игры из редактора

Когда вы запускаете игру локально из редактора или подключаетесь к мобильному приложению для разработки, весь вывод будет отображаться на панели консоли редактора:

Чтение лога игры с терминала

Когда вы запускаете игру Defold из терминала, лог будет отображаться в самом окне терминала. В Windows и Linux вы вводите имя исполняемого файла в терминале, чтобы запустить игру. В macOS вам нужно запустить движок из файла .app:

$ > ./mygame.app/Contents/MacOS/mygame

Чтение логов игры и системных логов с помощью инструментов, специфичных для платформы

HTML5

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

• Chrome - Menu > More Tools > Developer Tools
• Firefox - Tools > Web Developer > Web Console
• Edge
• Safari - Develop > Show JavaScript Console

Android

Вы можете использовать Android Debug Bridge (ADB) для просмотра логов игры и системного лога.

Инструмент командной строки adb — это удобная и универсальная программа для взаимодействия с устройствами Android. Вы можете скачать и установить adb как часть Android SDK Platform-Tools для Mac, Linux или Windows.

Скачать Android SDK Platform-Tools можно здесь: https://developer.android.com/studio/releases/platform-tools. Инструмент adb находится в каталоге /platform-tools/. Также можно установить платформенные пакеты через соответствующие менеджеры пакетов.

В Ubuntu Linux:

$ sudo apt-get install android-tools-adb

В Fedora 18/19:

$ sudo yum install android-tools

В macOS (Homebrew)

$ brew cask install android-platform-tools

Проверить, что adb работает, можно так: подключите Android-устройство к компьютеру по USB и выполните следующую команду:

$ adb devices
List of devices attached
31002535c90ef000    device

Если устройство не появляется в списке, убедитесь, что на Android-устройстве включена USB debugging. Откройте Settings устройства и найдите Developer options (или Development).

После установки и настройки подключите ваше устройство к USB, откройте терминал и выполните команды:

  cd <path_to_android_sdk>/platform-tools/
  adb logcat

После чего устройство сбрасывает весь вывод в текущий терминал вместе со всеми выводами на печать из игры.

Если вы хотите видеть только выходные данные приложения Defold, используйте эту команду:

$ cd <path_to_android_sdk>/platform-tools/
$ adb logcat -s defold
--------- beginning of /dev/log/system
--------- beginning of /dev/log/main
I/defold  ( 6210): INFO:DLIB: SSDP started (ssdp://192.168.0.97:58089, http://0.0.0.0:38637)
I/defold  ( 6210): INFO:ENGINE: Defold Engine 1.2.50 (8d1b912)
I/defold  ( 6210): INFO:ENGINE: Loading data from:
I/defold  ( 6210): INFO:ENGINE: Initialized sound device 'default'
I/defold  ( 6210):
D/defold  ( 6210): DEBUG:SCRIPT: Hello there, log!
...

iOS

У вас есть несколько способов прочитать игровые и системные логи на iOS:

1. Вы можете использовать Console tool для чтения игрового и системного логов.
2. Вы можете использовать отладчик LLDB для подключения к игре, запущенной на устройстве. Чтобы отлаживать игру, она должна быть подписана с помощью «Apple Developer Provisioning Profile», в который добавлено устройство, на котором вы хотите отлаживать. Соберите игру в редакторе и укажите provisioning profile в диалоговом окне сборки (сборка для iOS доступна только в macOS).

Чтобы запустить игру и подключить отладчик, вам понадобится инструмент под названием ios-deploy. Установите и отлаживайте игру, запустив в терминале следующую команду:

$ ios-deploy --debug --bundle <path_to_game.app> # ВНИМАНИЕ: не .ipa файл

Эта команда установит приложение на ваше устройство, запустит его и автоматически подключит к нему отладчик LLDB. Если вы не знакомы с LLDB, прочтите руководство Начало работы с LLDB.

Чтение лога игры из файла лога

Используйте параметр проекта “Write Log File” в game.project, чтобы управлять записью лога в файл:

• “Never”: не записывать лог в файл.
• “Debug”: записывать файл лога только для Debug-сборок.
• “Always”: записывать файл лога как для Debug, так и для Release-сборок.

Если запись включена, весь вывод игры будет записываться на диск в файл “log.txt”. Вот как можно извлечь файл, если вы запускаете игру на устройстве:

iOS

Подключите ваше устройство к компьютеру с установленными macOS и Xcode.

Откройте Xcode и перейдите в Window ▸ Devices and Simulators.

Выберите свое устройство в списке, затем выберите соответствующее приложение в списке Installed Apps.

Щелкните значок шестеренки под списком и выберите Download Container....

Как только контейнер будет извлечен, он появится в приложении Finder. Щелкните по контейнеру правой кнопкой мыши и выберите Show Package Content. Найдите файл “log.txt”, который должен находиться в “AppData/Documents/”.

Android

Возможность извлечения файла “log.txt” зависит от версии ОС и производителя. Вот краткое и простое пошаговое руководство.