Журнал отладки Android

Очень часто разработчики для отладки своих приложений используют вызовы к Console.WriteLine. Однако на мобильной платформе, такой как Android, консоль отсутствует. На устройствах Android доступен журнал, который можно использовать при создании приложений. Иногда его называют logcat из-за команды, которую нужно ввести для его получения. Для просмотра данных журнала используйте инструмент Журнал отладки.

Общие сведения о журнале отладки Android

Инструмент Журнал отладки позволяет просматривать выходные данные журнала при отладке приложения с помощью Visual Studio. Журнал отладки поддерживает следующие устройства:

физические телефоны, планшеты и переносные устройства Android;
виртуальные устройства с Android, работающие в Android Emulator.

Примечание.

Инструмент Журнал отладки не работает с Xamarin Live Player.

Журнал отладки не отображает сообщения журнала, созданные во время автономной работы приложения на устройстве (т. е. пока устройство не подключено к Visual Studio).

Получение доступа к журналу отладки из Visual Studio

Visual Studio
Visual Studio для Mac

Чтобы открыть инструмент Журнал устройств, щелкните значок Журнал устройств (logcat) на панели инструментов:

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

Просмотр > других журналов устройств Windows >
Средства > журнала устройств Android >

На следующем снимке экрана показаны разные элементы окна Инструмент для отладки:

Селектор устройств — выбирает физическое устройство или выполняющийся эмулятор для мониторинга.
Записи журнала — таблица сообщений журнала из logcat.
Очистка записей журнала — очищает все текущие записи журнала из таблицы.
Воспроизведение и приостановка — переключение между обновлением или приостановкой отображения новых записей журнала.
Остановка — останавливает отображение новых записей журнала.
Поле поиска— введите строки поиска в этом поле, чтобы отфильтровать подмножество записей журнала.

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

После выбора устройства средство журнала устройств автоматически добавляет записи журнала из работающего приложения. Эти записи журнала отображаются в таблице записей журнала. При переключении между устройствами ведение журнала устройств останавливается и запускается. Обратите внимание, что проект Android следует загрузить до того, как любые устройства будут отображаться в селекторе устройства. Если устройство не отображается в селекторе устройства, убедитесь, что оно доступно в раскрывающемся меню Visual Studio на устройстве рядом с кнопкой Пуск.

Чтобы открыть журнал устройств, нажмите кнопку "Просмотреть > журнал устройств">:

На следующем снимке экрана показаны разные элементы окна Инструмент для отладки:

Селектор устройств — выбирает физическое устройство или выполняющийся эмулятор для мониторинга.
Записи журнала — таблица сообщений журнала из logcat.
Очистка записей журнала — очищает все текущие записи журнала из таблицы.
Поле поиска— введите строки поиска в этом поле, чтобы отфильтровать подмножество записей журнала.
Показывать сообщения — переключает отображение информационных сообщений.
Отображение предупреждений — переключение отображения предупреждений (предупреждения отображаются желтым цветом).
Отображение ошибок— переключение отображения сообщений об ошибках (предупреждения отображаются красным цветом).
Повторное подключение — повторно подключитесь к устройству и обновляет отображение записи журнала.
Добавление маркера — вставляет сообщение маркера (например --- Marker N ---) после последней записи журнала, где N — счетчик, начинающийся с 1 и увеличивается на 1 при добавлении новых маркеров.

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

Кроме того, просмотреть журнал отладки можно с помощью командной строки. Откройте окно командной строки и перейдите в папку платформы sdk для Android (как правило, папка sdk platform-tools находится в папке C:\Program Files (x86)\Android\android-sdk\platform-tools).

Если подключено только одно устройство (физическое устройство или эмулятор), для просмотра журнала можно просто ввести следующую команду:

$ adb logcat

Кроме того, просмотреть журнал отладки можно с помощью командной строки. Откройте окно терминала и перейдите в папку platform-tools пакета SDK для Android (как правило, эта папка хранится в расположении /Users/username/Library/Developer/Xamarin/android-sdk-macosx/platform-tools).

$ ./adb logcat

Если подключено несколько устройств, необходимо явно указать нужное устройство. Например, при выполнении команды adb -d logcat отображается только журнал подключенного физического устройства, а при выполнении команды adb -e logcat — только журнал запущенного эмулятора.

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

Запись в журнал отладки

Записывать сообщения в журнал отладки можно с помощью методов класса Android.Util.Log. Например:

string tag = "myapp";

Log.Info (tag, "this is an info message");
Log.Warn (tag, "this is a warning message");
Log.Error (tag, "this is an error message");

Вы увидите приблизительно следующее:

I/myapp   (11103): this is an info message
W/myapp   (11103): this is a warning message
E/myapp   (11103): this is an error message

Также можно использовать запись в журнал отладки. Эти сообщения отображаются в logcat с немного другим форматом выходных данных (этот метод особенно полезен Console.WriteLine при отладке приложений Xamarin.Forms на Android):

System.Console.WriteLine ("DEBUG - Button Clicked!");

Это выведет в logcat примерно следующее:

Info (19543) / mono-stdout: DEBUG - Button Clicked!

Интересующие сообщения

При чтении журнала (особенно если фрагменты журнала предоставляются другим пользователям) изучаемое содержимое файла журнала в полном объеме часто является слишком громоздким. Чтобы упростить навигацию по сообщениям журнала, для начала найдите запись журнала, которая выглядит следующим образом:

I/ActivityManager(12944): Starting: Intent { act=android.intent.action.MAIN cat=[android.intent.category.LAUNCHER] flg=0x10200000 cmp=GcTest.GcTest/gctest.Activity1 } from pid 24175

В частности, найдите строку, которая соответствует регулярному выражению, также содержащему имя пакета приложения:

^I.*ActivityManager.*Starting: Intent

Это строка, которая соответствует началу действия, и большинство (но не все) следующих сообщений должны иметь отношение к приложению.

Обратите внимание, что каждое сообщение содержит идентификатор процесса (pid) для процесса, создающего сообщение. В указанном выше сообщении ActivityManager сообщение было создано процессом 12944. Чтобы определить, какой процесс является процессом отлаживаемого приложения, найдите сообщение mono.MonoRuntimeProvider:

I/ActivityThread(  602): Pub TouchTest.TouchTest.__mono_init__: mono.MonoRuntimeProvider

Это сообщение отправляется запущенным процессом. Все последующие сообщения, содержащие этот pid, отправляются этим же процессом.

Last updated on 2018-06-22